MD原文件 https://github.com/poetries/poetries.github.io/blob/dev/source/_posts/quick-app-summary.md
一、环境搭建
1.1 安装nodeJS
需安装
6.0以上版本的nodeJS
1.2 安装hap-toolkit
1 | // hap -V // 会显示安装版本信息 |
1.3 创建项目工程
1 | hap init projectName |
生成的目录结构
1 | ├── sign rpk //包签名模块 |
src:项目源文件夹sign:签名模块,当前仅有debug签名,如果内测上线,请添加release文件夹,增加线上签名;签名生成方法详见文档编译工具
编译项目
npm run release# 发布程序包,在/dist/.signed.rpk,注意需要使用release签名模块npm run build# 生成build和dist两个目录。前者是临时产出,后者是最终产出npm run watch# 文件保存时自动编译和调试
手动编译项目
在项目的根目录下,运行如下命令进行编译打包,生成rpk包
1 | npm run build |
- 编译打包成功后,项目根目录下会生成文件夹:
build、dist build:临时产出,包含编译后的页面js,图片等dist:最终产出,包含rpk文件。其实是将build目录下的资源打包压缩为一个文件,后缀名为rpk,这个rpk文件就是项目编译后的最终产出
自动编译项目
- 每次修改源代码文件后,都自动编译项目
1 | npm run watch |
在安卓手机上安装调试工具

1.4 连接手机进行调试
注意:一定要注意手机连接的wifi与电脑所连接的网络需要在同一局域网和网段,需要能够相互访问。
- 在项目根目录下执行如下命令,启动HTTP调试服务器:(
server前需要先npm run build)
1 | npm run server |
- 开发者可以通过命令行终端或者调试服务器主页看到提供扫描的二维码
- 开发者通过快应用调试器扫码安装按钮,扫码安装待调试的
rpk文件 - 开发者点击快应用调试器中的开始调试按钮,开始调试
打开之前安装的快应用调试助手扫描即可预览

扫描二维码之后点击开始调试,会调出devtool工具本地调试


1.5 安装Hap Extension
启动Visual Studio Code,打开项目,点击左上侧扩展,搜索hap,点击安装Hap Extension
二、快应用结构分析
2.1 文件组织
一个应用包含:描述项目配置信息的
manifest文件,放置项目公共资源脚本的app.ux文件,多个描述页面/自定义组件的ux文件
1 | ├── manifest.json |
其中
Common目录下为公用的资源文件和组件文件,每个页面目录下存放各自页面私有的资源文件和组件文件,如:图片,CSS,JS等
2.2 源码文件
APP,页面和自定义组件均通过ux文件编写,ux文件由template模板、style样式和script脚本3个部分组成,一个典型的页面ux文件示例如下
1 | <template> |
2.3 manifest配置
1 | { |
package应用包名,确认与原生应用的包名不一致,推荐采用com.company.module的格式,如:com.example.demoname应用名称,6个汉字以内,与应用商店保存的名称一致,用于在桌面图标、弹窗等处显示应用名称icon应用图标,提供192x192大小的即可versionName应用版本名称,如:"1.0"versionCode应用版本号,从1自增,推荐每次重新上传包时versionCode+1minPlatformVersion支持的最小平台版本号,兼容性检查,避免上线后在低版本平台运行并导致不兼容;如果不填按照内测版本处理features接口列表,绝大部分接口都需要在这里声明,否则不能调用,详见每个接口的文档说明config系统配置logLevel:打印日志等级,分为off,error,warn,info,log,debugdesignWidth:页面设计基准宽度,根据实际设备宽度来缩放元素大小
router路由信息entry:首页名称pages:页面配置列表,key值为页面名称(对应页面目录名,例如Hello对应’Hello’目录),value为页面详细配置page,详见下面说明router.page用于定义单个页面路由信息component: 页面对应的组件名,与ux文件名保持一致,例如'hello'对应'hello.ux'path页面路径,例如“/user”,不填则默认为/<页面名称>。path必须唯一,不能和其他page的path相同。下面page的path因为缺失,会被设置为“/Index”:"Index":{"component": "index"}filter: 声明页面可以处理某种请求
display UI显示相关配置backgroundColor窗口背景颜色fullScreen是否是全屏模式,默认不会同时作用于titleBar,titleBar需要继续通过titleBar控制titleBar是否显示titleBartitleBarBackgroundColor标题栏背景色titleBarTextColor标题栏文字颜色titleBarText标题栏文字(也可通过页面跳转传递参数(titleBarText)设置)menu是否显示标题栏右上角菜单按钮pages各个页面的显示样式,key为页面名(与路由中的页面名保持一致),value为窗口显示
2.4 app.ux
当前
app.ux编译后会包含manifest配置信息(可以在npm run build之后查看文件内容),所以请不要删除/**manifest**/的注释内容标识
- 您可以在
中引入一些公共的脚本,并暴露在当前app的对象上,如下所示,然后就可以在页面ux文件的ViewModel中,通过this.$app.util访问
2.5 style样式
- 样式布局采用
CSS Flexbox(弹性盒)样式
支持2种导入外部文件的方式
1 |
|
模板内部样式
1 |
|
样式预编译
目前支持less, sass的预编译
1 |
|
1 | <script> |
2.6 template模板
1 |
|
2.7 script脚本
2.7.1 模块声明
可以通过
import引入功能模块,在代码中调用模块方法
1 | import fetch from "@system.fetch" |
也可以一次引入所有的模块,例如
1 | import system from "@system" |
- 在代码中使用
system.network来调用接口方法
2.7.2 对象
2.7.2.1 页面级组件
data(废弃)
- 页面级组件的数据模型,能够转换为
JSON对象 - 如果是函数,返回结果必须是对象,在组件初始化时会执行函数获取结果作为
data的值 - 使用
data方式声明的属性会被外部数据覆盖,因此存在一定安全风险,推荐使用下面的public,protected,rivate来声明属性(注意:它们不能与data同时声明)
public
页面级组件的数据模型,影响传入数据的覆盖机制:
public内定义的属性允许被传入的数据覆盖,如果外部传入数据的某个属性未被声明,在public中不会新增这个属性
protected
页面级组件的数据模型,影响传入数据的覆盖机制:protected内定义的属性,允许被应用内部页面请求传递的数据覆盖,不允许被应用外部请求传递的数据覆盖
private
页面级组件的数据模型,影响传入数据的覆盖机制:private内定义的属性不允许被覆盖
1 | export default { |
2.7.2.2 自定义组件
data
自定义组件的数据模型,能够转换为JSON对象;属性名不能以$或_开头, 不要使用for, if, show, tid等保留字
如果是函数,返回结果必须是对象,在组件初始化时会执行函数获取结果作为data的值
props
- 定义组件外部可传入的所有属性
- 在模板代码中,请使用短横线分隔命名代替驼峰命名。如,属性定义
props: ['propA'],可通过方式传递到组件内部
prop验证
在自定义组件中,可将props定义为带验证需求的对象。其中,key为属性名,value为属性对应的验证需求。验证失败则输出错误提示日志,增加prop验证有利于规范自定义组件的使用
| 属性 | 类型 | 描述 |
|---|---|---|
type |
- | 检查属性值的类型。支持单一类型和多种可能类型,可在原生和自定义构造函数中任意选择,单独或组合使用。原生构造函数:String Number Boolean Function Object Array Symbol |
default |
- | 设置属性的默认值 |
required |
Boolean |
设置属性是否必填 |
validator| Function| 设置自定义验证函数。若函数的返回值为真,则通过验证;否则验证失败|
1 | export default { |
2.7.2.3 公共对象
| 属性 | 类型 | 描述 |
|---|---|---|
$app |
Object |
应用对象 |
$page |
Object |
页面对象 |
$valid |
Boolean |
页面对象是否有效 |
$visible |
Boolean |
页面是否处于用户可见状态 |
2.7.2.4 应用对象
可通过
$app访问
| 属性 | 类型 | 描述 |
|---|---|---|
$def |
Object |
使用this.$app.$def获取在app.ux中暴露的对象 |
$data |
Object |
使用this.$app.$data获取在manifest.json的config.data中声明的全局数据 |
2.7.2.5 页面对象
可通过
$page访问
| 属性 | 类型 | 描述 |
|---|---|---|
action |
String |
获取打开当前页面的action。仅在当前页面是通过filter匹配的方式打开时有效,否则为undefined |
uri |
String |
获取打开当前页面的uri。仅在当前页面是通过filter匹配的方式打开时有效,否则为undefined |
2.7.3 方法
2.7.3.1 数据方法
| 属性 | 类型 | 参数 | 描述 |
|---|---|---|---|
$set |
Function |
key: String value: Any |
添加数据属性,用法:this.$set('key',value) this.$vm('id').$set('key',value) |
$delete |
Function |
key: String |
删除数据属性,用法:this.$delete('key') this.$vm('id').$delete('key') |
2.7.3.2 公共方法
| 属性 | 描述 |
|---|---|
$element |
获取指定id的组件dom对象,如果没有指定id,则返回根组件dom对象用法: this.$element('xxx') 获取id为xxx的div组件实例对象 this.$element() 获取根组件实例对象 |
$root |
获取顶层ViewModel |
$parent |
获取父亲ViewModel |
$child |
获取指定id的自定义组件的ViewModel用法:this.$child('xxx') 获取id为xxx的div组件ViewModel |
$vm deprecated |
请使用上面this.$child('xxx')替代 |
$rootElement deprecated |
请使用上面this.$element()替代 |
$forceUpdate |
更新ViewModel数据,可能会触发dom操作,如:创建节点、更新节点、删除节点等;这些dom操作不一定在数据更新时立即执行,而是在开发者的业务代码执行后触发;若开发者期望数据更新时立即执行相应的dom操作,可使用:this.$forceUpdate();一般不推荐使用 |
2.7.3.3 事件方法
| 属性 | 参数 | 描述 |
|---|---|---|
$on |
type: String 事件名 handler: Function事件句柄函数 |
添加事件处理句柄用法:this.$on('xxxx', this.fn) fn是在中定义的函数 |
$off |
type: String 事件名 handler: 事件句柄函数 |
删除事件处理句柄用法:this.$off('xxxx', this.fn) this.$off('xxx') 删除指定事件的所有处理句柄 |
$dispatch |
type: String 事件名 |
向上层组件发送事件通知用法:this.$dispatch('xxx')正常情况下,会一直向上传递事件(冒泡)如果要停止冒泡,在事件句柄函数中调用evt.stop()即可 |
$broadcast |
type: String 事件名 |
向子组件发送事件通知用法:this.$broadcast('xxx')正常情况下,会一直向下传递事件如果要停止传递,在事件句柄函数中调用evt.stop()即可 |
$emit |
type: String 事件名 data: Object 事件参数 |
触发事件,对应的句柄函数被调用用法:this.$emit('xxx') this.$emit('xxx', {a:1})传递的事件参数可在事件回调函数中,通过evt.detail来访问,例如evt.detail.a |
$emitElement |
type: String 事件名data: Object 事件参数 id: String 组件id (默认为-1 代表根元素) |
触发组件事件,对应的句柄函数被调用用法:this.$emitElement('xxx', null, 'id') this.$emitElement('xxx',{a:1})传递的事件参数可在事件回调函数中,通过evt.detail来访问,例如evt.detail.a |
$watch |
data: String 属性名, 支持'a.b.c'格式,不支持数组索引 handler: String 事件句柄函数名,函数的第一个参数为新的属性值,第二个参数为旧的属性值 |
动态添加属性/事件绑定,属性必须在data中定义,handler函数必须在定义;当属性值发生变化时事件才被触发用法:this.$watch('a','handler') |
2.7.3.4 应用方法
可通过$app访问
| 属性 | 描述 |
|---|---|
| exit | 退出快应用,结束应用生命周期。 调用方法: this.$app.exit() |
2.7.3.5 页面方法
可通过
$page访问
| 属性 | 参数 | 描述 |
|---|---|---|
setTitleBar |
text: String 标题栏文字 textColor: String 文字颜色 backgroundColor: String 背景颜色 backgroundOpacity : Number背景透明度 menu : Boolean 是否在标题栏右上角显示菜单按钮 |
设置当前页面的标题栏用法:this.$page.setTitleBar({text:'Hello', textColor:'#FF0000', backgroundColor:'#FFFFFF', backgroundOpacity:0.5, menu: true}) |
finish |
无 | 从本页面退出,结束页面生命周期。调用方法:this.$page.finish() |
2.8 指令
for
for指令用于循环输出一个数组类型的数据
- 自定义变量表示
for指令的数组索引和数组元素时,变量名不可以用$或_开头;
1 | <template> |
指令if与指令show
if条件指令,是指if/elif/else这3个相关指令,用于控制是否增加或者删除组件;show指令,是指是否显示组件,用于控制组件的显示状态,并不会从dom结构中删除
1 | <template> |
- 当
if/elif指令的值为false时,节点会从页面中移除,当if/elif指令值为true,组件会动态插入节点中; - 当
show指令的值为true时,节点可见, - 当其值为false时,组件不可见,但节点仍会保留在页面dom结构中
组件block
block组件是表达逻辑区块的组件,没有对应的Native组件。可以使用
实现更为灵活的”列表/条件渲染”。如在 上使用for指令和if指令
1 | <template> |
组件slot
slot节点用于向开发者额外开发的自定义ux组件中插入内容
- 通常自定义组件的模板中提供
slot组件,当该组件被引入到页面组件中后,开发者可以灵活定义该自定义组件内部的子内容
1 | //自定义组件part1.ux |
1 | //自定义组件使用者页面index.ux |
在子组件中使用
slot组件,使得子组件接纳调用者传入的子内容,从而动态渲染子组件,得到最终的页面
三、生命周期
3.1 APP的生命周期
当前为APP的生命周期提供了两个回调函数:
onCreate,onDestroy;可在app.ux中定义回调函数

1 | import { |
- 在
app.ux中,开发者可以做一些独立于页面的操作。比如:引入公共的JS资源,然后暴露给所有页面 - 在
app.ux中,通过this.$def访问app.ux中定义的数据和方法
1 | console.info(`获取:APP文件中的数据:${this.$def.data1.name}`) |
在
pageName.ux中,通过this.$app.$def访问app.ux中定义的数据和方法
1 | console.info(`获取:APP文件中的数据:${this.$app.$def.data1.name}`) |
关于$app与$app.$def
- 前者代表框架为开发者暴露提供的APP对象;后者代表开发者在
app.ux中导出的对象,放置业务相关的全局数据和方法 - 前者对象拥有
onCreate,onDestroy生命周期;当应用启动时会执行onCreate方法,里面执行this.variable1的赋值是在$app对象上 - 后者对象中的
onCreate,onDestroy方法并不会执行,作用仅仅只是把方法复制到前者对象上而已 - 这些全局方法在页面中:既可以通过
this.$app.method1()调用,也可以通过this.$app.$def.method1()调用;不同之处在于前者可以取到之前赋值的variable1变量,而后者不可以取到(因为之前的赋值是在$app对象上执行的)
3.2 页面生命周期

onInit()
表示ViewModel的数据已经准备好,可以开始使用页面中的数据
1 | private: { |
onReady()
表示ViewModel的模板已经编译完成,可以开始获取dom节点(如:this.$element(idxxx)
1 | onReady () { |
onShow(), onHide()
页面被切换隐藏时调用onHide(),页面被切换重新显示时调用onShow()
- 判断页面的显示状态,可以调用
ViewModel的$visible属性:true表示显示,false表示隐藏
1 | onShow () { |
onDestroy()
页面被销毁时调用,被销毁的可能原因有:用户从当前页面返回到上一页,或者用户打开了太多的页面,框架自动销毁掉部分页面,避免占用资源
- 所以,页面销毁时应该做一些释放资源的操作,如:取消接口订阅监听
geolocation.unsubscribe()
1 | onDestroy () { |
onBackPress()
当用户点击返回实体按键、左上角返回菜单、调用返回api时触发该事件
- 如果事件响应方法最后返回true表示不返回,自己处理业务逻辑(完毕后开发者自行调用api返回);否则:不返回数据,或者返回其它数据:表示遵循系统逻辑:返回到上一页
1 | onBackPress () { |
返回上一页的接口api:
router.back()
onMenuPress()
当使用原生的顶部标题栏时,可以通过manifest.json中的menu属性配置是否显示右上角的菜单
1 | onMenuPress () { |
A页面的生命周期接口的调用顺序
- 打开页面A:
onInit()->onReady()->onShow() - 在页面A打开页面B:
onHide() - 从页面B返回页面A:
onShow() - A页面返回:
onBackPress() -> onHide() -> onDestroy()
四、置顶对象
$app应用对象$app.$def获取在app.ux中暴露的对象$app.$data获取在manifest.json的config.data中声明的全局数据$page页面对象$page.action获取打开当前页面的action。仅在当前页面是通过filter匹配的方式打开时有效,否则为undefined。参见manifest$page.uri获取打开当前页面的uri。仅在当前页面是通过filter匹配的方式打开时有效,否则为undefined$page.setTitleBar设置页面标题$valid页面对象是否有效$visible页面是否处于用户可见状态
this.$page.setTitleBar参数属性包括
1 | { |
五、全局对象
$element获取指定id的组件dom对象,如果没有指定id,则返回根组件dom对象用法:this.$element('xxx')获取id为xxx的组件实例对象this.$element()获取根组件实例对象$root获取顶层ViewModel$parent获取父亲ViewModel$child获取指定id的自定义组件的ViewModel用法:this.$child('xxx')获取id为xxx的div组件ViewModel$vm(弃用) 请使用上面this.$child(‘xxx’)`替代$forceUpdate强制页面刷新$set添加数据属性,必须在onInit函数中使用,用法:this.$set('key',value)$delete删除数据属性,如果在onInit函数中使用,用法:this.$delete('key')
六、元素属性方法
注意,获取元素应该在页面已渲染后,如 onReady 事件中或 onReady 事件执行完以后
$set添加数据属性,用法:this.$vm('id').$set('key',value)$delete删除数据属性,用法:this.$vm('id').$delete('key')$on在当前页面注册监听事件, 可监听$emit()、$dispatch()、$broadcast()等触发的自定义事件,不能用于注册组件节点的事件响应$off移除事件监听,参数fnHandler为可选,传递仅移除指定的响应函数,不传递则移除此事件的所有监听$emit触发当前实例监听事件函数,与$on()配合使用
七、页面设计
布局和尺寸
- 采用
border-box模型且不支持box-sizing属性 - 目前仅支持长度单位
px和% - 设计稿1px / 设计稿基准宽度 = 框架样式1px / 项目配置基准宽度(项目配置基准宽度:
/src/manifest.json中config.designWidth的值,默认750)
CSS
- 可以使用内联样式、
tag选择器、class选择器、id选择器来为组件设置样式 - 仅可以使用并列选择、后代选择器、子代选择器
- 支持
@import引入外部样式、内联样式、行内样式 - 颜色值不支持缩写,伪类支持不完全(支持
:disabled,:checked,:focus等)
八、组件
支持样式 flex-direction, flex-wrap, justify-content, align-items, align-content 传递方法1 传递方法2 通过 接收参数 上述2种传递参数的方法,其接收方法一致,在接收参数页面的 回传参数 开发者可能会遇到需要在页面之间回传参数的需求 页面A实现代码如下 页面B实现代码如下: 会利用到一个构造函数 其中 父组件到子组件 子组件到父组件 配合 从传统网页调起需引入以下脚本 $on(evtName, fnHandler) 在当前页面注册监听事件, 可监听 $off(evtName, fnHandler) 移除事件监听,参数 fnHandler 为可选,传递仅移除指定的响应函数,不传递则移除此事件的所有监听 触发ViewModel事件 页面的交互中可能会遇到一些非手动触发的需求,$emit() 通过触发当前实例上的事件达到动态触发事件的行为 $emit(evtName, evtDetail) 监听原生组件事件 触发原生组件事件 通过 可以触发指定组件
: 气泡框
target 和 placementmask-colorvisibilitychange: 下拉刷新
offset和 refreshingbackground-color 和 progress-colorrefresh: 富文本编辑器
type(值为 html)div样式, height 无效
九、页面切换和参数传递
9.1 参数传递
1
2
3
4<a href="/src/home/index.html?key=2333">跳转页面a>
<a href="/PageParams/receiveparams?key={{title}}">携带参数key2跳转a>1
2// 导入模块
import router from '@system.router'
router 接口:router.push(), router.replace(), 接受一个如下结构的对象,用法这个和前端 router 一致。1
2
3
4{
url: '/src/home/index.html',
params: { key: 2333 /* 需要传递的参数 */ }
}
protected对象中获取即可(可设置默认值)1
2
3
4
5
6
7
8
9
10
11export default {
protected: {
key: ''
},
onInit () {
this.$page.setTitleBar({ text: '接收参数' })
// js中输出页面传递的参数
console.info('key: ' + this.key)
}
}
= 此时,组件a和接口router传参不能满足需求,可以借助于app级别的对象:this.$app.$data
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39<template>
<div class="tutorial-page">
<a href="/PageParams/returnParams/pageb">跳转到页面Ba>
<text>{{msg}}text>
div>
template>
<style>
.tutorial-page {
flex-direction: column;
justify-content: center;
align-items: center;
}
a {
margin-top: 75px;
font-size: 30px;
color: #09ba07;
text-decoration: underline;
}
style>
<script>
export default {
private: {
msg: ''
},
onInit () {
this.$page.setTitleBar({ text: '页面A' })
},
onShow () {
// 页面被切换显示时,从数据中检查是否有页面B传递来的数据
if (this.$app.$data.dataPageB && this.$app.$data.dataPageB.gotoPage === 'pageA') {
// 从数据中获取回传给本页面的数据
const data = this.$app.$data.dataPageB.params
this.msg = data.msg
}
}
}
script>1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38<template>
<div class="tutorial-page">
<text>页面Btext>
<input style="width: 450px;" placeholder="请输入回传给页面A的信息" onchange="updateMsg"/>
div>
template>
<style>
.tutorial-page {
flex-direction: column;
justify-content: center;
align-items: center;
}
style>
<script>
export default {
private: {
msg: ''
},
onInit () {
this.$page.setTitleBar({ text: '页面B' })
},
onHide () {
// 页面被切换隐藏时,将要传递的数据对象写入
this.$app.$data.dataPageB = {
gotoPage: 'pageA',
params: {
msg: this.msg
}
}
},
updateMsg (e) {
// 更新input输入的信息文本
this.msg = e.text
}
}
script>9.2 页面间通信
new BroadcastChannel(string), 它接受一个字符串参数,作为实例的频道名称。它的实例具有以下属性和方法
name 频道名称,区分不同的消息频道(注意:不同频道之间不可通信)。postMessage 用于在当前频道中广播消息onmessage 订阅消息。在频道中接收到广播消息之后,会给所有订阅者派发消息事件close 关闭当前的频道
onmessage 事件有2个属性(通过 event 对象访问)
type messagedata 接收到的消息内容十、组件通信
props 获取父组件传入的值,见上文 template 部分this.watch(props, callback) 监控传入数据变化并调用回调函数this.$broadcast()完成事件触发,子组件通过$on()绑定事件并响应
this.$dispatch()完成事件触发,父组件通过$on()绑定事件并响应this.$emit()触发在节点上绑定的事件来执行父组件的方法
this.$broadcast()、this.$emit() 和 this.$dispatch()参数一致event.detail来获取参数event.stop()来结束传递十一、Deeplink
标签框架支持通过链接从外部打开应用,格式1
2
3http://hapjs.org/app/
https://hapjs.org/app/
hap://app/
package: 应用包名,必选path: 应用内页面的path,可选,默认为首页key-value: 希望传给页面的参数,可选,可以有多个
1
十二、事件监听与触发
$on 用于监听自定义事件;$off移除对应的事件监听
$emit()、 $dispatch()、 $broadcast()等触发的自定义事件,不能用于注册组件节点的事件响应1
2
3
4
5
6
7
8
9export default {
onInit(){
this.$on('customEvtType1', this.customEvtType1Handler)
},
customEvtType1Handler(evt){
// 事件类型,事件参数
console.info(`触发事件:类型:${evt.type}, 参数: ${JSON.stringify(evt.detail)}`);
}
}
1
2
3
4
5
6
7
8export default {
removeEventHandler () {
// 不传递fnHandler:移除所有监听
this.$off('customEvtType1')
// 传递fnHandler:移除指定的监听函数
this.$off('customEvtType1', this.customEvtType1Handler)
}
}
$on() 配合使用$emit() 目前只触发 $on 所监听的事件1
2
3
4
5export default {
emitEvent () {
this.$emit('customEvtType1', { params: '参数内容' })
}
}
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33<template>
<div class="tutorial-page">
<text id="elnode1" class="{{ elClassName + 1 }}" disabled="false" onclick="onClickHandler">组件节点1text>
<text id="elnode2" class="class-static-1 {{ elClassName + 2 }}" onclick="onClickHandler2('参数1', argName)">组件节点2text>
div>
template>
<style lang="less">
.tutorial-page {
flex-direction: column;
}
style>
<script>
export default {
private: {
elClassName: 'class-dynamic',
argName: '动态参数'
},
onClickHandler (evt) {
// 事件类型,参数详情
console.info(`触发事件:类型:${evt.type}, 详情: ${JSON.stringify(evt.detail)}`);
if (evt.target) {
console.info(`触发事件:节点:${evt.target.id}, ${evt.target.attr.disabled}`)
}
},
onClickHandler2 (arg1, arg2, evt) {
// 事件类型,事件参数,target
console.info(`触发事件:类型:${evt.type}, 参数: ${arg1}, ${arg2}`);
}
}
script>
$emitElement()完成事件的动态触发
id的事件,通过evt.detail获取传递的参数;该方法对自定义组件无效1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38<template>
<div class="tutorial-page">
<text onclick="emitElement">触发组件节点的事件:clicktext>
<text id="elnode1" class="{{ elClassName + 1 }}" disabled="false" onclick="onClickHandler">组件节点1text>
<text id="elnode2" class="class-static-1 {{ elClassName + 2 }}" onclick="onClickHandler2('参数1', argName)">组件节点2text>
div>
template>
<style lang="less">
.tutorial-page {
flex-direction: column;
}
style>
<script>
export default {
private: {
elClassName: 'class-dynamic',
argName: '动态参数'
},
onClickHandler (evt) {
// 事件类型,参数详情
console.info(`触发事件:类型:${evt.type}, 详情: ${JSON.stringify(evt.detail)}`);
if (evt.target) {
console.info(`触发事件:节点:${evt.target.id}, ${evt.target.attr.disabled}`)
}
},
onClickHandler2 (arg1, arg2, evt) {
// 事件类型,事件参数,target
console.info(`触发事件:类型:${evt.type}, 参数: ${arg1}, ${arg2}`);
},
emitElement () {
// 注意:通过此类方式的事件不会携带target属性,开发者可以通过detail参数实现
this.$emitElement('click', { params: '参数内容' }, 'elnode1')
}
}
script>十三、一些问题
undefinedshow 属性并不好用,没起什么作用onInit 等等函数是页面生命周期,不是组件生命周期,不会因为组件状态变化而执行display类型只有 flex 和 noneborder-box十四、快应用开发资源