WeChat アプレット WeUI.js Web 開発スタイル ライブラリ
概要
WeUI は、WeChat のネイティブなビジュアル エクスペリエンスと一致する基本的なスタイル ライブラリのセットであり、WeChat 内での Web 開発のために WeChat の公式デザイン チームによってカスタマイズされており、ユーザーの使用認識をより統一することができます。 WeChat Web 開発で WeUI を使用すると、次のような利点があります:
- WeChat クライアントと同じ視覚効果により、すべての WeChat ユーザーが Web サイトを使いやすくなります
- 便利なアクセスと素早い使用、開発および設計コストの削減
- 慎重にWeChat デザイン チームによって作成され、明確、簡潔、エレガントです
スタイル ライブラリには現在、ボタン、セル、ダイアログ、進行状況、トースト、記事、アイコンなどのさまざまな要素が含まれており、GitHub でオープンソース化されています。 。 http://weui.github.io/weui/ にアクセスするか、WeChat で QR コードをスキャンしてプレビューします。
使い方
インストール
方法1: bowerを使用してインストール
bower install --save weui
方法2: npmを使用してインストール
npm install --save weui
任意の方法を選択してください インストール後、ページにdist/を導入するだけです どちらかのスタイル/weui.css または dist/style/weui.min.css を使用できます。例:
<!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <meta name="viewport" content="width=device-width,initial-scale=1,user-scalable=0"> <title>WeUI</title> <link rel="stylesheet" href="path/to/weui/dist/style/weui.min.css"/> </head> <body> </body> </html>
開発
git clone https://github.com/weui/weui.git cd weui npm install -g gulp npm install gulp -ws
gulp -ws
コマンドを実行します。これは、src ディレクトリ内のすべてのファイルの変更を監視し、デフォルトでポート 8080 でサーバーを起動します。ブラウザで http を開きます: //localhost:8080/example。 gulp -ws
命令,会监听 src 目录下所有文件的变更,并且默认会在8080端口启动服务器,然后在浏览器打开 http://localhost:8080/example。
元素类型
Button
按钮可以使用 a
或者 button
标签。wap 上要触发按钮的 active 态,必须触发 ontouchstart 事件,可以在 body
上加上 ontouchstart=""
全局触发。
按钮常见的操作场景:确定、取消、警示,分别对应 class:weui_btn_primary
、weui_btn_default
、weui_btn_warn
,每种场景都有自己的置灰态weui_btn_disabled
,除此外还有一种镂空按钮 weui_btn_plain_xxx
,客户端 webview 里的按钮尺寸有两类,默认宽度100%,小型按钮宽度自适应,两边边框与文本间距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
Cell
,列表视图,用于将信息以列表的结构显示在页面上,是 wap 上最常用的内容结构。Cell
由多个 section 组成,每个 section 包括 section header weui_cells_title
以及 cells weui_cells
。
Cell
由 thumbnail weui_cell_hd
、body weui_cell_bd
、accessory weui_cell_ft
三部分组成,cell
采用自适应布局,在需要自适应的部分加上 class weui_cell_primary
🎜🎜要素タイプ🎜🎜🎜Button🎜🎜🎜ボタンでは、
a
タグまたは button
タグを使用できます。 WAP 上のボタンのアクティブ状態をトリガーするには、ontouchstart イベントをトリガーする必要があります。 body
のグローバル トリガーに ontouchstart=""
を追加できます。 🎜🎜ボタンの一般的な操作シナリオ: OK、キャンセル、警告、クラスに対応: weui_btn_primary
、weui_btn_default
、weui_btn_warn
、各シナリオには独自のグレー表示のステータス weui_btn_disabled
に加えて、中空のボタン weui_btn_plain_xxx
があります。デフォルトの幅は 100% です。小さなボタンの幅は Adapt からのもので、両側の境界線とテキストの間の間隔は 0.75em です: 🎜🎜![Button.png](https://img.php.cn// img.w3cschool.cn/attachments/day_161218/201612181810406524.png)
<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>🎜🎜Cell🎜🎜🎜
Cell
、リスト ビューは、ページ上の情報をリスト構造で表示するために使用されます。 wap で最も一般的に使用されるコンテンツ構造です。 Cell
は複数のセクションで構成されており、各セクションにはセクション ヘッダー weui_cells_title
とセル weui_cells
が含まれます。 🎜🎜Cell
は 3 つの部分で構成されています: サムネイル weui_cell_hd
、本体 weui_cell_bd
、アクセサリ weui_cell_ft
、cell
code> アダプティブ レイアウトを使用し、アダプティブにする必要がある部分にクラス weui_cell_primary
を追加します。説明付きのリスト項目
<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>
Cell
は、補助的な説明、ジャンプ、ラジオ選択、チェック選択などを含む、必要に応じてさまざまな拡張機能を使用してカスタマイズできます。以下は、アイコン、説明、ジャンプを含むリスト項目です。その他の場合は、example
のコードを直接参照できます: Cell
可根据需要进行各种自定义扩展,包括辅助说明、跳转、单选、复选等。下面以带图标、说明、跳转的列表项,其他情况可以直接参考 example
下的代码:
<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">自定义弹窗内容,居左对齐显示,告知需要确认的信息等</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>
Dialog
若系统的 alert 窗体无法满足网页的临时视图内容需求,则可以自定义实现与 alert 形式相似的 dialog
,并且在 dialog
中可以自定义地使用各种控件,来满足需求。
<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>
<div class="weui_progress"> <div class="weui_progress_bar"> <div class="weui_progress_inner_bar" style="width: 50%;"></div> </div> <a href="#" class="weui_progress_opr"> <i class="weui_icon_cancel"></i> </a> </div>
Progress
Progress
用于上传、下载等耗时并且需要显示进度的场景,用户可以随时中断该操作。
<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>
Toast
Toast
用于临时显示某些信息,并且会在数秒后自动消失。这些信息通常是轻量级操作的成功、失败或等待状态信息。
<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>
<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>
Msg Page
结果页通常来说可以认为进行一系列操作步骤后,作为流程结束的总结性页面。结果页的作用主要是告知用户操作处理结果以及必要的相关细节(可用于确认之前的操作是否有误)等信息;若该流程用于开启或关闭某些重要功能,可在结果页增加与该功能相关的描述性内容;除此之外,结果页也可以承载一些附加价值操作,例如提供抽奖、关注公众号等功能入口。
<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>
Article
文字视图显示大段文字,这些文字通常是页面上的主体内容。Article
支持分段、多层标题、引用、内嵌图片、有/无序列表等富文本样式,并可响应用户的选择操作。
在微信客户端 webview 中使用 Article
<div id="actionSheet_wrap"> <div class="weui_mask_transition" id="mask"></div> <div class="weui_actionsheet" id="weui_actionsheet"> <div class="weui_actionsheet_menu"> <div class="weui_actionsheet_cell">示例菜单</div> <div class="weui_actionsheet_cell">示例菜单</div> <div class="weui_actionsheet_cell">示例菜单</div> <div class="weui_actionsheet_cell">示例菜单</div> </div> <div class="weui_actionsheet_action"> <div class="weui_actionsheet_cell" id="actionsheet_cancel">取消</div> </div> </div> </div>
ダイアログ h2>システムがアラート フォームが Web ページの一時表示コンテンツ要件を満たせない場合は、アラート フォームと同様の ダイアログ
をカスタマイズし、dialog< でさまざまなカスタマイズを使用できます。 /code> コントロールを使用してニーズを満たすことができます。 ![Text.png](https://img.php.cn//img.w3cschool.cn/attachments/day_161218/201612181810422915.png)
![Dialog1.png](https://img.php.cn//img.w3cschool.cn/attachments/day_161218/201612181810416737.png)
<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>
<i class="weui_icon_cancel"></i>
</div>
🎜
🎜rrreee🎜
🎜進捗状況 strong>
🎜Progress
は、アップロードやダウンロードなど、時間がかかり、進行状況を表示する必要があるシナリオで使用されます。ユーザーはいつでも操作を中断できます。 🎜🎜
🎜rrreee🎜
🎜< h2>トースト
🎜<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> <i class="weui_icon_cancel"></i> </div>🎜
![Dialog2 .png](https://img.php.cn//img.w3cschool.cn/attachments/day_161218/201612181810417489.png)
🎜
進捗状況 strong>
🎜Progress
は、アップロードやダウンロードなど、時間がかかり、進行状況を表示する必要があるシナリオで使用されます。ユーザーはいつでも操作を中断できます。 🎜🎜![Progress.png](https://img.php.cn//img.w3cschool.cn/attachments/day_161218/201612181810415124.png)
🎜< h2>トースト
トースト
は、特定の情報を一時的に表示するために使用され、数秒後に自動的に消えます。この情報は通常、軽量操作の成功、失敗、または待機ステータス情報です。 🎜🎜![トースト1.png](https://img.php.cn//img.w3cschool.cn/attachments/day_161218/201612181810417928.png)
![トースト2 .png](https://img.php.cn//img.w3cschool.cn/attachments/day_161218/201612181810415183.png)
🎜
メッセージ ページ< /strong>
🎜結果ページは通常、一連のステップを経たプロセスの最後にある概要ページと考えることができます。結果ページの主な機能は、プロセスが一部の重要な機能をオンまたはオフにするために使用される場合、操作の処理結果と必要な関連詳細をユーザーに通知することです (前の操作が間違っていたかどうかを確認するために使用できます)。結果ページには、機能に関連する説明コンテンツを追加できます。また、結果ページには、宝くじの抽選、公開アカウントのフォロー、その他の機能の入り口など、追加の価値のある操作も含めることができます。 🎜🎜![Result.png](https://img.php.cn//img.w3cschool.cn/attachments/day_161218/201612181810418879.png)
🎜< h2>記事🎜テキスト ビューには、通常、ページのメイン コンテンツである大きなテキスト ブロックが表示されます。
Article
は、段落、複数レイヤーのタイトル、引用、インライン画像、順序付き/順序なしリストなどのリッチ テキスト スタイルをサポートし、ユーザーの選択操作に応答できます。 🎜🎜WeChat クライアント Web ビューで Article
を使用する場合は、テキストが十分に読みやすく読みやすいこと、標準フォントを使用すること、十分な段落間隔を確保すること、段落の先頭にインデントがないことを確認する必要があります。 🎜🎜🎜🎜rrreeeActionSheet
ActionSheet
は、指示、ジャンプなどを含む一連のインタラクティブなアクションのコレクションを表示するために使用されます。下からポップアップします。通常は、ページ上のユーザーのクリックに応答するために使用されます。
Icon
技術サポートとフィードバック
GitHub へようこそ。メッセージやフィードバックを残してください。