目次
- WXS 相应变乱
- 方案A
- WXS 变乱回调函数
- WXS 脚本
- 遮罩层
- 方案B
- 为什么要使用 WXS
- 结语 & 参考资料
- 参考资料:
在移动端,侧滑菜单是一个很常用的组件(通常称作 Drawer,抽屉)。由于现在手机屏幕太大,点击角落的菜单按钮明显不如在屏幕中心滑动方便。
相比其他平台,小程序的组件库支持明显还不够美满,各个框架也还不太成熟。由于之前使用框架的过程中被各种机密bug搞的头秃,照旧用回了原生情况。
最近研究了一下如安在原生框架中实现滑动抽屉菜单结果,本来以为很贫困,结果发现其实只必要几十行代码,而且可以类比实现很多机动的结果。感觉现在网上相关资料较少,因此在此分享一下。除了文中贴出的代码块,也可以点击链接在小程序开发工具中预览结果、检察代码片断。这里实现了三种常见结果,先看一下动图,下面将逐一解说代码实现。
A 菜单在上层
A2 菜单在上层,下层遮罩
B 菜单在下层
WXS 相应变乱
手势控制菜单的原理很简单:小程序提供了一系列触摸手势触发的变乱,包罗触摸开始、移动、竣事(
- touchstart, touchmove, touchend
复制代码
)等等。在这些变乱上绑定自定义的变乱相应函数,即可实现根据手势打开关闭菜单的操纵。
出于性能考虑,变乱处理函数最好放在 WXS、而不是 JS 文件中。详细原理与小程序的运行情况有关,感爱好的话可以去文末检察。WXS 是小程序的专用脚本语言(WXS 与 JS 的关系相当于 WXSS 与 CSS 的关系),语法和 JS 类似,有部分区别,比如:
- 与 JS 隔离,不能调用其他 JavaScript 文件中定义的函数,也不能调用小程序提供的API
- 只能相应小程序内置组件的变乱,不支持自定义组件的变乱回调
- 变量与函数默以为模块私有,通过
复制代码 对外暴露
- 使用标签在 WXML 中引入使用(必须使用相对路径)
wxs 文件和 wxml 文件中的基本写法如下:- // index.wxs
-
- function touchStart(e, ins) {}
- function touchMove(e, ins) {}
- function touchEnd(e, ins) {}
-
- module.exports = {
- touchstart: touchStart,
- touchmove: touchMove,
- touchend: touchEnd
- }
- <wxs module="drawer" src="./index.wxs"></wxs>
-
- <view bindtouchstart="{{drawer.touchstart}}"
- bindtouchmove="{{drawer.touchmove}}"
- bindtouchend="{{drawer.touchend}}">
- </view>
复制代码
方案A
页面布局和样式
这是最常见的抽屉菜单样式之一,滑动主体内容不动,菜单在上层表现。起首写出基本的 HTML 布局和 CSS 样式(省略了一些雅观方面的样式表):- <wxs module="drawer" src="./index.wxs"></wxs>
-
- <view>
- <view class="main" bindtouchstart="{{drawer.touchstart}}"
- bindtouchmove="{{drawer.touchmove}}" bindtouchend="{{drawer.touchend}}">
- <view>
- 右滑显示侧边菜单 方案A
- </view>
- </view>
-
- <view class="drawer" data-drawerwidth="150">
- <view class="drawer-item">drawerA</view>
- <view wx:for="{{[1, 2, 3]}}" class="drawer-item">
- <text>menu item {{item}}</text>
- </view>
- </view>
- </view>
复制代码
WXML 中的几个重点:
- 准确引入 wxs 模块(必须用相对路径)
- 举行滑动手势时菜单是埋伏的,所以现实上是在主界面上举行滑动,所以三个滑动变乱回调必要绑定在主体内容的 view 上面
- 举行移动的是 .drawer 元素,必要设置好 class 属性方便获取
- 抽屉元素的 data-drawerwidth 属性通过 dataset 传值给 wxs 脚本,规定了菜单的宽度,必要和样式保持同等
WXSS 没啥好说的,写在注释里了:- .main {
- height: 100vh;
- width: 100%;
- position: absolute;
- }
-
- .drawer {
- height: 100vh;
- width: 150px;
- position: absolute;
- transition: transform 0.4s ease; /* 位移使用transform实现,加个过渡动画更顺滑 */
- left: -150px; /* width、偏移与WXML中的数值保持一致,初始状态隐藏菜单 */
- }
复制代码
WXS 变乱回调函数
wxs 函数有两个入参
复制代码 是小程序变乱对象,并在此基础上多了触发变乱的组件的实例复制代码
复制代码 是触发变乱的组件的父组件(页面)的实例
wxs 中组件实例是封装好的复制代码 对象,可以大概操纵组件的 dataset、设置 style、class 等,对于交互动画基本够用了。更多用法可参考文档。- var wxsFunction = function(event, ownerInstance) {
- var instance = ownerInstance.selectComponent('.classSelector') // 返回组件的实例
- instance.setStyle({
- "font-size": "14px" // 支持rpx
- })
- instance.getDataset()
- instance.setClass(className)
-
- return false // 不往上冒泡,相当于调用了同时调用了stopPropagation和preventDefault
- }
复制代码
WXS 脚本
条件判断为主,逻辑没啥特殊的,联合情景不难明白
- 不要用 let, const 声明变量,会报错
- 把设置 transform 属性 X 位移的代码简单封装一下,看起来更雅观
- judge point 类似于吸附结果,就是菜单划出来超过某一位置就主动把剩余部分打开
- var startmark = 0;
- var status = 0; // 菜单开闭状态
- var JUDGEPOINT = 0.7;
-
- function touchStart(e, ins) {
- var pageX = (e.touches[0] || e.changedTouches[0]).pageX;
- startmark = pageX;
- }
-
- function touchMove(e, ins) {
- var pageX = (e.touches[0] || e.changedTouches[0]).pageX;
- var offset = pageX - startmark;
- var drawerComp = ins.selectComponent('.drawer');
- var drawerWidth = drawerComp.getDataset().drawerwidth;
-
- if (offset > 0 && status == 0) {
- setCompTransX(drawerComp, Math.min(drawerWidth, offset))
- } else if (offset < 0 && status == 1) {
- setCompTransX(drawerComp, Math.max(0, offset))
- }
- }
-
- function touchEnd(e, ins) {
- var pageX = (e.touches[0] || e.changedTouches[0]).pageX;
- var offset = pageX - startmark;
- var drawerComp = ins.selectComponent('.drawer');
- var drawerWidth = drawerComp.getDataset().drawerwidth;
-
- if (offset > 0 && status == 0) {
- if (offset < drawerWidth * JUDGEPOINT) {
- setCompTransX(drawerComp, 0);
- } else {
- setCompTransX(drawerComp, drawerWidth);
- status = 1;
- }
- } else if (offset < 0) {
- setCompTransX(drawerComp, 0);
- status = 0;
- }
- }
-
- function setCompTransX(comp, x) {
- comp.setStyle({
- transform: 'translateX(' + x + 'px)',
- })
- }
-
- module.exports = {
- touchstart: touchStart,
- touchmove: touchMove,
- touchend: touchEnd
- }
复制代码
遮罩层
点击文首或文末链接在小程序开发工具中检察完整代码。
遮罩层只必要在菜单和主容器之间增长一个 view 即可:- <view class="main"></view>
- <view class="mask" data-maxopacity="0.6"></view>
- <view class="drawer" data-drawerwidth="150"></view>
复制代码
样式中很重要的是这个 pointer-events 属性,设置为 none 之后点击动作会穿透这个 view 到达下层。由于遮罩层不像抽屉是处在画面以外的,它虽然透明度为0,但现实上不停覆盖在 .main 上方,如果不加这个属性,全部对 .main 的点击操纵都会点到 .mask 上面,那不管是滑动照旧其他按钮都无效了。- .mask {
- height: 100vh;
- width: 100%;
- position: fixed;
- transition: opacity 0.4s ease;
- opacity: 0;
- pointer-events: none;
- background-color: #548CA8;
- }
复制代码
wxs 脚本也基本完全同等,只必要以相似的方法获取到 .mask 的实例以及 dataset 中的透明度参数,并在设置位移属性的同时设置遮罩层的透明度属性即可。- function setDrawer(x) {
- setCompTransX(drawerComp, x);
- maskComp.setStyle({
- opacity: x / drawerWidth * maskOpacity,
- })
- }
复制代码
方案B
点击文首或文末链接在小程序开发工具中检察完整代码。
方案B 与方案A 的区别主要在于滑动时是主界面向右移动露出下层的菜单,别的各部分实现并无差异。这里只贴出主要差异的部分。
由于移动的是 .main 元素,因此把宽度设置数据放到了该元素的标签中,这样可以少获取一个组件实例。- <view class="drawer"></view>
-
- <view class="main"
- data-drawerwidth="150"
- bindtouchstart="{{drawer.touchstart}}"
- bindtouchmove="{{drawer.touchmove}}"
- bindtouchend="{{drawer.touchend}}">
- </view>
复制代码
transition 动画属性也放在 .main 中,.drawer 的偏移不必要了。- .main {
- height: 100vh;
- width: 100%;
- position: absolute;
- transition: transform 0.4s ease;
- }
-
- .drawer {
- height: 100vh;
- width: 150px;
- position: absolute;
- }
复制代码
wxs 脚本中除了获取的组件差异外,连设置位移都不必要改。- function touchMove(e, ins) {
- var pageX = (e.touches[0] || e.changedTouches[0]).pageX;
- var offset = pageX - startmark;
- var mainComp = ins.selectComponent('.main');
- var drawerWidth = mainComp.getDataset().drawerwidth;
-
- if (offset > 0 && status == 0) {
- setCompTransX(mainComp, Math.min(drawerWidth, offset))
- } else if (offset < 0 && status == 1) {
- setCompTransX(mainComp, Math.max(0, offset))
- }
- }
复制代码
为什么要使用 WXS
小程序在很多地方与 web 开发很像,但底层存在一些区别。网页中,渲染和脚本执行在同一个线程中执行(因此执行脚本大概会导致页面整个卡死);小程序在差异的线程中分别运行逻辑层(JS脚本)和渲染层(WXML和WXSS),线程间经过客户端(Native)举行通讯。
因此,如果使用 JS 脚本相应变乱,每次触发 touchmove 都会产生两次历程间通讯(下图左所示),通讯开销较大;同时“setData 渲染也会壅闭别的脚本执行”(文档这么说的,我也不知道为什么)。由于一次手势会触发巨量的 touchmove 变乱,上述原因会造成动画的卡顿。
而 WXS 函数运行在视图层,不存在上述问题(下图右所示)。
结语 & 参考资料
以上就是原生小程序的几种抽屉菜单实现方法,盼望对你有所资助;对于文中存在的疏漏欢迎讨论指正。
点击链接可以在小程序开发工具中检察完整代码(使用小程序开发工具的代码片断分享,对开发工具版本有肯定要求)。他这个分享代码片断有点玄学,如果直接打开失败,可以在登录后实验在“项目-导入代码片断”中直接输入链接或链接末了一段ID。
参考资料:
小程序框架/视图层/变乱体系/WXS 相应变乱
官方 demo
小程序宿主情况
到此这篇关于小程序原生实现左滑抽屉菜单的文章就先容到这了,更多相关小程序 左滑抽屉菜单内容请搜刮草根技术分享以前的文章或继承欣赏下面的相关文章盼望大家以后多多支持草根技术分享! |