组件上手

关于微信小程序组件的相关知识,本文不会做详细的描述,这些知识点需要你去参考微信小程序的自定义组件组件上手 - 图1来获取,本文的重点是保证每一个使用者都能正确快速的在自己的项目里使用Lin-UI。

组件的引入

引入Lin-UI组件和引入自己写的组件一样,首先需要在 json 文件中进行自定义组件声明,也就是在usingComponents 下以键值对的形式去注册,l-icon 是组件的名称,path/to/icon/index 是组件的路径。

注意事项

需要注意的是,由于引入lin-ui的方式不同,(npm引入/ 复制源码的dist文件夹),所以这里的path/to 只是用来表示路径这个含义,并不能直接复制进项目里。需要你根据实际情况来配置正确的路径。

  1. {
  2. "usingComponents": {
  3. "l-icon": "path/to/icon/index"
  4. }
  5. }

组件的使用

当组件的声明已经完成,那么我们在页面的 wxml 中就可以像使用基础组件一样使用自定义组件。同时每个组件都有相对应的props(属性), 例如: l-icon标签上的name属性,就是根据传递不同的name值,来显示不同的icon

注意事项

因为 WXML 节点标签名只能是小写字母、中划线和下划线的组合,所以自定义组件的标签名也只能包含这些字符。

  1. <l-icon name="add" />

组件的事件

大部分的组件都有对应的事件,详细的内容请参阅每个组件的文档,以及统一的事件说明组件上手 - 图2

全局自定义组件

我们都知道微信小程序的组件使用需要在页面的json文件里注册,那么这个时候会有一个问题:一些常用的基础组件,如toastdiolag等等,每次在一个页面使用都要在json中去声明一次,实在过于繁琐,或则说这一点也不前端。所以,对于这类跨页面,使用频率高的组件,我们可以在app.json里一次性声明,也就是创建全局自定义组件,声明的方法和页面声明一样。

  1. {
  2. "pages": ["pages/index/index", "pages/logs/index"],
  3. "window": {
  4. "navigationBarTitleText": "Demo"
  5. },
  6. "tabBar": {
  7. "list": [
  8. {
  9. "pagePath": "pages/index/index",
  10. "text": "首页"
  11. },
  12. {
  13. "pagePath": "pages/logs/logs",
  14. "text": "日志"
  15. }
  16. ]
  17. },
  18. "usingComponents": {
  19. "l-toast": "path/to/toast/index",
  20. "l-message": "path/to/message/index"
  21. }
  22. }

这样,我们使用Lin-UI开发的效率又会大大提升啦!

官方提示:组件开发体验爽,一直使用一直爽!