WeChat 미니 프로그램의 구성요소를 어떻게 맞춤설정하나요? 다음 기사에서는 WeChat 미니 프로그램의 구성 요소를 사용자 정의하는 방법을 소개하겠습니다. 도움이 되길 바랍니다!
WeChat 미니 프로그램 개발 과정에서 여러 페이지에서 사용할 수 있는 일부 페이지 모듈을 구성 요소로 캡슐화하여 개발 효율성을 높일 수 있습니다. weui, vant 등과 같은 전체 구성 요소 라이브러리를 도입할 수 있지만 때때로 WeChat 애플릿의 패키지 크기 제한을 고려하면 이를 사용자 정의 구성 요소로 캡슐화하는 것이 일반적으로 더 제어하기 쉽습니다.
일부 비즈니스 모듈의 경우 재사용을 위해 구성 요소로 캡슐화할 수 있습니다. 이 기사에서는 주로 다음 두 가지 측면에 대해 설명합니다.
WeChat 애플릿 컴포넌트 시스템의 최하위 계층은 Exparser를 통해 구현됩니다. 내장된 컴포넌트 프레임워크 미니 프로그램의 기본 라이브러리에는 내장 컴포넌트, 커스텀 컴포넌트 등 미니 프로그램 내의 모든 컴포넌트가 Exparser에 의해 구성되고 관리됩니다.
사용자 정의 구성 요소에는 페이지 작성과 마찬가지로 다음 파일이 포함됩니다.
예를 들어 tab
구성 요소를 작성하려면:
사용자 정의 구성 요소를 작성할 때 json
파일에서 comment
필드를 true
로 설정해야 합니다: json
文件中讲 component
字段设为 true
:
{ "component": true }
在 js
文件中,基础库提供有 Page 和 Component 两个构造器,Page 对应的页面为页面根组件,Component 则对应:
Component({ options: { // 组件配置 addGlobalClass: true, // 指定所有 _ 开头的数据字段为纯数据字段 // 纯数据字段是一些不用于界面渲染的 data 字段,可以用于提升页面更新性能 pureDataPattern: /^_/, multipleSlots: true // 在组件定义时的选项中启用多slot支持 }, properties: { vtabs: {type: Array, value: []}, }, data: { currentView: 0, }, observers: { // 监测 activeTab: function(activeTab) { this.scrollTabBar(activeTab); } }, relations: { // 关联的子/父组件 '../vtabs-content/index': { type: 'child', // 关联的目标节点应为子节点 linked: function(target) { this.calcVtabsCotentHeight(target); }, unlinked: function(target) { delete this.data._contentHeight[target.data.tabIndex]; } } }, lifetimes: { // 组件声明周期 created: function() { // 组件实例刚刚被创建好时 }, attached: function() { // 在组件实例进入页面节点树时执行 }, detached: function() { // 在组件实例被从页面节点树移除时执行 }, }, methods: { // 组件方法 calcVtabsCotentHeight(target) {} } });
如果有了解过 Vue2 的小伙伴,会发现这个声明很熟悉。
在小程序启动时,构造器会将开发者设置的properties、data、methods等定义段,
写入Exparser的组件注册表中。这个组件在被其它组件引用时,就可以根据这些注册信息来创建自定义组件的实例。
模版文件 wxml:
<view class='vtabs'> <slot /> </view>
样式文件:
.vtabs {}
外部页面组件使用,只需要在页面的 json
文件中引入
{ "navigationBarTitleText": "商品分类", "usingComponents": { "vtabs": "../../../components/vtabs", } }
在初始化页面时,Exparser 会创建出页面根组件的一个实例,用到的其他组件也会响应创建组件实例(这是一个递归的过程):
组件创建的过程大致有以下几个要点:
根据组件注册信息,从组件原型上创建出组件节点的 JS
对象,即组件的 this
;
将组件注册信息中的 data
复制一份,作为组件数据,即 this.data
;
将这份数据结合组件 WXML
,据此创建出 Shadow Tree
(组件的节点树),由于 Shadow Tree
中可能引用有其他组件,因而这会递归触发其他组件创建过程;
将 ShadowTree
拼接到 Composed Tree
(最终拼接成的页面节点树)上,并生成一些缓存数据用于优化组件更新性能;
触发组件的 created
生命周期函数;
如果不是页面根组件,需要根据组件节点上的属性定义,来设置组件的属性值;
当组件实例被展示在页面上时,触发组件的 attached
生命周期函数,如果 Shadow Tree
Component({ properties: { vtabs: {type: Array, value: []}, // 数据项格式为 `{title}` } })In
js 파일에서 기본 라이브러리는 Page와 Component라는 두 개의 생성자를 제공합니다. Page에 해당하는 페이지는 페이지 루트 구성 요소이고 구성 요소는 다음과 같습니다.
<vtabs vtabs="{{ vtabs }}"</vtabs>Vue2에 대한 지식이 있으면 다음 명령문을 찾을 수 있습니다. 매우 친숙합니다.
<view bindtap="handleTabClick">스타일 파일:
handleClick(e) { this.triggerEvent( 'tabclick', { index }, { bubbles: false, // 事件是否冒泡 // 事件是否可以穿越组件边界,为 false 时,事件只在引用组件的节点树上触发, // 不进入其他任何组件的内部 composed: false, capturePhase: false // 事件是否拥有捕获阶段 } ); }, handleChange(e) { this.triggerEvent('tabchange', { index }); },외부 페이지 구성요소를 사용하려면 페이지 초기화 시 페이지의
json
파일에 <vtabs vtabs="{{ vtabs }}" bindtabclick="handleTabClick" bindtabchange="handleTabChange" >만 추가하면 됩니다. 페이지 루트를 생성합니다. 구성 요소의 인스턴스와 사용된 다른 구성 요소도 구성 요소 인스턴스 생성에 응답합니다(이는 재귀 프로세스입니다). 구성 요소 생성 프로세스에는 대략 다음과 같은 핵심 사항이 있습니다.
컴포넌트 등록 정보에 따라 컴포넌트 프로토타입에서 컴포넌트 노드의 JS
객체, 즉 컴포넌트의 this
객체를 생성합니다. code>;
구성요소 등록 정보 만들기 data
의 복사본을 구성요소 데이터로 복사합니다. 즉, this.data
이 데이터를 다음과 결합합니다. WXML
구성요소는 섀도우 트리
(구성요소의 노드 트리)를 생성합니다. 섀도우 트리
에서 다른 구성요소를 참조할 수 있기 때문입니다. >, 이는 다른 구성 요소의 생성 프로세스를 재귀적으로 트리거합니다.
ShadowTree
를 Composed Tree
(마지막으로 연결된 페이지 노드 트리)에 연결하고 일부를 생성합니다. 구성 요소 업데이트 성능을 최적화하기 위해 데이터를 캐시합니다.
구성 요소 생성
수명 주기 기능을 트리거합니다.
페이지 루트 구성 요소가 아닌 경우 구성 요소의 속성 값을 설정해야 합니다. 구성 요소 노드의 속성 정의에 따라 구성 요소 인스턴스가 페이지에 표시될 때 구성 요소의 attached
수명 주기 기능이 트리거될 때 Shadow에 다른 구성 요소가 있는 경우 트리
, 해당 수명 주기 기능도 하나씩 트리거됩니다.
selectComponent
컴포넌트 통신
비즈니스 책임으로 인해 큰 페이지를 여러 구성 요소로 분할해야 하는 경우가 많으며, 여러 구성 요소 간에 데이터 통신이 필요합니다. 세대 간 구성 요소 통신을 위해 전역 상태 관리를 고려할 수 있습니다. 여기서는 일반적인 상위-하위 구성 요소 통신만 논의합니다. 🎜🎜🎜🎜방법 1 WXML 데이터 바인딩 🎜🎜🎜🎜은 상위 구성 요소가 데이터를 지정된 속성으로 설정하는 데 사용됩니다. 하위 구성 요소. 🎜🎜하위 항목은 속성 속성을 선언합니다.🎜<view> <vtabs-content="goods-content{{ index }}"></vtabs-content> </view>🎜상위 구성 요소 호출: 🎜
Page({ reCalcContentHeight(index) { const goodsContent = this.selectComponent(`#goods-content${index}`); }, })🎜🎜🎜방법 2 이벤트🎜🎜🎜🎜는 하위 구성 요소가 상위 구성 요소에 데이터를 전달하는 데 사용되며 모든 데이터가 전달될 수 있습니다. 🎜🎜하위 구성 요소에서 이벤트를 전달하려면 먼저 wxml 구조에서 하위 구성 요소의 클릭 이벤트를 바인딩하세요. 🎜
export function jumpTo(url, options) { const baseUrl = url.split('?')[0]; // 如果 url 带了参数,需要把参数也挂载到 options 上 if (url.indexof('?') !== -1) { const { queries } = resolveUrl(url); Object.assign(options, queries, options); // options 的优先级最高 } cosnt queryString = objectEntries(options) .filter(item => item[1] || item[0] === 0) // 除了数字 0 外,其他非值都过滤 .map( ([key, value]) => { if (typeof value === 'object') { // 对象转字符串 value = JSON.stringify(value); } if (typeof value === 'string') { // 字符串 encode value = encodeURIComponent(value); } return `${key}=${value}`; } ).join('&'); if (queryString) { // 需要组装参数 url = `${baseUrl}?${queryString}`; } const pageCount = wx.getCurrentPages().length; if (jumpType === 'navigateTo' && pageCount < 5) { wx.navigateTo({ url, fail: () => { wx.switch({ url: baseUrl }); } }); } else { wx.navigateTo({ url, fail: () => { wx.switch({ url: baseUrl }); } }); } }🎜 그런 다음 js 파일에서 이벤트를 전달하세요. 이벤트 이름을 사용자 정의할 수 있습니다. 2번째 파라미터는 데이터 객체를 전달할 수 있으며, 3번째 파라미터는 이벤트 옵션입니다. 🎜
export const resolveSearch = search => { const queries = {}; cosnt paramList = search.split('&'); paramList.forEach(param => { const [key, value = ''] = param.split('='); queries[key] = value; }); return queries; }; export const resolveUrl = (url) => { if (url.indexOf('?') === -1) { // 不带参数的 url return { queries: {}, page: url } } const [page, search] = url.split('?'); const queries = resolveSearch(search); return { page, queries }; };🎜마지막으로 다음을 사용하여 상위 구성 요소에서 수신합니다. 🎜
jumpTo({ url: 'pages/consignment/index', { sender: { name: 'naluduo233' } } });🎜🎜🎜메서드 3 selectComponent를 사용하여 구성 요소 인스턴스 객체 가져오기 🎜🎜🎜🎜 🎜 메소드를 통해 하위 구성 요소의 인스턴스를 가져올 수 있으므로 하위 구성 요소의 메서드를 호출할 수 있습니다. . 🎜🎜Parent 컴포넌트의 wxml🎜
const sender = JSON.parse(getParam('sender') || '{}');🎜Parent 컴포넌트의 js🎜
// 返回当前页面 export function getCurrentPage() { const pageStack = wx.getCurrentPages(); const lastIndex = pageStack.length - 1; const currentPage = pageStack[lastIndex]; return currentPage; } // 获取页面 url 参数 export function getParams() { const currentPage = getCurrentPage() || {}; const allParams = {}; const { route, options } = currentPage; if (options) { const entries = objectEntries(options); entries.forEach( ([key, value]) => { allParams[key] = decodeURIComponent(value); } ); } return allParams; } // 按字段返回值 export function getParam(name) { const params = getParams() || {}; return params[name]; }🎜selector는 CSS selector와 유사하지만 다음 구문만 지원합니다. 🎜
#the-id
(笔者只测试了这个,其他读者可自行测试).a-class.another-class
.the-parent > .the-child
.the-ancestor .the-descendant
.the-ancestor >>> .the-descendant
#a-node
, .some-other-nodes
方法四 url 参数通信
在电商/物流等微信小程序中,会存在这样的用户故事,有一个「下单页面A」和「货物信息页面B」
微信小程序由一个 App()
实例和多个 Page()
组成。小程序框架以栈的方式维护页面(最多10个) 提供了以下 API 进行页面跳转,页面路由如下
wx.navigateTo(只能跳转位于栈内的页面)
wx.redirectTo(可跳转位于栈外的新页面,并替代当前页面)
wx.navigateBack(返回上一层页面,不能携带参数)
wx.switchTab(切换 Tab 页面,不支持 url 参数)
wx.reLaunch(小程序重启)
可以简单封装一个 jumpTo 跳转函数,并传递参数:
export function jumpTo(url, options) { const baseUrl = url.split('?')[0]; // 如果 url 带了参数,需要把参数也挂载到 options 上 if (url.indexof('?') !== -1) { const { queries } = resolveUrl(url); Object.assign(options, queries, options); // options 的优先级最高 } cosnt queryString = objectEntries(options) .filter(item => item[1] || item[0] === 0) // 除了数字 0 外,其他非值都过滤 .map( ([key, value]) => { if (typeof value === 'object') { // 对象转字符串 value = JSON.stringify(value); } if (typeof value === 'string') { // 字符串 encode value = encodeURIComponent(value); } return `${key}=${value}`; } ).join('&'); if (queryString) { // 需要组装参数 url = `${baseUrl}?${queryString}`; } const pageCount = wx.getCurrentPages().length; if (jumpType === 'navigateTo' && pageCount < 5) { wx.navigateTo({ url, fail: () => { wx.switch({ url: baseUrl }); } }); } else { wx.navigateTo({ url, fail: () => { wx.switch({ url: baseUrl }); } }); } }
jumpTo 辅助函数:
export const resolveSearch = search => { const queries = {}; cosnt paramList = search.split('&'); paramList.forEach(param => { const [key, value = ''] = param.split('='); queries[key] = value; }); return queries; }; export const resolveUrl = (url) => { if (url.indexOf('?') === -1) { // 不带参数的 url return { queries: {}, page: url } } const [page, search] = url.split('?'); const queries = resolveSearch(search); return { page, queries }; };
在「下单页面A」传递数据:
jumpTo({ url: 'pages/consignment/index', { sender: { name: 'naluduo233' } } });
在「货物信息页面B」获得 URL 参数:
const sender = JSON.parse(getParam('sender') || '{}');
url 参数获取辅助函数
// 返回当前页面 export function getCurrentPage() { const pageStack = wx.getCurrentPages(); const lastIndex = pageStack.length - 1; const currentPage = pageStack[lastIndex]; return currentPage; } // 获取页面 url 参数 export function getParams() { const currentPage = getCurrentPage() || {}; const allParams = {}; const { route, options } = currentPage; if (options) { const entries = objectEntries(options); entries.forEach( ([key, value]) => { allParams[key] = decodeURIComponent(value); } ); } return allParams; } // 按字段返回值 export function getParam(name) { const params = getParams() || {}; return params[name]; }
参数过长怎么办?路由 api 不支持携带参数呢?
虽然微信小程序官方文档没有说明可以页面携带的参数有多长,但还是可能会有参数过长被截断的风险。
我们可以使用全局数据记录参数值,同时解决 url 参数过长和路由 api 不支持携带参数的问题。
// global-data.js // 由于 switchTab 不支持携带参数,所以需要考虑使用全局数据存储 // 这里不管是不是 switchTab,先把数据挂载上去 const queryMap = { page: '', queries: {} };
更新跳转函数
export function jumpTo(url, options) { // ... Object.assign(queryMap, { page: baseUrl, queries: options }); // ... if (jumpType === 'switchTab') { wx.switchTab({ url: baseUrl }); } else if (jumpType === 'navigateTo' && pageCount < 5) { wx.navigateTo({ url, fail: () => { wx.switch({ url: baseUrl }); } }); } else { wx.navigateTo({ url, fail: () => { wx.switch({ url: baseUrl }); } }); } }
url 参数获取辅助函数
// 获取页面 url 参数 export function getParams() { const currentPage = getCurrentPage() || {}; const allParams = {}; const { route, options } = currentPage; if (options) { const entries = objectEntries(options); entries.forEach( ([key, value]) => { allParams[key] = decodeURIComponent(value); } ); + if (isTabBar(route)) { + // 是 tab-bar 页面,使用挂载到全局的参数 + const { page, queries } = queryMap; + if (page === `${route}`) { + Object.assign(allParams, queries); + } + } } return allParams; }
辅助函数
// 判断当前路径是否是 tabBar const { tabBar} = appConfig; export isTabBar = (route) => tabBar.list.some(({ pagePath })) => pagePath === route);
按照这样的逻辑的话,是不是都不用区分是否是 isTabBar
页面了,全部页面都从 queryMap 中获取?这个问题目前后续探究再下结论,因为我目前还没试过从页面实例的 options
中拿到的值是缺少的。所以可以先保留读取 getCurrentPages
的值。
方法五 EventChannel 事件派发通信
前面我谈到从「当前页面A」传递数据到被打开的「页面B」可以通过 url 参数。那么想获取被打开页面传送到当前页面的数据要如何做呢?是否也可以通过 url 参数呢?
答案是可以的,前提是不需要保存「页面A」的状态。如果要保留「页面 A」的状态,就需要使用 navigateBack
返回上一页,而这个 api 是不支持携带 url 参数的。
这样时候可以使用 页面间事件通信通道 EventChannel。
pageA 页面
// wx.navigateTo({ url: 'pageB?id=1', events: { // 为指定事件添加一个监听器,获取被打开页面传送到当前页面的数据 acceptDataFromOpenedPage: function(data) { console.log(data) }, }, success: function(res) { // 通过eventChannel向被打开页面传送数据 res.eventChannel.emit('acceptDataFromOpenerPage', { data: 'test' }) } });
pageB 页面
Page({ onLoad: function(option){ const eventChannel = this.getOpenerEventChannel() eventChannel.emit('acceptDataFromOpenedPage', {data: 'test'}); // 监听acceptDataFromOpenerPage事件,获取上一页面通过eventChannel传送到当前页面的数据 eventChannel.on('acceptDataFromOpenerPage', function(data) { console.log(data) }) } })
会出现数据无法监听的情况吗?
小程序的栈不超过 10 层,如果当前「页面A」不是第 10 层,那么可以使用 navigateTo
跳转保留当前页面,跳转到「页面B」,这个时候「页面B」填写完毕后传递数据给「页面A」时,「页面A」是可以监听到数据的。
如果当前「页面A」已经是第10个页面,只能使用 redirectTo
跳转「PageB」页面。结果是当前「页面A」出栈,新「页面B」入栈。这个时候将「页面B」传递数据给「页面A」,调用 navigateBack
是无法回到目标「页面A」的,因此数据是无法正常被监听到。
不过我分析做过的小程序中,栈中很少有10层的情况,5 层的也很少。因为调用 wx.navigateBack
、wx.redirectTo
会关闭当前页面,调用 wx.switchTab
会关闭其他所有非 tabBar 页面。
所以很少会出现这样无法回到上一页面以监听到数据的情况,如果真出现这种情况,首先要考虑的不是数据的监听问题了,而是要保证如何能够返回上一页面。
比如在「PageA」页面中先调用 getCurrentPages
获取页面的数量,再把其他的页面删除,之后在跳转「PageB」页面,这样就避免「PageA」调用 wx.redirectTo
导致关闭「PageA」。但是官方是不推荐开发者手动更改页面栈的,需要慎重。
如果有读者遇到这种情况,并知道如何解决这种的话,麻烦告知下,感谢。
使用自定义的事件中心 EventBus
除了使用官方提供的 EventChannel 外,我们也可以自定义一个全局的 EventBus 事件中心。
因为这样更加灵活,不需要在调用 wx.navigateTo
等APi里传入参数,多平台的迁移性更强。
export default class EventBus { private defineEvent = {}; // 注册事件 public register(event: string, cb): void { if(!this.defineEvent[event]) { (this.defineEvent[event] = [cb]); } else { this.defineEvent[event].push(cb); } } // 派遣事件 public dispatch(event: string, arg?: any): void { if(this.defineEvent[event]) {{ for(let i=0, len = this.defineEvent[event].length; i<len; ++i) { this.defineEvent[event][i] && this.defineEvent[event][i](arg); } }} } // on 监听 public on(event: string, cb): void { return this.register(event, cb); } // off 方法 public off(event: string, cb?): void { if(this.defineEvent[event]) { if(typeof(cb) == "undefined") { delete this.defineEvent[event]; // 表示全部删除 } else { // 遍历查找 for(let i=0, len=this.defineEvent[event].length; i<len; ++i) { if(cb == this.defineEvent[event][i]) { this.defineEvent[event][i] = null; // 标记为空 - 防止dispath 长度变化 // 延时删除对应事件 setTimeout(() => this.defineEvent[event].splice(i, 1), 0); break; } } } } } // once 方法,监听一次 public once(event: string, cb): void { let onceCb = arg => { cb && cb(arg); this.off(event, onceCb); } this.register(event, onceCb); } // 清空所有事件 public clean(): void { this.defineEvent = {}; } } export connst eventBus = new EventBus();
在 PageA 页面监听:
eventBus.on('update', (data) => console.log(data));
在 PageB 页面派发
eventBus.dispatch('someEvent', { name: 'naluduo233'});
本文主要讨论了微信小程序如何自定义组件,涉及两个方面:
如果你使用的是 taro 的话,直接按照 react 的语法自定义组件就好。而其中的组件通信的话,因为 taro 最终也是会编译为微信小程序,所以 url 和 eventbus 的页面组件通信方式是适用的。后续会分析 vant-ui weapp 的一些组件源码,看看有赞是如何实践的。
感谢阅读,如有错误的地方请指出
【相关学习推荐:小程序开发教程】
위 내용은 WeChat 미니 프로그램의 구성 요소를 사용자 정의하는 방법에 대한 간략한 분석의 상세 내용입니다. 자세한 내용은 PHP 중국어 웹사이트의 기타 관련 기사를 참조하세요!