# 组件事件
事件系统是组件间交互的主要形式。自定义组件可以触发任意的事件,引用组件的页面可以监听这些事件。关于事件的基本概念和用法,参见 [事件](https://mp.weixin.qq.com/debug/wxadoc/dev/framework/view/wxml/event.html) 。
监听自定义组件事件的方法与监听基础组件事件的方法完全一致:
**代码示例:**
**组件**
*components/com/index.wxml*
```html
<view class="wrapper">
<button bind:tap="comTap">组件事件测试</button>
</view>
```
*components/com/index.js*
在 Components 中加入 `methods` ,将监听函数放到里面,就可以监听对应事件。
使用 `triggerEvent` 向父页面传递事件,第一个参数为事件名,第二个参数为要传递的数据,第三个参数为事件选项。
```js
Component({
methods: {
comTap () {
console.log('component tap')
let postData = {
a: 2,
b: 5
}
this.triggerEvent('comTap', postData, {
bubbles: false,
composed: false,
capturePhase: false
})
}
}
})
```
触发事件的选项包括:
| 选项名 | 类型 | 是否必填 | 默认值 | 描述 |
| ------------ | ------- | ---- | ----- | ---------------------------------------- |
| bubbles | Boolean | 否 | false | 事件是否冒泡 |
| composed | Boolean | 否 | false | 事件是否可以穿越组件边界,为false时,事件将只能在引用组件的节点树上触发,不进入其他任何组件内部 |
| capturePhase | Boolean | 否 | false | 事件是否拥有捕获阶段 |
关于冒泡和捕获阶段的概念,可以阅读 [事件](https://mp.weixin.qq.com/debug/wxadoc/dev/framework/view/wxml/event.html) 。
**引用组件的页面**
*pages/test/index.wxml*
直接将需要传递的值写到属性中,注意使用 {{}} 进行数据绑定。
```html
<view>
<componentTest
bind:comTap="componentTap"
>
</componentTest>
</view>
```
*pages/test/index.js*
```js
Page({
componentTap (e) {
console.log('page tap')
console.log(e)
console.log(e.detail)
}
})
```
可以看到控制台打印出 :
:-: ![](http://xiaoyulive.oss-cn-beijing.aliyuncs.com/imgs/weixin/008.jpg)
可以看到,由子组件传递的数据可以使用 `event.detail` 接收。
- 简介
- 第一章 公众号开发
- 使用微信JSSDK
- 接口权限配置
- 分享接口
- 隐藏按钮项
- 微信支付
- 第二章 小程序开发
- 基础知识
- 分包加载
- WXSS样式表
- 配置
- app.json配置
- window
- tabBar
- page.json配置
- 逻辑层
- app.js
- 场景值
- page.js
- 初始化数据
- 生命周期函数
- 页面相关事件处理函数
- 事件处理函数
- 页面实例方法
- 路由
- 文件作用域
- 模块化
- 视图层
- 模板语法
- 列表渲染
- 条件渲染
- 模板
- 事件
- 引用
- WXS语法规范
- WXS数据类型
- WXS控制流程
- WXS基础类库
- 组件
- 视图容器
- view
- scroll-view
- swiper
- movable-view
- cover-view
- 基础组件
- icon
- text
- rich-text
- progress
- 表单组件
- button
- checkbox
- form
- input
- label
- picker
- picker-view
- radio
- slider
- switch
- textarea
- 导航组件
- navigator
- 媒体组件
- audio
- image
- video
- camera
- 地图组件
- map
- 画布组件
- canvas
- 开放能力
- web-view
- 自定义组件
- 组件模版和样式
- Component
- 组件传值
- 组件事件
- Behaviors
- 组件间关系
- 网络请求
- wx.request
- 微信登录
- 获取 openid 和 unionid
- 获取用户信息
- 将 wx.request 封装为 promise
- 上传图片接口封装
- 数据存储
- 存储数据和读取数据
- 获取数据缓存信息
- 移除数据缓存
- 获取用户设置
- openSetting
- getSetting
- 第三章 小游戏开发
- 参考资料