手册

微信小程序框架

MINA 文件目录结构小程序配置

逻辑层(App Service)

注册程序注册页面模块化 API

微信小程序 WXML

微信小程序数据绑定微信小程序条件渲染 wx:if 微信小程序列表渲染 wx:for 微信小程序模板微信小程序事件微信小程序引用微信小程序 WXSS 微信小程序基础组件微信小程序WeUI.js网页开发样式库

视图容器

微信小程序视图容器微信小程序可滚动视图区域微信小程序滑块视图容器

基础内容

微信小程序内容组件图标 icon 微信小程序内容组件 text（文本）微信小程序内容组件进度条：progress

表单组件

微信小程序按钮组件：button 微信小程序表单组件 checkbox 微信小程序表单组件 form 微信小程序表单组件输入框 input 微信小程序表单组件 label 微信小程序表单组件选择器 picker 微信小程序表单组件picker-view（嵌入页面的滚动选择器）微信小程序表单组件单选框 radio 微信小程序表单组件滑动选择器 slider 微信小程序表单组件开关 switch 微信小程序表单组件多行输入框 textarea

操作反馈

wxapp操作反馈上拉菜单 action-sheet wxapp操作反馈模式对话框 modal wxapp操作反馈消息提示框：toast wxapp操作反馈消息提示框：loading

微信小程序导航

微信小程序导航 navigator

媒体组件

媒体组件 audio 媒体组件 image 媒体组件 video（视频）

地图

微信小程序地图 map

画布

wxapp画布 canvas

客服会话

微信小程序组件 contact-button（客服会话按钮）

网络

微信小程序API 发起请求微信小程序API 上传、下载微信小程序API Websocket

媒体

微信小程序API 图片微信小程序API 录音微信小程序API 音频播放控制微信小程序API 音乐播放控制微信小程序API 视频微信小程序音频组件控制微信小程序视频组件控制微信小程序API 文件

数据

微信小程序API 数据缓存

位置

微信小程序API 位置微信小程序API 获取位置微信小程序API 查看位置微信小程序API 地图组件控制

设备

微信小程序API 系统信息微信小程序API 网络状态微信小程序API 重力感应微信小程序API 罗盘微信小程序API 拨打电话微信小程序API 扫码

界面交互

微信小程序API 交互反馈微信小程序API 设置导航条微信小程序API 导航微信小程序API 动画

绘图

开放接口

微信小程序API 登录微信小程序API 用户数据的签名验证和加解密微信小程序API 用户信息微信小程序API 微信支付微信小程序API 模板消息微信小程序API 接收消息和事件微信小程序API 发送客服消息微信小程序API 临时素材接口微信小程序API 接入指引微信小程序API 分享微信小程序API 获取小程序页面二维码

工具

微信小程序工具概览微信小程序工具程序调试的三大主要功能区微信小程序工具代码编辑微信小程序工具项目页卡三大主要功能微信小程序工具下载地址微信小程序工具细节点微信小程序开发者工具测试版本的下载微信小程序联系我们微信小程序 Q&A

微信小程序设计规范

微信小程序设计规范（1）友好礼貌微信小程序设计规范（2）清晰明确微信小程序设计规范（3）便捷优雅微信小程序设计规范（4）统一稳定微信小程序设计规范（5）视觉规范

首页移动端小程序微信小程序开发文档

微信小程序WeUI.js网页开发样式库

阅读90483

更新时间2022-04-11

微信小程序基础组件

概述

WeUI 是一套同微信原生视觉体验一致的基础样式库，由微信官方设计团队为微信内网页开发量身设计，可以令用户的使用感知更加统一。在微信网页开发中使用 WeUI，有如下优势：

同微信客户端一致的视觉效果，令所有微信用户都能更容易地使用你的网站
便捷获取快速使用，降低开发和设计成本
微信设计团队精心打造，清晰明确，简洁大方

该样式库目前包含 button、cell、dialog、progress、toast、article、icon 等各式元素，已经在 GitHub 上开源。访问 http://weui.github.io/weui/ 或微信扫码即可预览。

使用方法

安装

方法一：使用bower进行安装

bower install --save weui

方法二：使用npm进行安装

npm install --save weui

任选一种方法安装后，只需要在页面中引入 dist/style/weui.css 或者 dist/style/weui.min.css 其中之一即可。例如:

开发

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。

元素类型

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：

按钮
按钮
确认
确认
按钮
按钮

    按钮
    按钮

    按钮
    按钮

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即可：

带说明的列表项

带说明的列表项

标题文字

说明文字

Cell 可根据需要进行各种自定义扩展，包括辅助说明、跳转、单选、复选等。下面以带图标、说明、跳转的列表项，其他情况可以直接参考 example 下的代码：

Dialog

若系统的 alert 窗体无法满足网页的临时视图内容需求，则可以自定义实现与 alert 形式相似的 dialog，并且在 dialog 中可以自定义地使用各种控件，来满足需求。

Progress

Progress 用于上传、下载等耗时并且需要显示进度的场景，用户可以随时中断该操作。

Toast

Toast 用于临时显示某些信息，并且会在数秒后自动消失。这些信息通常是轻量级操作的成功、失败或等待状态信息。

Msg Page

结果页通常来说可以认为进行一系列操作步骤后，作为流程结束的总结性页面。结果页的作用主要是告知用户操作处理结果以及必要的相关细节（可用于确认之前的操作是否有误）等信息；若该流程用于开启或关闭某些重要功能，可在结果页增加与该功能相关的描述性内容；除此之外，结果页也可以承载一些附加价值操作，例如提供抽奖、关注公众号等功能入口。