Applet WeChat Bibliothèque de styles de développement Web WeUI.js
Présentation
WeUI est un ensemble de bibliothèques de styles de base qui sont cohérentes avec l'expérience visuelle native de WeChat. Il est conçu sur mesure par l'équipe de conception officielle de WeChat pour le développement Web au sein de WeChat, ce qui peut rendre la perception d'utilisation des utilisateurs plus unifiée. L'utilisation de WeUI dans le développement Web WeChat présente les avantages suivants :
- Les mêmes effets visuels que le client WeChat, facilitant l'utilisation de votre site Web par tous les utilisateurs de WeChat
- Accès pratique et utilisation rapide, réduisant les coûts de développement et de conception
- Attention conçu par l'équipe de conception de WeChat, il est clair, concis et élégant
La bibliothèque de styles comprend actuellement divers éléments tels qu'un bouton, une cellule, une boîte de dialogue, une progression, un toast, un article, une icône, etc., et a été open source sur GitHub . Visitez http://weui.github.io/weui/ ou scannez le code QR sur WeChat pour avoir un aperçu.
Comment utiliser
Installation
Première méthode : utilisez bower pour installer
bower install --save weui
Méthode deux : utilisez npm pour installer
npm install --save weui
Choisissez n'importe quelle méthode Après l'installation, introduisez simplement dist/ dans la page. Quel que soit le style /weui.css ou dist/style/weui.min.css peuvent être utilisés. Par exemple :
<!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>
Development
git clone https://github.com/weui/weui.git cd weui npm install -g gulp npm install gulp -ws
Exécutez la commande gulp -ws, qui surveillera les modifications dans tous les fichiers du répertoire src, et démarrera le serveur sur le port 8080 par défaut, puis ouvrez http dans le navigateur : //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
🎜🎜Type d'élément🎜🎜🎜Button🎜🎜🎜Les boutons peuvent utiliser les balises
a ou button. Pour déclencher l'état actif d'un bouton sur wap, l'événement ontouchstart doit être déclenché. Vous pouvez ajouter ontouchstart="" au déclencheur global sur body. 🎜🎜Scénarios de fonctionnement courants des boutons : OK, Annuler, Avertissement, correspondant aux classes : weui_btn_primary, weui_btn_default, weui_btn_warn, chaque scénario a Il a son propre statut grisé weui_btn_disabled De plus, il y a un bouton creux weui_btn_plain_xxx Il existe deux types de tailles de bouton dans la vue Web du client. et la largeur des petits boutons est de Adapt, l'espacement entre les bordures des deux côtés et le texte est de 0,75em : 🎜🎜
🎜<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, vue en liste, est utilisée pour afficher des informations sur la page dans une structure de liste. est la structure de contenu la plus couramment utilisée sur wap. Cell est composé de plusieurs sections, chaque section comprend un en-tête de section weui_cells_title et des cellules weui_cells. 🎜🎜Cell se compose de trois parties : vignette weui_cell_hd, corps weui_cell_bd, accessoire weui_cell_ft, cell< /code> code> Utilisez la mise en page adaptative et ajoutez la classe weui_cell_primary aux parties qui doivent être adaptatives : 🎜
Liste des éléments avec description
<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>
Cellule peut être personnalisée avec diverses extensions selon les besoins, y compris la description auxiliaire, le saut, la sélection radio, la sélection de vérification, etc. Ce qui suit est un élément de liste avec des icônes, des descriptions et des sauts. Dans d'autres cas, vous pouvez directement faire référence au code sous exemple : 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>
DialogueSi le système Si le formulaire d'alerte ne peut pas répondre aux exigences de contenu d'affichage temporaire de la page Web, vous pouvez personnaliser une dialogue similaire au formulaire d'alerte et utiliser diverses personnalisations dans la dialogue< /code> contrôles pour répondre à vos besoins. 
<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🎜
🎜Progrès
🎜Progress est utilisé dans des scénarios tels que le téléchargement et le téléchargement qui prennent du temps et nécessitent d'afficher la progression. L'utilisateur peut interrompre l'opération à tout moment. 🎜🎜🎜rrreee🎜
🎜< h2>Toast
🎜Toast permet d'afficher temporairement certaines informations et disparaîtra automatiquement après quelques secondes. Ces informations sont généralement des informations sur la réussite, l'échec ou l'état d'attente pour les opérations légères. 🎜🎜🎜rrreee🎜🎜rrreee🎜
🎜Page de message< /strong>
🎜La page de résultats peut généralement être considérée comme une page récapitulative à la fin du processus après une série d'étapes. La fonction principale de la page de résultats est d'informer l'utilisateur des résultats du traitement de l'opération et des détails pertinents nécessaires (qui peuvent être utilisés pour confirmer si l'opération précédente était incorrecte) ; vous pouvez ajouter les informations relatives à la page de résultats à la page de résultats. Contenu descriptif lié aux fonctions. De plus, la page de résultats peut également comporter certaines opérations de valeur supplémentaires, telles que la fourniture de tirages de loterie, le suivi des comptes publics et d'autres entrées fonctionnelles. 🎜🎜🎜rrreee🎜
🎜< h2>Article🎜La vue Texte affiche de gros blocs de texte, qui constituent généralement le contenu principal de la page. Article prend en charge les styles de texte enrichi tels que les paragraphes, les titres multicouches, les citations, les images en ligne, les listes ordonnées/non ordonnées, etc., et peut répondre aux opérations de sélection de l'utilisateur. 🎜🎜Lorsque vous utilisez Article dans la vue Web du client WeChat, vous devez vous assurer que le texte est suffisamment lisible et lisible, utiliser des polices standard, garantir un espacement de paragraphe suffisant et ne pas avoir d'indentation au début du paragraphe. 🎜🎜🎜🎜rrreee
ActionSheet
ActionSheet est utilisé pour afficher une série de collections d'actions interactives, comprenant des instructions, des sauts, etc. Pop up depuis le bas, généralement utilisé pour répondre aux clics des utilisateurs sur la page.
rrreee
Icône
rrreee
Support technique et commentaires
Bienvenue pour laisser des messages ou des commentaires sur GitHub.
