addEventListener

监听事件,支持系统事件和自定义事件

addEventListener({params}, callback(ret, err))

params

name:

  • 类型:字符串
  • 默认值:无
  • 描述:自定义事件或系统事件名称(详见事件

extra:

  • 类型:JSON 对象
  • 默认值:无
  • 描述:(可选项)附加字段。一些特定事件可能需要提供额外的参数。
  • 内部字段:
  1. {
  2. threshold: //当事件为scrolltobottom时,设置距离底部多少距离时触发事件,默认值为0,数字类型
  3. timeout: //当事件为appidle时,设置经过多长时间不操作屏幕时触发,单位秒,数字类型
  4. }

callback(ret, err)

ret:

  • 类型:JSON 对象
  • 描述:事件发生时传递的参数,可能为空

示例代码

  1. //如监听网络连接事件
  2. api.addEventListener({
  3. name: 'online'
  4. }, function(ret, err) {
  5. alert('已连接网络');
  6. });

补充说明

监听事件

可用性

iOS系统,Android系统

可提供的1.0.0及更高版本