ActionMenuContent 操作菜单内容
展示通用动作与可选确认。应用提供操作含义、确认有效性及 Modal;内容组件独立于 Chat。
演示操作
dialog、sheet、popover 均使用主题 GlassLayer。popover 卡片与箭头复用相同材质,原生由 SDK 材质组融合;箭头位置仍由 pointer 控制。组件不新增窗口、锚点测量或确认结算。
用法
<ActionMenuContent
title="操作"
presentation="sheet"
actions={actions}
onClose={closeModal}
/>
API
ActionMenuAction 由 Design 定义:id: string、label: string、onPress(): void 必填;icon?: ComponentType<IconProps>、accessibilityHint?、disabled?、loading?、tone?: 'neutral' | 'danger' 和 confirmation?: ActionMenuConfirmation 可选。确认内容为 message: string 与 confirmLabel: string,可选 title 覆盖确认阶段的标题。
| 参数 | 类型 | 默认值 | 说明 |
|---|---|---|---|
actions | readonly ActionMenuAction[] | 必填 | 调用方当前可用动作 |
onClose | () => void | 必填 | 遮罩、普通取消与确认后的关闭请求 |
presentation | 'dialog' | 'sheet' | 'popover' | 'dialog' | 居中、底部或纯浮动菜单卡片 |
title | string | — | 可选标题(popover 保持单行) |
message | string | — | 标题下方的操作说明;不与标题拼接 |
cancelLabel | string | null | '取消' | 普通取消与返回菜单文案;null 隐藏,由宿主提供外部取消 |
style / testID | StyleProp<ViewStyle> / string | — / 'action-menu' | 根容器样式与定位前缀 |
contentStyle | StyleProp<ViewStyle> | — | 内部动作卡片样式;嵌入已有面板时可显式调整上留白,根容器仍由style控制 |
pointer?: { edge: 'top' | 'bottom'; offset: number } 为浮动卡提供装饰箭头,offset 是相对卡片左边的指针中心;组件在圆角内限位,非有限值居中。宿主计算锚点与方向。onConfirmationChange?(actionId: string | null) 通知当前确认的动作 ID,动作失效时通知 null;它不改变业务目标或开关窗口。
普通动作只调用 onPress。有 confirmation 的动作先展示说明;确认时先 onClose 再调用该动作,取消确认仅返回菜单。禁用或加载时不能执行。正在确认的动作消失后回到菜单;业务目标是否仍然有效由应用在回调中复核。
底部模式需要 SafeAreaProvider,并将安全区加入底部内边距;浮动与居中模式不读取安全区。组件不挂载 Modal,不创建请求。原生展厅位于「操作与状态」;文字随主题和应用字号变化。
浮动菜单
presentation="popover" 直接显示竖向操作行,可选图标、文字、危险色、禁用及忙碌状态。默认宽度r(240)、圆角radius['3xl']、主题描边和卡片阴影,每行至少44触达;图标无独立底圈;确认标题和说明左对齐;确认阶段宽度为 r(260),水平 space[8]、垂直 space[7] 留白分别覆盖菜单内边距。标题使用 type.h2/半粗体及1.3倍行高,说明使用 type.sm/常规字重及1.5倍行高。确认按钮为整行 radius.lg 圆角矩形、type.sm/半粗体;危险按钮采用 errorContainer 浅底和 error 文字/加载指示器,按压透明度沿用 pressedOpacity。明暗主题同步切换。没有title时不增加标题,不增加单独的取消行。
此模式只提供菜单内容,不挂载Modal、遮罩或全屏容器,不计算锚点和安全区。输入框可以把它定位在加号上方;会话列表可以交给自己的窗口定位在长按行附近。style控制根卡片布局,contentStyle控制内部卡片;外部点击、返回和位置失效由宿主关闭。
普通动作继续只交onPress,宿主自行收起再执行。保留取消按钮时,确认取消返回原菜单;设置 cancelLabel={null} 时由宿主点外或返回关闭。确认提交先请求onClose再交当前动作。Web鼠标按下保留原输入焦点,点击和键盘激活仍只交一次动作;按钮禁用或忙碌时不能触发。
import { TrashOutlined } from '@unif/react-native-icons';
<ActionMenuContent
presentation="popover"
cancelLabel={null}
pointer={{ edge: 'top', offset: 120 }}
actions={[
{
id: 'delete',
label: '删除',
icon: TrashOutlined,
tone: 'danger',
confirmation: {
title: '删除项目',
message: '此操作无法撤销。',
confirmLabel: '删除',
},
onPress: deleteOriginalItem,
},
]}
onClose={closeModal}
/>;
宿主应在确认阶段传入指针,其他阶段按设计省略;更换业务目标时创建新的内容实例,避免把确认复用到同 ID 的另一个对象。窗外关闭不交付删除。
居中 dialog 使用独立标题、说明和竖向操作按钮。普通操作沿用中性主题表面,危险操作使用危险浅底和文字,取消放在操作组下方;完整动作及禁用/忙碌语义与 popover 一致。关闭确认可把“保留并关闭”放在前,“清空并关闭”标为 danger,业务仍由调用方结算。