ActionSheet 操作菜单

本组件用于从底部弹出一个操作菜单,供用户选择并返回结果。
本组件功能类似于uni的uni.showActionSheetAPI,配置更加灵活,所有平台都表现一致。

平台差异说明

AppH5微信小程序支付宝小程序百度小程序头条小程序QQ小程序

基本使用

  • 通过list设置需要显示的菜单,该值为一个数组,元素为对象,对象至少要提供text属性,另外可选的有fontSize(字体大小),color(颜色)
  • 通过v-model绑定一个值为布尔值的变量控制组件的弹出与收起,v-model的值是双向绑定的
  1. <template>
  2. <u-action-sheet :list="list" v-model="show"></u-action-sheet>
  3. </template>
  4. <script>
  5. export default {
  6. data() {
  7. return {
  8. list: [{
  9. text: '点赞',
  10. color: 'blue',
  11. fontSize: 28
  12. }, {
  13. text: '分享'
  14. }, {
  15. text: '评论'
  16. }],
  17. show: true
  18. }
  19. }
  20. }
  21. </script>

配置顶部的提示信息和底部取消按钮

  • tips参数为一个对象类型,属性可以设置textfontSize(字体大小),color(颜色),文本内容将会显示组件的上方,起提示作用。
  • cancel-btn参数配置是否显示底部的取消按钮,默认显示
  1. <template>
  2. <u-action-sheet :list="list" v-model="show" :tips="tips" :cancel-btn="true"></u-action-sheet>
  3. </template>
  4. <script>
  5. export default {
  6. data() {
  7. return {
  8. tips: {
  9. text: '在水一方',
  10. color: '#909399',
  11. fontSize: 24
  12. },
  13. list: [{
  14. text: '点赞',
  15. color: 'blue',
  16. fontSize: 28
  17. }],
  18. show: true
  19. }
  20. }
  21. }
  22. </script>

如何知道点了第几项

click回调事件带有一个index值,这个索引值为传递的list数组的索引值,根据回调事件,能获得点击了 第几项和该项的内容

  1. <template>
  2. <u-action-sheet :list="list" @click="click" v-model="show"></u-action-sheet>
  3. </template>
  4. <script>
  5. export default {
  6. data() {
  7. return {
  8. list: [{
  9. text: '点赞',
  10. color: 'blue',
  11. fontSize: 28
  12. }, {
  13. text: '分享'
  14. }, {
  15. text: '评论'
  16. }],
  17. show: true
  18. }
  19. },
  20. methods: {
  21. click(index) {
  22. console.log(`点击了第${index + 1}项,内容为:${this.list[index].text}`)
  23. }
  24. }
  25. }
  26. </script>

API

Props

注意:props中没有控制组件弹出与收起的参数,因为这是通过v-model绑定变量实现的,见上方说明。

参数说明类型默认值可选值
list按钮的文字数组,见上方文档示例Array<Object>[ ]-
tips顶部的提示文字,见上方文档示例Object--
cancel-btn是否显示底部的取消按钮Booleantruefalse
border-radius弹出部分顶部左右的圆角值,单位rpxNumber \ String0-
mask-close-able点击遮罩是否可以关闭Booleantruefalse
safe-area-inset-bottom是否开启底部安全区适配Booleanfalsetrue
z-indexz-indexNumber \ String1075-

Event

事件名说明回调参数版本
click点击ActionSheet列表项时触发index: 点击了第几个,从0开始-
close点击取消按钮时触发--