微信小程序自定义组件——底部菜单栏 ActionSheet

版权声明：本文原创，转载请注明出处 https://www.jianshu.com/p/d10b766300a7

系列文章：微信小程序自定义组件——模态框 Modal

写这个自定义ActionSheet组件，和自定义modal一样，有些开放能力必须绑定在button上，而我们有时候又会有在底部上拉菜单中实现转发功能的需求，或者别的微信开放能力，小程序原生的ActionSheet依然无法实现，故此组件应运而生。

安装

1.使用npm安装

直接使用小程序开发工具自带的构建npm，请按下面几个步骤引入：

• 确保项目目录下有package.json文件，已有的跳过这一步

$ npm init

• 安装

$ npm i wx-miniprogram-actionsheet

• 在小程序开发者工具中依次找到并点击工具->构建npm，构建完成后你的项目目录会多出一个miniprogram_npm目录，请确保项目设置已勾选使用npm模块

• 在使用组件的页面配置json中使用

{
  "usingComponents": {
    "action-sheet": "wx-miniprogram-actionsheet"
  }
}

2.不使用任何构建工具的普通小程序安装

直接拷贝wx-miniprogram-actionsheet仓库中的miniprogram_dist目录下的代码到项目中的放组件的目录中去，之后使用方法和小程序自定义组件一样了。同样需要在页面配置json中声明：

{
  "usingComponents": {
    "action-sheet": "../components/actionsheet/index"
  }
}

使用

wxml文件中

<action-sheet actionShow="{{showStatus}}" closeText="关闭" bind:actionHide="onActionHide">
  <!-- slot ActionSheet 菜单项 只能是button 或 navigator -->
  <navigator url="/pages/index/index">我是navigator: 回首页</navigator>
  <button bindtap="handleBtn">我是普通按钮</button>
  <button open-type="share">开放能力: 转发</button>
</action-sheet>

js文件中

// 只列出核心代码
Page({
  data: {
    actionStatus: false
  },
  onActionHide: function () {
    console.log('ActionSheet关闭了')
  }
})

菜单项写进<action-sheet></action-sheet>标签里即可，菜单项 只能是button 或 navigator。

action-sheet效果

参数

属性	数据类型	说明	选项	默认值
actionShow	Boolean	组件的初始显隐状态	必填	—
closeText	String	取消按钮的文字	选填	取消

触发事件

eventName	说明
actionHide	action-sheet组件被关闭时触发的事件，除了点关闭按钮会触发外，点其他按钮都会关闭组件，都会触发该事件，按需使用

示例Demo

微信小程序自定义组件使用示例整合