ActionSheet 动作面板
WebH5
移动端底部动作面板。Teleport 到 body,遮罩淡入、面板从底部滑入,顶部圆角 16 + 抓手条,支持危险/禁用项与独立取消按钮,自动叠加底部安全区。
何时使用
移动端一组上下文操作(分享/删除/更多),从底部弹出等待选择。
何时不使用
只需确认/取消二选一时用 Dialog;操作超过 6 个考虑跳转独立页面。
Props
| 名称 | 类型 | 默认值 | 说明 |
|---|---|---|---|
modelValue | boolean | false | 显隐(v-model) |
title | string | "\"\"" | 标题(可选,居中展示) |
actions | ActionSheetAction[] | "[]" | 操作项:{ name, label, danger?, disabled? } |
cancelText | string | "取消(取 locale 文案 actionsheet.cancel)" | 取消按钮文案;传空字符串则不显示取消按钮 |
maskClosable | boolean | true | 点击遮罩是否关闭 |
Events
| 名称 | 载荷 | 说明 |
|---|---|---|
update:modelValue | boolean | 显隐变化(v-model) |
select | ActionSheetAction | 点击操作项时触发并关闭面板,payload 为该 action 对象;disabled 项不触发 |
cancel | void | 点击取消按钮时触发并关闭面板 |
close | void | 任何途径关闭时触发(select/cancel/遮罩/Esc) |
示例
基础
示例加载中…
危险与禁用项
示例加载中…
无取消按钮
示例加载中…
Playground
加载中…
跨端版本
该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 ActionSheet 文档(含手机预览)。