ActionSheet 动作面板
uni-appH5微信小程序App
移动端底部动作面板,支持危险项、禁用项和遮罩关闭。
何时使用
移动端一组上下文操作(分享/删除/更多),从底部弹出等待选择。
何时不使用
只需确认/取消二选一时用 Dialog;操作超过 6 个考虑跳转独立页面。
本文档为 uni-app 端组件契约;Web 端同名组件 API 可能略有差异,请以对应包文档为准。下方手机预览实时运行 uni-app H5 演示。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | boolean | false | 显隐(v-model) |
title | string | "" | 标题(可选,居中展示) |
actions | ActionSheetAction[] | [] | 操作项:{ name, label, danger?, disabled? } |
cancelText | string | "取消" | 取消按钮文案;传空字符串则不显示取消按钮 |
maskClosable | boolean | true | 点击遮罩是否关闭 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | boolean | 显隐变化(v-model) |
select | ActionSheetAction | 点击操作项时触发并关闭面板,payload 为该 action 对象;disabled 项不触发 |
cancel | void | 点击取消按钮时触发并关闭面板 |
close | void | 任何途径关闭时触发(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" />