vant/packages/action-sheet/en-US.md

ActionSheet

Install

import { ActionSheet } from 'vant';

Vue.use(ActionSheet);

Usage

Basic Usage

Use actions prop to set options of action-sheet.

<van-action-sheet
  v-model="show"
  :actions="actions"
  @select="onSelect"
/>

export default {
  data() {
    return {
      show: false,
      actions: [
        {
          name: 'Option'
        },
        {
          name: 'Option',
          description: 'Description'
        },
        {
          loading: true
        },
        {
          name: 'Disabled Option',
          disabled: true
        }
      ]
    };
  },

  methods: {
    onSelect(item) {
      this.show = false;
      Toast(item.name);
    }
  }
}

ActionSheet with cancel button

<van-action-sheet
  v-model="show"
  :actions="actions"
  cancel-text="Cancel"
  @select="onSelect"
  @cancel="onCancel"
/>

ActionSheet with title

ActionSheet will get another style if there is a title prop.

<van-action-sheet v-model="show" title="Title">
  <p>Content</p>
</van-action-sheet>

API

Attribute	Description	Type	Default
actions	Options	Array	[]
title	Title	String	-
cancel-text	Text of cancel button	String	-
overlay	Whether to show overlay	Boolean	true
close-on-click-overlay	Whether to close when click overlay	Boolean	true
lazy-render	Whether to lazy render util appeared	Boolean	true
get-container	Return the mount node for action-sheet	`String	() => HTMLElement`
safe-area-inset-bottom	Whether to enable bottom safe area adaptation, to enable those features use viewport-fit=cover in the viewport meta tag	Boolean	false

Event

Event	Description	Arguments
select	Triggered when click option	item, index
cancel	Triggered when cancel click	-

Data struct of actions

key	Description
name	Title
subname	Subtitle
className	className for the option
loading	Whether to be loading status
disabled	Whether to be disabled