快手广告代理平台-基础组件

快手小程序为开发者提供了一系列基础组件，开发者可以通过组合这些基础组件进行快速开发。详细介绍请参考组件文档。

什么是组件：

组件是视图层的基本组成单元。

组件自带一些功能与快手风格一致的样式。

一个组件通常包括 开始标签 和 结束标签，属性 用来修饰这个组件，内容 在两个标签之内。

<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))