跳到主要内容

ActionSheet 动作面板 ​

WebH5

移动端底部动作面板。Teleport 到 body,遮罩淡入、面板从底部滑入,顶部圆角 16 + 抓手条,支持危险/禁用项与独立取消按钮,自动叠加底部安全区。

何时使用 ​

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

何时不使用 ​

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

Props ​

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

Events ​

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

示例 ​

基础 ​

示例加载中…

危险与禁用项 ​

示例加载中…

无取消按钮 ​

示例加载中…

Playground ​

加载中…

跨端版本 ​

该组件同时提供 uni-app / uni-app X 实现(H5 / 微信小程序 / App),API 可能略有差异,见 uni-app 端 ActionSheet 文档(含手机预览)。