> 微信小程序开发教程手册 > 组件文档

基础组件


框架为开发者提供了一系列基础组件,开发者可以通过组合这些基础组件进行快速开发。

什么是组件:

  • 组件是视图层的基本组成单元。
  • 组件自带一些功能与微信风格的样式。
  • 一个组件通常包括开始标签结束标签属性用来修饰这个组件,内容在两个标签之内。

    <tagname property="value">
      Content goes here ...
    </tagename>

    注意:所有组件与属性都是小写,以连字符-连接

属性类型


类型 描述 注解
Boolean 布尔值 组件写上该属性,不管该属性等于什么,其值都为true,只有组件上没有写该属性时,属性值才为false。如果属性值为变量,变量的值会被转换为Boolean类型
Number 数字 1, 2.5
String 字符串 "string"
Array 数组 [ 1, "string" ]
Object 对象 { key: value }
EventHandler 事件处理函数名 "handlerName" 是Page中定义的事件处理函数名
Any 任意属性  

共同属性类型


所有组件都有的属性:

属性名 类型 描述 注解
id String 组件的唯一标示 保持整个页面唯一
class String 组件的样式类 在对应的wxss中定义的样式类
style String 组件的内联样式 可以动态设置的内联样式
hidden Boolean 组件是否显示 所有组件默认显示
data-* Any 自定义属性 组件上触发的事件时,会发送给事件处理函数
bind* / catch* EventHandler 组件的事件 详见事件

特殊属性


几乎所有组件都有各自定义的属性,可以对该组件的功能或样式进行修饰,请参考各个组件的定义。

组件列表


基础组件分为以下八大类:

视图容器(View Container):

组件名 说明
view 视图容器
scroll-view 可滚动视图容器
swiper 可滑动的视图容器

基础内容(Basic Content):

组件名 说明
icon 图标
text 文字
progress 进度条

表单(Form):

标签名 说明
button 按钮
form 表单
input 输入框
checkbox 多项选择器
radio 单项选择器
picker 列表选择器
picker-view 内嵌列表选择器
slider 滑动选择器
switch 开关选择器
label 标签

操作反馈(Interaction):

组件名 说明
action-sheet 上拉菜单
modal 模态弹窗
toast 短通知

导航(Navigation):

组件名 说明
navigator 应用内跳转

多媒体(Media):

组件名 说明
audio 音频
image 图片
video 视频

地图(Map):

组件名 说明
map 地图

画布(Canvas):

组件名 说明
canvas 画布

客服会话:

组件名 说明
contact-button 进入客服会话按钮