Skip to content

ActionSheet 动作面板 ​

动作面板从底部弹出,用于承载一组与当前场景相关的操作。组件支持列表项、禁用与自定义颜色、取消按钮,以及选中后自动关闭。

小程序APPWeb
✓✓✓

实例 ​

以下按属性分别说明 mu-action-sheet 的用法,可按需组合。

html
<template>
  <mu-action-sheet :show="visible" :list="actions"
    @select="onSelect" @cancel="onCancel" @close="visible = false"></mu-action-sheet>
</template>

选项列表 ​

通过 list 传入选项数组,每项包含 name,可选 color 与 disabled;禁用项不触发事件也不会关闭面板。

html
<mu-action-sheet :show="customVisible" :list="customActions"
  @select="onSelect" @close="customVisible = false"></mu-action-sheet>

取消按钮 ​

控制是否显示取消按钮,默认为显示。

html
<mu-action-sheet :show="noCancelVisible" :list="actions" :show-cancel="false"
  @select="onSelect" @close="noCancelVisible = false"></mu-action-sheet>

取消文字 ​

设置取消按钮的文字,默认为「取消」。

html
<mu-action-sheet :show="cancelTextVisible" :list="actions" cancel-text="关闭"
  @select="onSelect" @close="cancelTextVisible = false"></mu-action-sheet>

选中后关闭 ​

控制选中某一项后是否自动关闭面板,默认为自动关闭。

html
<mu-action-sheet :show="stayVisible" :list="actions" :close-on-select="false"
  @select="onSelect" @cancel="onCancel" @close="stayVisible = false"></mu-action-sheet>

属性 ​

全部属性均可选,未传入时使用默认值;默认值列为 - 表示空字符串。

属性名称说明类型默认值
show是否显示动作面板booleanfalse
list选项列表,每项包含 name,可选 color 与 disabledActionSheetItem[][]
showCancel是否显示取消按钮booleantrue
cancelText取消按钮文字string取消
closeOnSelect选中后是否自动关闭booleantrue
mask是否显示遮罩booleantrue
maskBackground遮罩背景色stringrgba(0, 0, 0, 0.6)
closeOnClickMask点击遮罩是否关闭booleantrue
zIndex层级number999
customClass自定义根节点类名string-
customStyle自定义根节点样式string-

事件 ​

组件支持以下事件。

事件名说明回调参数
select选中某一项时触发item: ActionSheetItem, index: number
cancel点击取消按钮时触发-
close关闭时触发(选中、取消或点击遮罩)-