WeUI designed exclusively for WeChat Web services

Overview

WeUI is a basic style library consistent with WeChat's native visual experience, designed by WeChat's official design team for WeChat Web development, making users' perception more unified. It includesbutton、cell、dialog、toast、article、iconand other various elements.

Installation

Method 1 (Recommended)

WeChat Official, Staticfile CDN, and cdnjs provide CDN links for WeUI; they are recommended. The links are as follows:

Method 2:

Install using bower

bower install --save weui

Method 3:

Install using npm

npm install --save weui

Development

git clone https://github.com/weui/weui.git
cd weui
npm install -g gulp
npm install
gulp -ws

Rungulp -wscommand, which will watchsrcchanges to all files in the directory, and by default will8080start the server on port, then open in browserhttp://localhost:8080/example。

Mobile Preview

Please scan the QR code with WeChat

WEUI Online Examples

Button

Buttons can useaorbuttontag. On WAP, to trigger the active state of a button, the ontouchstart event must be triggered. You canbodyadd on theontouchstart=""global trigger.

Common button operation scenarios: confirm, cancel, alert, corresponding to the classes:weui_btn_primary、weui_btn_default、weui_btn_warneach scenario has its own disabled stateweui_btn_disabledin addition, there is also a hollow buttonweui_btn_plain_xxxIn the client webview, there are two types of button sizes: default width 100%, small buttons with adaptive width, and the spacing between the borders and text on both sides is 0.75em:

<a href=".." class="weui_btn weui_btn_primary">按钮</a>
<a href=".." class="weui_btn weui_btn_disabled weui_btn_primary">按钮</a>
<a href=".." class="weui_btn weui_btn_warn">确认</a>
<a href=".." class="weui_btn weui_btn_disabled weui_btn_warn">确认</a>
<a href=".." class="weui_btn weui_btn_default">按钮</a>
<a href=".." class="weui_btn weui_btn_disabled weui_btn_default">按钮</a>
<div class="button_sp_area">
    <a href=".." class="weui_btn weui_btn_plain_default">按钮</a>
    <a href=".." class="weui_btn weui_btn_plain_primary">按钮</a>

    <a href=".." class="weui_btn weui_btn_mini weui_btn_primary">按钮</a>
    <a href=".." class="weui_btn weui_btn_mini weui_btn_default">按钮</a>
</div>

Cell

Cella list view used to display information in a list structure on the page; it is the most commonly used content structure on WAP.CellIt consists of multiple sections, each section includes a section headerweui_cells_titleand cellsweui_cells。

cellconsists of thumbnailweui_cell_hd、bodyweui_cell_bd、accessoryweui_cell_ftthree parts,cellUses adaptive layout; add the class to the part that needs adaptationweui_cell_primaryand it is done:

List item with description

<div class="weui_cells_title">带说明的列表项</div>
<div class="weui_cells">
    <div class="weui_cell">
        <div class="weui_cell_bd weui_cell_primary">
            <p>标题文字</p>
        </div>
        <div class="weui_cell_ft">
            说明文字
        </div>
    </div>
</div>

CellIt can be customized and extended as needed, including auxiliary descriptions, navigation, single selection, multiple selection, etc. Below is a list item with icon, description, and navigation; for other cases, you can directly refer toexamplethe code under:

<div class="weui_cells_title">带图标、说明、跳转的列表项</div>
<div class="weui_cells weui_cells_access">

    <a class="weui_cell" href="..">
        <div class="weui_cell_hd">
            <img src="" alt="icon" style="width:20px;margin-right:5px;display:block">
        </div>
        <div class="weui_cell_bd weui_cell_primary">
            <p>cell standard</p>
        </div>
        <div class="weui_cell_ft">
            说明文字
        </div>
    </a>
    <a class="weui_cell" href="..">
        <div class="weui_cell_hd">
            <img src="" alt="icon" style="width:20px;margin-right:5px;display:block">
        </div>
        <div class="weui_cell_bd weui_cell_primary">
            <p>cell standard</p>
        </div>
        <div class="weui_cell_ft">
            说明文字
        </div>
    </a>
</div>

Dialog

If the system's alert window cannot meet the temporary view content requirements of the web page, you can implement a customized dialog similar in form to alert, and you can freely use various controls in the dialog to meet your needs.

<div class="weui_dialog_confirm">
    <div class="weui_mask"></div>
    <div class="weui_dialog">
        <div class="weui_dialog_hd"><strong class="weui_dialog_title">弹窗标题</strong></div>
        <div class="weui_dialog_bd">自定义弹窗内容<br>...</div>
        <div class="weui_dialog_ft">
            <a href=".." class="weui_btn_dialog default">取消</a>
            <a href=".." class="weui_btn_dialog primary">确定</a>
        </div>
    </div>
</div>

<div class="weui_dialog_alert">
    <div class="weui_mask"></div>
    <div class="weui_dialog">
        <div class="weui_dialog_hd"><strong class="weui_dialog_title">弹窗标题</strong></div>
        <div class="weui_dialog_bd">弹窗内容，告知当前页面信息等</div>
        <div class="weui_dialog_ft">
            <a href=".." class="weui_btn_dialog primary">确定</a>
        </div>
    </div>
</div>

Toast

Toast is used to temporarily display certain information, and it will automatically disappear after a few seconds. Such information is usually success, failure, or waiting status messages for lightweight operations.

<div id="toast" style="display: none;">
    <div class="weui_mask_transparent"></div>
    <div class="weui_toast">
        <i class="weui_icon_toast"></i>
        <p class="weui_toast_content">已完成</p>
    </div>
</div>

<div id="loadingToast" class="weui_loading_toast" style="display:none;">
    <div class="weui_mask_transparent"></div>
    <div class="weui_toast">
        <div class="weui_loading">
            <!-- :) -->
            <div class="weui_loading_leaf weui_loading_leaf_0"></div>
            <div class="weui_loading_leaf weui_loading_leaf_1"></div>
            <div class="weui_loading_leaf weui_loading_leaf_2"></div>
            <div class="weui_loading_leaf weui_loading_leaf_3"></div>
            <div class="weui_loading_leaf weui_loading_leaf_4"></div>
            <div class="weui_loading_leaf weui_loading_leaf_5"></div>
            <div class="weui_loading_leaf weui_loading_leaf_6"></div>
            <div class="weui_loading_leaf weui_loading_leaf_7"></div>
            <div class="weui_loading_leaf weui_loading_leaf_8"></div>
            <div class="weui_loading_leaf weui_loading_leaf_9"></div>
            <div class="weui_loading_leaf weui_loading_leaf_10"></div>
            <div class="weui_loading_leaf weui_loading_leaf_11"></div>
        </div>
        <p class="weui_toast_content">数据加载中</p>
    </div>
</div>

Result Page (Msg Page)

The result page can generally be considered a summary page after a series of operation steps, serving as the end of a process. Its main purpose is to inform users of the operation processing result and necessary relevant details (which can be used to confirm whether previous operations were correct). If the process is used to enable or disable certain important functions, descriptive content related to the function can be added to the result page. In addition, the result page can also carry added-value operations, such as providing entry points for lucky draws, following the official account, etc.

<div class="weui_msg">
    <div class="weui_icon_area"><i class="weui_icon_success weui_icon_msg"></i></div>
    <div class="weui_text_area">
        <h2 class="weui_msg_title">操作成功</h2>
        <p class="weui_msg_desc">内容详情，可根据实际需要安排</p>
    </div>
    <div class="weui_opr_area">
        <p class="weui_btn_area">
            <a href=".." class="weui_btn weui_btn_primary">确定</a>
            <a href=".." class="weui_btn weui_btn_default">取消</a>
        </p>
    </div>
    <div class="weui_extra_area">
        <a href="">查看详情</a>
    </div>
</div>

Article Page

Text view displays large passages of text, which are usually the main content of the page.ArticleIt supports rich text styles such as paragraphs, multi-level headings, quotes, embedded images, ordered/unordered lists, and can respond to user selection operations.

When using in the WeChat client webviewArticleyou must ensure that the text has sufficient readability and recognizability, use proper fonts, ensure adequate paragraph spacing, and no indentation at paragraph starts.

<article class="weui_article">
    <h1>大标题</h1>
    <section>
        <h2 class="title">章标题</h2>
        <section>
            <h3>1.1 节标题</h3>
            <p>Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod
                tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam,
                quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo
                consequat. Duis aute</p>
        </section>
        <section>
            <h3>1.2 节标题</h3>
            <p>Lorem ipsum dolor sit amet, consectetur adipisicing elit, sed do eiusmod
                tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam,
                cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non
                proident, sunt in culpa qui officia deserunt mollit anim id est laborum.</p>
        </section>
    </section>
</article>

Icons

<i class="weui_icon_msg weui_icon_success"></i>
<i class="weui_icon_msg weui_icon_info"></i>
<i class="weui_icon_msg weui_icon_warn"></i>
<i class="weui_icon_msg weui_icon_waiting"></i>
<i class="weui_icon_safe weui_icon_safe_success"></i>
<i class="weui_icon_safe weui_icon_safe_warn"></i>
<div class="icon_sp_area">
    <i class="weui_icon_success"></i>
    <i class="weui_icon_success_circle"></i>
    <i class="weui_icon_success_no_circle"></i>
    <i class="weui_icon_info"></i>
    <i class="weui_icon_waiting"></i>
    <i class="weui_icon_waiting_circle"></i>
    <i class="weui_icon_circle"></i>
    <i class="weui_icon_warn"></i>
    <i class="weui_icon_download"></i>
    <i class="weui_icon_info_circle"></i>
</div>

Project Download Address

Github address:https://github.com/weui/weui

This site's address:weui-master.zip