# 基础组件
小程序框架为开发者提供了一系列基础组件,开发者可以通过组合这些基础组件进行业务开发。
什么是组件:
- 在 template 中使用组件,是视图层的基本组成单元。
- 一个组件通常包括开始标签和结束标签,属性用来修饰这个组件,内容在两个标签之内。
建议所有组件与属性都是小写,以连字符-连接
# 属性类型
类型 | 描述 | 说明 |
---|---|---|
Boolean | 布尔值 | 组件写上该属性,不管是什么值都被当作 true;只有组件上没有该属性时,属性值才为false。如果属性值为变量,变量的值会被转换为Boolean类型 |
Number | 数字 | 1, 2.1 |
String | 字符串 | "string" |
Array | 数组 | [ 1, "string" ] |
Object | 对象 | { key: value } |
EventHandler | 事件回调函数名 | Page 中定义的事件处理函数名 |
Any | 任意类型 |
# 共有属性
任何组件都可以定义以下属性:
属性名 | 类型 | 描述 | 说明 |
---|---|---|---|
id | String | 组件的唯一标识 | |
class | String | 组件的样式类 | 在对应的 css 中定义的样式类 |
style | String | 组件的内联样式 | |
data-* | Any | 组件的自定义数据 | 可以定义任意类型属性的数据,并可以在事件回调中通过 dataset 获取 |
# 特殊属性
几乎所有组件都有各自定义的属性,可以对该组件的功能或样式进行修饰,请参考各个组件的文档。