• 快速上手
    • 使用之前
    • 引入组件
    • 如何使用
    • 修改组件内部样式

    快速上手

    使用之前

    扩展组件库基于小程序自定义组件构建，在使用扩展组件库之前，建议先阅读熟悉小程序自定义组件。

    引入组件

    • 可以通过npm方式下载构建，npm包名为weui-miniprogram
    • 也可以通过页面按需下载

    如何使用

    假设组件的目录为weui-miniprogram，首先要在app.wxss里面引入weui.wxss

    1. @import './weui-miniprogram/weui-wxss/dist/style/weui.wxss';

    然后可以在页面中引入 dialog 弹窗组件

    • 首先在页面的 json 文件加入 usingComponents 配置字段
    1. {
    2.   "usingComponents": {
    3.     "mp-dialog": "/path/components/dialog/dialog"
    4.   }
    5. }
    • 然后可以在对应页面的 wxml 中直接使用该组件
    1. <mp-dialog title="test" show="{{true}}" bindbuttontap="tapDialogButton" buttons="{{[{text: '取消'}, {text: '确认'}]}}">
    2.     <view>test content</view>
    3. </mp-dialog>

    完整的组件的使用文档请参考具体的组件的文档。

    修改组件内部样式

    每个组件可以设置ext-class这个属性，该属性提供设置在组件WXML顶部元素的class，组件的addGlobalClass的options都设置为true，所以可以在页面设置wxss样式来覆盖组件的内部样式。需要注意的是，如果要覆盖组件内部样式，必须wxss的样式选择器的优先级比组件内部样式优先级高。addGlobalClass在基础库2.2.3开始支持。