跳到主要内容

ActionSheet 动作面板 ​

uni-appH5微信小程序App

移动端底部动作面板,支持危险项、禁用项和遮罩关闭。

何时使用 ​

移动端一组上下文操作(分享/删除/更多),从底部弹出等待选择。

何时不使用 ​

只需确认/取消二选一时用 Dialog;操作超过 6 个考虑跳转独立页面。

本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。

9:41
ActionSheet 动作面板 · uni-app H5 实时运行 新窗口打开

Props ​

名称类型默认值说明
modelValuebooleanfalse显隐(v-model)
titlestring""标题(可选,居中展示)
actionsActionSheetAction[][]操作项:{ name, label, danger?, disabled? }
cancelTextstring"取消"取消按钮文案;传空字符串则不显示取消按钮
maskClosablebooleantrue点击遮罩是否关闭

Events ​

名称载荷说明
update:modelValueboolean显隐变化(v-model)
selectActionSheetAction点击操作项时触发并关闭面板,payload 为该 action 对象;disabled 项不触发
cancelvoid点击取消按钮时触发并关闭面板
closevoid任何途径关闭时触发(select/cancel/遮罩/Esc)

示例 ​

基础用法 ​

vue
<Button variant="primary" @click="visible = true">打开动作面板</Button>
<ActionSheet v-model="visible" title="选择操作" :actions="actions" />

无标题 ​

vue
<Button variant="ghost" @click="visible2 = true">简洁面板</Button>
<ActionSheet v-model="visible2" :actions="actions" cancel-text="关闭" />

遮罩不可关闭 ​

vue
<Button variant="secondary" @click="visible3 = true">强确认面板</Button>
<ActionSheet v-model="visible3" title="选择支付方式" :actions="actions" :mask-closable="false" />