跳到正文

ActionSheet 操作菜单 ​

从底部弹出的操作菜单组件,支持标题、自定义颜色与禁用项;高频操作可收拢为顶部图标网格区,并支持拖拽扩档(半屏 ↔ 近全屏)。

使用方式 ​

组件以 EmActionSheet 为名导出,全局注册后可直接使用:

vue
<script setup lang="ts">
import { ref } from 'vue'

const show = ref(false)
const actions = [{ name: '选项一' }, { name: '选项二' }]
</script>

<template>
  <em-button @click="show = true">打开菜单</em-button>
  <em-action-sheet v-model:show="show" :actions="actions" />
</template>

基础用法 ​

自定义 ​

高频网格分区与拖拽扩档 ​

API ​

ActionSheet API ​

Props ​

属性类型默认值说明
showboolean—是否显示操作面板,控制底部弹层开合;配合 v-model:show 使用
titlestring''顶部标题文案,为空时不渲染标题栏
actionsActionSheetItem[]—操作项列表,每项渲染为一行可点击操作(zone='grid' 的项收拢到顶部网格区);disabled 项点击不触发 select
cancelTextstringt('button.cancel', '取消')底部取消按钮文案,默认取 i18n 的「取消」
expandablebooleanfalse是否启用半屏/展开双档拖拽(默认 false):顶部渲染 drag handle,
半屏档内容上限 50dvh,拖拽 handle 上拉展开到 78dvh(受 EmPopup bottom 80dvh 上限约束),
松手按拖动方向吸附档位,轻点 handle 直接切换档位;展开后列表区纵向滚动。

Events ​

事件名参数说明
update:showvalue: boolean显隐状态变化时触发(选中操作项 / 取消 / 遮罩关闭均携带 false),用于 v-model:show 同步
selectitem: ActionSheetItem, index: number点击非禁用操作项时触发,负载为选中项对象与其在 actions 数组中的下标 index
cancel—点击底部取消按钮或弹层关闭(如点击遮罩)时触发