ActionSheet 上拉菜单

引入

app.jsonindex.json中引入组件,详细介绍见快速上手

  1. "usingComponents": {
  2. "van-action-sheet": "path/to/@vant/weapp/dist/action-sheet/index"
  3. }

代码演示

基础用法

需要传入一个actions的数组,数组的每一项是一个对象,对象属性见文档下方表格。

  1. <van-action-sheet
  2. show="{{ show }}"
  3. actions="{{ actions }}"
  4. bind:close="onClose"
  5. bind:select="onSelect"
  6. />
  1. Page({
  2. data: {
  3. show: false,
  4. actions: [
  5. {
  6. name: '选项'
  7. },
  8. {
  9. name: '选项'
  10. },
  11. {
  12. name: '选项',
  13. subname: '副文本',
  14. openType: 'share'
  15. }
  16. ]
  17. },
  18. onClose() {
  19. this.setData({ show: false });
  20. },
  21. onSelect(event) {
  22. console.log(event.detail);
  23. }
  24. });

选项状态

选项可以设置为加载状态或禁用状态。

  1. <van-action-sheet
  2. show="{{ show }}"
  3. actions="{{ actions }}"
  4. cancel-text="取消"
  5. />
Page({
  data: {
    show: false,
    actions: [
      { name: '选项', color: '07c160' },
      { loading: true },
      { name: '禁用选项', disabled: true }
    ]
  }
})

展示取消按钮

设置cancel-text属`性后,会在底部展示取消按钮,点击后关闭当前菜单

<van-action-sheet
  show="{{ show }}"
  actions="{{ actions }}"
  cancel-text="取消"
/>

展示描述信息

设置description属性后,会在选项上方显示描述信息

<van-action-sheet
  show="{{ show }}"
  :actions="actions"
  description="这是一段描述信息"
/>

展示标题栏

通过设置title属性展示标题栏,同时可以使用插槽自定义菜单内容

<van-action-sheet show="{{ show }}" title="标题">
  <view>内容</view>
</van-action-sheet>

API

Props

参数说明类型默认值版本
actions菜单选项Array[]-
title标题string--
description选项上方的描述信息string-1.0.0
z-indexz-index 层级number100-
cancel-text取消按钮文字string--
overlay是否显示遮罩层boolean--
round是否显示圆角booleantrue1.0.0
close-on-click-action是否在点击选项后关闭booleantrue-
close-on-click-overlay点击遮罩是否关闭菜单boolean--
safe-area-inset-bottom是否为 iPhoneX 留出底部安全距离booleantrue-

Events

事件名说明参数
bind:select选中选项时触发,禁用或加载状态下不会触发event.detail: 选项对应的对象
bind:close关闭时触发-
bind:cancel取消按钮点击时触发-
bind:click-overlay点击遮罩层时触发-

actions

API中的actions为一个对象数组,数组中的每一个对象配置每一列,每一列有以下key

键名说明类型
name标题string
subname二级标题string
color选项文字颜色string
loading是否为加载状态boolean
disabled是否为禁用状态boolean
className为对应列添加额外的 class 类名string
openType微信开放能力,具体支持可参考 微信官方文档string

ActionSheet 上拉菜单 - 图1