kbone 高级 - 使用小程序内置组件
1、用法
需要明确的是,如果可以使用 Web 端组件技术实现的话请尽量使用 Web 端技术(如 vue、react 组件),使用自定义组件请按需使用。这是因为自定义组件外层会被包裹上 kbone 的自定义组件,而当自定义组件的实例数量达到一定量级的话,理论上是会对性能造成一定程度的影响。
要在 kbone 中使用自定义组件,需要将所有自定义组件和其依赖放到一个固定的目录,这个目录可以自己拟定,假设这个目录为 src/custom-components:
1.1 修改 webpack 插件配置
在 mp-webpack-plugin 这个插件的配置中的 generate 字段内补充 wxCustomComponent,其中 root 是组件根目录,即上面提到的目录:src/custom-component,usingComponents 则用来配置要用到的自定义组件。
[code]module.exports = { generate: { wxCustomComponent: { root: path.join(__dirname, '../src/custom-components'), usingComponents: { 'comp-a': 'comp-a/index', 'comp-b': { path: 'comp-b/index', props: ['propa', 'propb'], events: ['someevent'], }, }, }, }, // ... other options }
usingComponents 里的声明和小程序页面的 usingComponents 字段类似。键为组件名,值可以为组件相对 root 字段的路径,也可以是一个配置对象。这个配置对象的 path 为组件相对路径,props 表示要这个组件会被用到的 properties,events 表示这个组件会被监听到的事件。
1.2 将自定义组件放入组件根目录
下面以 comp-b 组件为例:
[code]<!-- comp-b.wxml --> <view>comp-b</view> <view>propa: {{propa}} -- propb: {{propb}}</view> <button bindtap="onTap">click me</button> <slot></slot> // comp-b.js Component({ properties: { propa: {type: String, value: ''}, propb: {type: String, value: ''}, }, methods: { onTap() { this.triggerEvent('someevent') }, }, })
1.3 使用自定义组件
假设使用 vue 技术,然后下面同样以 comp-b 组件为例:
[code]<template> <div> <comp-b :propa="propa" :propb="propb" @someevent="onEvent"> <div>comp-b slot</div> </comp-b> </div> </template> <script> export default { data() { return {propa: 'propa-value', propb: 'propb-value'} }, methods: { onEvent(evt) { console.log('someevent', evt) }, }, } </script>
PS:如果使用 react 等其他框架其实和 vue 同理,因为它们的底层都是调用 document.createElement 来创建节点。当在 webpack 插件配置声明了这个自定义组件的情况下,在调用 document.createElement 创建该节点时会被转换成创建 wx-custom-component 标签,类似于内置组件的 wx-component 标签。
2、案例
在
kbone-advanced目录下创建
04-custom-components目录。本案例在这个目录下实现。
2.1 创建 package.json
[code]cd 04-custom-components npm init -y
编辑 package.json:
[code]{ "scripts": { "mp": "cross-env NODE_ENV=production webpack --config build/webpack.mp.config.js --progress --hide-modules" }, "dependencies": { "vue": "^2.5.11" }, "browserslist": [ "> 1%", "last 2 versions", "not ie <= 8" ], "devDependencies": { "babel-core": "^6.26.0", "babel-loader": "^7.1.2", "babel-preset-env": "^1.6.0", "babel-preset-stage-3": "^6.24.1", "cross-env": "^5.0.5", "css-loader": "^0.28.7", "extract-text-webpack-plugin": "^3.0.2", "file-loader": "^1.1.4", "html-webpack-plugin": "^4.0.0-beta.5", "mini-css-extract-plugin": "^0.5.0", "mp-webpack-plugin": "latest", "optimize-css-assets-webpack-plugin": "^5.0.1", "stylehacks": "^4.0.3", "vue-loader": "^15.7.0", "vue-template-compiler": "^2.6.10", "webpack": "^4.29.6", "webpack-cli": "^3.2.3" } }
安装依赖包:
[code]npm install
2.2 配置 webpack
在
04-custom-components目录下创建
build文件夹,在文件夹下创建
webpack.mp.config.js文件,内容如下:
[code]const path = require('path') const webpack = require('webpack') const MiniCssExtractPlugin = require('mini-css-extract-plugin') const { VueLoaderPlugin } = require('vue-loader') const OptimizeCSSAssetsPlugin = require('optimize-css-assets-webpack-plugin'); const TerserPlugin = require('terser-webpack-plugin') const MpPlugin = require('mp-webpack-plugin') // 用于构建小程序代码的 webpack 插件 const isOptimize = false // 是否压缩业务代码,开发者工具可能无法完美支持业务代码使用到的 es 特性,建议自己做代码压缩 module.exports = { mode: 'production', entry: { index: path.resolve(__dirname, '../src/index/main.mp.js'), }, output: { path: path.resolve(__dirname, '../dist/mp/common'), // 放到小程序代码目录中的 common 目录下 filename: '[name].js', // 必需字段,不能修改 library: 'createApp', // 必需字段,不能修改 libraryExport: 'default', // 必需字段,不能修改 libraryTarget: 'window', // 必需字段,不能修改 }, target: 'web', // 必需字段,不能修改 optimization: { runtimeChunk: false, // 必需字段,不能修改 splitChunks: { // 代码分隔配置,不建议修改 chunks: 'all', minSize: 1000, maxSize: 0, minChunks: 1, maxAsyncRequests: 100, maxInitialRequests: 100, automaticNameDelimiter: '~', name: true, cacheGroups: { vendors: { test: /[\\/]node_modules[\\/]/, priority: -10 }, default: { minChunks: 2, priority: -20, reuseExistingChunk: true } } }, minimizer: isOptimize ? [ // 压缩CSS new OptimizeCSSAssetsPlugin({ assetNameRegExp: /\.(css|wxss)$/g, cssProcessor: require('cssnano'), cssProcessorPluginOptions: { preset: ['default', { discardComments: { removeAll: true, }, minifySelectors: false, // 因为 wxss 编译器不支持 .some>:first-child 这样格式的代码,所以暂时禁掉这个 }], }, canPrint: false }), // 压缩 js new TerserPlugin({ test: /\.js(\?.*)?$/i, parallel: true, }) ] : [], }, module: { rules: [ { test: /\.css$/, use: [ MiniCssExtractPlugin.loader, 'css-loader' ], }, { test: /\.vue$/, loader: 'vue-loader', }, { test: /\.js$/, use: [ 'babel-loader' ], exclude: /node_modules/ }, { test: /\.(png|jpg|gif|svg)$/, loader: 'file-loader', options: { name: '[name].[ext]?[hash]' } } ] }, resolve: { extensions: ['*', '.js', '.vue', '.json'] }, plugins: [ new webpack.DefinePlugin({ 'process.env.isMiniprogram': process.env.isMiniprogram, // 注入环境变量,用于业务代码判断 }), new MiniCssExtractPlugin({ filename: '[name].wxss', }), new VueLoaderPlugin(), new MpPlugin(require('./miniprogram.config.js')), ], }
在
04-custom-components/build文件夹下创建
miniprogram.config.js文件,内容如下:
[code]const path = require('path') module.exports = { origin: 'https://test.miniprogram.com', entry: '/', router: { index: ['/'], }, redirect: { notFound: 'index', accessDenied: 'index', }, generate: { wxCustomComponent: { root: path.join(__dirname, '../src/custom-components'), usingComponents: { 'comp-a': { path: 'comp-a', props: ['prefix', 'suffix'], events: ['someevent'], }, 'comp-b': { path: 'comp-b/index', props: ['prefix'], }, 'comp-c': 'comp-c', }, }, // 构建完成后是否自动安装小程序依赖。'npm':使用 npm 自动安装依赖 autoBuildNpm: 'npm' }, app: { navigationBarTitleText: 'miniprogram-project', }, projectConfig: { appid: '', projectname: 'custom-components', }, packageConfig: { author: 'Felixlu', }, }
2.3 编写案例有关组件
2.3.1 创建 main.mp.js
在项目根目录下创建
/src/index,在
index下创建
main.mp.js文件,内容如下:
[code]import Vue from 'vue' import App from './App.vue' export default function createApp() { const container = document.createElement('div') container.id = 'app' document.body.appendChild(container) return new Vue({ el: '#app', render: h => h(App) }) }
2.3.2 创建 App.vue 组件
在
/src/index下创建
App.vue组件,内容为:
[code]<template> <div class="cnt"> <h2>kbone</h2> <comp-a ref="compA" class="block" :prefix="prefixA" :suffix="suffixA" @someevent="onEvent"> <div>comp-a slot</div> </comp-a> <comp-b class="block" :prefix="prefixB"> <div>comp-b slot</div> </comp-b> <comp-c class="block"> <div>comp-c slot</div> </comp-c> <button class="btn" @click="onClick">update</button> </div> </template> <script> export default { name: 'App', data() { return { suffixA: 'suffix-a', prefixB: 'prefix-b', } }, methods: { onClick() { this.prefixA = 'prefix-new-a' this.prefixB = 'prefix-new-b' this.$refs.compA._wxCustomComponent.printf() }, onEvent(evt) { console.log('someevent', evt) }, }, } </script> <style> .cnt { margin: 15px; } .block { border: 1px solid #ddd; padding: 15px; box-sizing: content-box; display: block; margin-bottom: 15px; } .btn { margin-top: 15px; display: block; width: 100%; height: 30px; line-height: 30px; text-align: center; font-size: 20px; border: 1px solid #ddd; } </style>
2.3.3 创建 comp-a 组件
在根目录下创建
/src/custom-components文件夹,在这个文件夹下创建小程序原生组件
comp-a,四个文件内容如下:
/src/custom-components/comp-a.wxml
[code]<view>comp-a</view> <button class="btn" bindtap="onTap">comp-a button</button> <view><text class="prefix">{{prefix}}</text>-{{str}}-<text class="suffix">{{suffix}}</text></view> <slot></slot>
/src/custom-components/comp-a.js
[code]const _ = require('./common/utils') Component({ properties: { prefix: { type: String, value: 'defaultPrefix', }, suffix: { type: String, value: 'defaultSuffix', }, }, data: { str: _.getWords() + 'comp-a', }, methods: { onTap() { this.triggerEvent('someevent', { detail: { from: 'comp-a', }, }) }, printf() { console.log('I am comp-a') }, }, })
/src/custom-components/common/utils.js
[code]module.exports = { getWords() { return 'Hello, ' }, }
/src/custom-components/comp-a.json
[code]{ "component": true }
/src/custom-components/comp-a.wxss
[code]// 内容为空
2.3.4 创建 comp-b 组件
在根目录下创建
/src/custom-components/comp-b文件夹,在这个文件夹下创建小程序原生组件
comp-b,四个文件内容如下:
/src/custom-components/comp-b/index.wxml
[code]<view>comp-b</view> <view><text class="prefix">{{prefix}}</text>-{{str}}-<text class="suffix">{{suffix}}</text></view> <slot></slot>
/src/custom-components/comp-b/index.js
[code]const _ = require('../common/utils') Component({ properties: { prefix: { type: String, value: 'defaultPrefix', }, suffix: { type: String, value: 'defaultSuffix', }, }, data: { str: _.getWords() + 'comp-b', }, })
/src/custom-components/comp-b/index.json
[code]{ "component": true }
/src/custom-components/comp-b/index.wxss
[code].prefix, .suffix { color: green; }
2.3.5 创建 comp-c 组件
在
/src/custom-components文件夹下创建小程序原生组件
comp-c,四个文件内容如下:
/src/custom-components/comp-c.wxml
[code]<view>comp-c</view> <comp-d> <view>comp-d slot</view> </comp-d> <slot></slot>
/src/custom-components/comp-c.js
[code]Component({})
/src/custom-components/comp-c.json
[code]{ "component": true, "usingComponents": { "comp-d": "./comp-d" } }
/src/custom-components/comp-c.wxss
[code]// 内容为空
2.3.6 创建 comp-d 组件
在
/src/custom-components文件夹下创建小程序原生组件
comp-d,四个文件内容如下:
/src/custom-components/comp-d.wxml
[code]<view>comp-d</view> <slot></slot>
/src/custom-components/comp-d.js
[code]Component({})
/src/custom-components/comp-d.json
[code]{ "component": true }
/src/custom-components/comp-d.wxss
[code]// 内容为空
2.4 小程序端效果预览
[code]npm run mp
- 数据提供程序中Command组件使用
- 使用VS2005建立安装程序--内置复选框对话框
- .Net——使用.net内置处理程序处理自定义节点Demo
- FSO内置组件使用方法
- Windows 防火墙无法运行 - “由于另一个程序或正在运行的服务可能正在使用网络地址转换组件(Ipnat.sys)”
- 微信小程序例子——使用text组件实现转义符换行
- 使用IE内置组件实现web页面打印 --终于找到了
- 利用ATL创建com组件和如何在程序中使用组件的接口函数和设置接口的属性
- Windows server 2008 64-bit计划任务运行使用了excel 2003 32-bit .net开发组件的程序遇到的问题
- 某公司的一程序使用Framework组件需要升级到3.5版本
- Android 高级UI设计笔记01:使用ExpandableListView组件(ListView的扩展)
- 微信小程序例子——如何使用view组件显示文字
- java高级编程,JNI的使用。c程序调用java代码
- 用ASPJPEG组件高级使用方法介绍
- Flex 3: 构建高级用户界面 使用数据提供程序1
- 使用VS2008自带的单元测试组件来测试纯c++程序
- Delphi2010中DataSnap高级技术(5)—建立稳定服务程序之TCP心跳包的使用
- firefox附加组件开发者指南(四)——使用XPCOM:实现高级处理
- Windows Forms高级界面组件-使用对话框
- 使用友盟组件,android混淆后程序报错解决方案