Merge pull request #1563 from easyops-cn/steve/drawer-elevo

fix(dropdown-actions): new prop: placement

Author: weareoutman

bricks/basic/src/batch-agent/index.ts

@@ -10,7 +10,16 @@ const { defineElement, event, method } = createDecorators();
 /**
  * 批处理事件代理。
  *
- * 当多次触发同一类型事件时，只会在当前宏任务结束后触发一次该类型事件。
+ * 注意和 eo-event-agent 的区别：
+ *
+ * 触发条件：
+ * - eo-event-agent 每次触发事件都会立即派发该事件。
+ * - eo-batch-agent 当多次触发同一类型事件时，只会在当前宏任务结束后触发一次该类型事件。
+ *
+ * 方法参数
+ * - eo-event-agent trigger() 方法的参数会作为 EVENT.detail 传递给 trigger 事件。
+ * - eo-batch-agent trigger() 方法的参数必须是字符串，表示事件类型，trigger 事件详情 为 { type: string } 形式。
+ *   因此，如果希望在事件回调时消费其他信息，需通过 context/state 进行传递。
  */
 export
 @defineElement("eo-batch-agent", {

bricks/basic/src/dropdown-actions/index.tsx

@@ -4,6 +4,7 @@ import { ReactNextElement, wrapBrick } from "@next-core/react-element";
 import "@next-core/theme";
 import styleText from "./styles.shadow.css";
 import type {
+  Placement,
   Popover,
   PopoverEvents,
   PopoverEventsMapping,
@@ -45,6 +46,7 @@ export interface DropdownActionsProps
   extends Pick<ActionsProps, "actions" | "checkedKeys" | "themeVariant"> {
   disabled?: boolean;
   strategy?: "absolute" | "fixed";
+  placement?: Placement;
 }
 
 export interface DropdownActionsEvents {
@@ -101,6 +103,14 @@ class EoDropdownActions
   @property()
   accessor strategy: "absolute" | "fixed" | undefined;
 
+  /**
+   * 弹出层放置位置
+   *
+   * @default "bottom-start"
+   */
+  @property()
+  accessor placement: Placement | undefined;
+
   /** 主题变体 */
   @property()
   accessor themeVariant: "default" | "elevo" | undefined;
@@ -136,6 +146,7 @@ class EoDropdownActions
         actions={this.actions}
         disabled={this.disabled}
         strategy={this.strategy}
+        placement={this.placement}
         themeVariant={this.themeVariant}
         onActionClick={this.#handleClick}
         onVisibleChange={this.#handleVisibleChange}
@@ -155,6 +166,7 @@ export function EoDropdownActionsComponent({
   checkedKeys,
   disabled,
   strategy,
+  placement,
   themeVariant,
   onActionClick,
   onVisibleChange,
@@ -171,7 +183,7 @@ export function EoDropdownActionsComponent({
 
   return (
     <WrappedPopover
-      placement="bottom-start"
+      placement={placement ?? "bottom-start"}
       trigger="click"
       disabled={disabled}
       active={visible}