快手广告代理平台-基础组件
快手小程序为开发者提供了一系列基础组件，开发者可以通过组合这些基础组件进行快速开发。详细介绍请参考组件文档。
什么是组件：
组件是视图层的基本组成单元。
组件自带一些功能与快手风格一致的样式。
一个组件通常包括 开始标签 和 结束标签，属性 用来修饰这个组件，内容 在两个标签之内。
<tagname property="value">
Content goes here ...
</tagname>
注意：所有组件与属性都是小写，以连字符-连接
属性类型
| 类型 | 描述 | 注解 |
|---|---|---|
| Boolean | 布尔值 | 组件写上该属性，不管是什么值都被当作 true；只有组件上没有该属性时，属性值才为 false。 如果属性值为变量，变量的值会被转换为 Boolean 类型 |
| Number | 数字 | 1, 2.5 |
| String | 字符串 | "string" |
| Array | 数组 | [ 1, "string" ] |
| Object | 对象 | { key: value } |
| EventHandler | 事件处理函数名 | "handlerName" 是 Page 中定义的事件处理函数名 |
| Any | 任意属性 |
公共属性
所有组件都有以下属性
| 属性名 | 类型 | 描述 | 注解 |
|---|---|---|---|
| id | String | 组件的唯一标示 | 保持整个页面唯一 |
| class | String | 组件的样式类 | 在对应的 CSS 中定义的样式类 |
| style | String | 组件的内联样式 | 可以动态设置的内联样式 |
| hidden | Boolean | 组件是否显示 | 所有组件默认显示 |
| data-* | Any | 自定义属性 | 组件上触发的事件时，会发送给事件处理函数 |
| bind* / catch* | EventHandler | 组件的事件 详见事件 |
特殊属性
几乎所有组件都有各自定义的属性，可以对该组件的功能或样式进行修饰，请参考各个组件的定义。
API
快手小程序给开发者提供了丰富的 API，方便开发者调起原生方法，具体见 API 文档。
事件监听 API
以 on 开头的 API 用来监听某个事件是否触发。
例如：ks.onAppShow ks.onAppHide
同步 API
以 Sync 结尾的 API 都是同步 API。
例如：ks.getSystemInfoSync ks.setStorageSync
异步 API
其余大多数 API 都是异步 API。 例如：ks.request ks.downloadFile 。这类 API 接口通常都接受一个 Object 类型的参数，这个参数都支持按需指定以下字段来接收接口调用结果：
Object 参数说明
| 参数名 | 类型 | 必填 | 说明 |
|---|---|---|---|
| success | function | 否 | 接口调用成功的回调函数 |
| fail | function | 否 | 接口调用失败的回调函数 |
| complete | function | 否 | 接口调用结束的回调函数（调用成功、失败都会执行） |
| 其他 | Any | 接口定义的其他参数 |
回调函数的参数
success，fail，complete 函数调用时会传入一个 Object 类型参数，包含以下字段：
| 属性 | 类型 | 说明 |
|---|---|---|
| errMsg | string | 错误信息，如果调用成功返回 ${apiName}:ok |
| errCode | number | 错误码，仅部分 API 支持，具体含义请参考对应 API 文档，成功时为 0。 |
| 其他 | Any | 接口返回的其他数据 |
代码示例
ks.login({
success(res) {
console.log(res.code)
}
})
// callback 形式调用
ks.chooseImage({
success(res) {
console.log('res:', res)
}
})
// promise 形式调用
ks.chooseImage().then(res => console.log('res: ', res))
