微信小程序 WeUI·快速上手

快速上手

使用之前

擴(kuò)展組件庫基于小程序自定義組件構(gòu)建，在使用擴(kuò)展組件庫之前，建議先閱讀熟悉小程序自定義組件。

引入組件

1. 通過 useExtendedLib 擴(kuò)展庫 的方式引入，這種方式引入的組件將不會(huì)計(jì)入代碼包大小。
2. 可以通過npm方式下載構(gòu)建，npm包名為weui-miniprogram

如何使用

首先要在 app.wxss 里面引入 weui.wxss，如果是通過 npm 引入，需要先構(gòu)建 npm（“工具”菜單 --> “構(gòu)建 npm”）

通過 useExtendedLib 擴(kuò)展庫 的方式引入，可省略 import 步驟

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

然后可以在頁面中引入 dialog 彈窗組件

1. 首先在頁面的 json 文件加入 usingComponents 配置字段

{
  "usingComponents": {
    "mp-dialog": "/miniprogram_npm/weui-miniprogram/dialog/dialog"
  }
}

1. 然后可以在對(duì)應(yīng)頁面的 wxml 中直接使用該組件

<mp-dialog title="test" show="{{true}}" bindbuttontap="tapDialogButton" buttons="{{[{text: '取消'}, {text: '確認(rèn)'}]}}">
    <view>test content</view>
</mp-dialog>

完整的組件的使用文檔請(qǐng)參考具體的組件的文檔。

修改組件內(nèi)部樣式

每個(gè)組件可以設(shè)置ext-class這個(gè)屬性，該屬性提供設(shè)置在組件WXML頂部元素的class，組件的addGlobalClass的options都設(shè)置為true，所以可以在頁面設(shè)置wxss樣式來覆蓋組件的內(nèi)部樣式。需要注意的是，如果要覆蓋組件內(nèi)部樣式，必須wxss的樣式選擇器的優(yōu)先級(jí)比組件內(nèi)部樣式優(yōu)先級(jí)高。 addGlobalClass在基礎(chǔ)庫2.2.3開始支持。

適配 DarkMode

在根結(jié)點(diǎn)（或組件的外層結(jié)點(diǎn)）增加屬性 data-weui-theme="dark"，即可把 WeUI 組件切換到 DarkMode 的表現(xiàn)，如:

<view data-weui-theme="dark">
    ...
</view>

也可以參考庫中提供的 Demo。