更新记录
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-picker(position=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 / error(danger 兼容) |
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 |
选中操作项 |
UTSJSONObject:index name disabled … |
| cancel |
点取消 |
— |
| open |
打开开始 |
— |
| opened |
打开完成 |
— |
| close |
关闭完成 |
— |
| click-mask |
点遮罩 |
— |
与 nax-picker 的关系
| 组件 |
职责 |
nax-picker |
通用弹出容器(任意内容 / 四向) |
nax-action-sheet |
标准底部操作列表(组合 picker) |