一套组件化、可复用、易扩展的头条小程序 UI 组件库
npm install tt-mp在开始使用之前,你需要先阅读 头条小程序自定义组件 的相关文档。
通过 npm 安装,需要依赖小程序基础库 2.2.1 以上版本,同时依赖开发者工具的 npm 构建,详见 npm 支持。
``bashUsing npm
npm i tt-mp -S --production
$3
通过 GitHub 下载
tt-mp 的代码,然后 将 packages/lib/ 目录拷贝到自己的项目中。-
packages/lib/ - 压缩版(ES5)
- packages/es/ - 未压缩版(ES6,使用时需要开启 ES6 转 ES5,位于开发者工具右上角-详情-本地配置)`bash
git clone https://github.com/winteraq/tt-mini-app.git
cd tt-mp
`$3
参考 量身定制。
如何使用
按照如下的方式使用组件,以
Button 为例,其它组件在对应的文档页查看:$3
`json
"usingComponents": {
"wux-button": "../../dist/button/index"
}
`$3
`html
Button
Button
Button
`$3
随着组件库越来越丰富,文件的体积也越来越大,某些时候我们可能只需要其中的一个或多个组件,如果直接引入整个组件库的话是不合适的,这时候就需要我们将要使用到组件给单独抽离出来。
1. 使用 量身定制 功能自动抽离组件(官方推荐)。
2. 手动抽离组件,也很简单直接拷贝
packages/ 目录下对应的组件即可,当然某些组件存在依赖关系,则抽离过程会相对复杂一些,以 ActionSheet、Badge、Button 为例。`
demo/
|-actionsheet/
|-animation-group/
|-backdrop/
|-badge/
|-button/
|-helpers/
|-index.js
`- 首先将
lib/ 目录下对应组件(如 actionsheet)拷贝至 demo 目录;
- 其次看其对应目录下 index.json 是否存在依赖组件,若存在则一一拷贝;
- 然后看组件是否依靠 JavaScript 主动调用(查看对应文档可得知或存在 index.js 文件中),是则拷贝 index.js 文件,并删除不需要的组件引用;
- 最后查看组件目录下 index.js 是否存在对帮助方法的引用,若存在则拷贝 helpers` 目录(抑或直接拷贝不管是否存在引用)。MIT