更新记录

0.1.0(2026-07-31) 下载此版本

  • 首版:底部动作面板(薄封装 nax-picker
  • 支持 actions 列表、标题/描述、取消按钮、危险项/禁用
  • 事件:select / cancel / open / close

平台兼容性

uni-app x(4.25)

Chrome Safari Android iOS 鸿蒙 微信小程序
-

其他

多语言 暗黑模式 宽屏模式
× ×

nax-action-sheet

底部操作菜单(动作面板)。内部薄封装 nax-pickerposition=bottom),只提供「选项列表 + 取消」语义。

自定义任意底部内容请直接用 nax-picker

依赖

  • nax-picker
  • nax-ui-theme(可选,主题 token)

easycom 自动注册:页面内直接使用 <nax-action-sheet>

基础用法

<nax-button label="打开" @click="show = true"></nax-button>
<nax-action-sheet
  v-model:show="show"
  title="请选择操作"
  :actions="actions"
  @select=""
  @cancel="onCancel"
></nax-action-sheet>
const show = ref(false)
const actions = [
  { name: '分享' },
  { name: '收藏' },
  { name: '删除', type: 'error' }
]

function (payload: UTSJSONObject) {
  const index = payload.getNumber('index')
  const name = payload.getString('name')
  // ...
}

function onCancel() {
  // 点取消
}

actions 项字段

字段 说明
name / text / label 主文案(优先 name
subname / subText / description 副文案
disabled 禁用
type default / errordanger 兼容)
color 可选自定义文字色(优先于 type)

兼容:也可传 list(与 actions 相同形态;actions 优先)。

Props

属性 类型 默认 说明
show boolean false v-model:show 显隐
actions array [] 操作项
list array [] 兼容别名,仅当 actions 为空时使用
title string '' 顶部标题
description string '' 顶部描述
tips string '' 同 description(兼容)
showCancel boolean true 是否显示取消
cancelText string 取消 取消文案
closeOnSelect boolean true 点选项后关闭
asyncClose boolean false 为 true 时点选项不自动关闭(由业务关)
round boolean true 圆角
mask boolean true 遮罩
maskClosable boolean true 点遮罩关闭
zIndex number 10080 层级
duration number 280 动画 ms
safeAreaInsetBottom boolean true 底部安全区
customClass string '' 根扩展 class

事件

事件 说明 参数
update:show 显隐变更 boolean
select 选中操作项 UTSJSONObjectindex name disabled
cancel 点取消
open 打开开始
opened 打开完成
close 关闭完成
click-mask 点遮罩

与 nax-picker 的关系

组件 职责
nax-picker 通用弹出容器(任意内容 / 四向)
nax-action-sheet 标准底部操作列表(组合 picker)

隐私、权限声明

1. 本插件需要申请的系统权限列表:

2. 本插件采集的数据、发送的服务器地址、以及数据用途说明:

3. 本插件是否包含广告,如包含需详细说明广告表达方式、展示频率:

许可协议

MIT协议

暂无用户评论。