Skip to content
体验新版
项目
组织
正在加载...
登录
切换导航
打开侧边栏
OpenHarmony
Docs
提交
c98e1a8b
D
Docs
项目概览
OpenHarmony
/
Docs
12 个月 前同步成功
通知
159
Star
292
Fork
28
代码
文件
提交
分支
Tags
贡献者
分支图
Diff
Issue
0
列表
看板
标记
里程碑
合并请求
0
Wiki
0
Wiki
分析
仓库
DevOps
项目成员
Pages
D
Docs
项目概览
项目概览
详情
发布
仓库
仓库
文件
提交
分支
标签
贡献者
分支图
比较
Issue
0
Issue
0
列表
看板
标记
里程碑
合并请求
0
合并请求
0
Pages
分析
分析
仓库分析
DevOps
Wiki
0
Wiki
成员
成员
收起侧边栏
关闭侧边栏
动态
分支图
创建新Issue
提交
Issue看板
体验新版 GitCode,发现更多精彩内容 >>
提交
c98e1a8b
编写于
9月 16, 2022
作者:
T
tianyu
浏览文件
操作
浏览文件
下载
电子邮件补丁
差异文件
update vod
Signed-off-by:
N
tianyu
<
tianyu55@h-partners.com
>
上级
f7bf1991
变更
11
显示空白变更内容
内联
并排
Showing
11 changed file
with
76 addition
and
53 deletion
+76
-53
zh-cn/application-dev/reference/arkui-js/figures/EventParameters.gif
...cation-dev/reference/arkui-js/figures/EventParameters.gif
+0
-0
zh-cn/application-dev/reference/arkui-js/js-components-custom-event-parameter.md
...eference/arkui-js/js-components-custom-event-parameter.md
+3
-0
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-patternlock.md
...dev/reference/arkui-ts/ts-basic-components-patternlock.md
+6
-2
zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md
...application-dev/reference/arkui-ts/ts-container-scroll.md
+2
-2
zh-cn/application-dev/reference/arkui-ts/ts-gesture-settings.md
...application-dev/reference/arkui-ts/ts-gesture-settings.md
+3
-3
zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md
...ation-dev/reference/arkui-ts/ts-universal-events-click.md
+8
-8
zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md
...ation-dev/reference/arkui-ts/ts-universal-events-touch.md
+17
-17
zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md
...lication-dev/reference/arkui-ts/ts-universal-mouse-key.md
+3
-3
zh-cn/application-dev/ui/js-framework-syntax-hml.md
zh-cn/application-dev/ui/js-framework-syntax-hml.md
+3
-1
zh-cn/application-dev/ui/ts-application-states-appstorage.md
zh-cn/application-dev/ui/ts-application-states-appstorage.md
+29
-15
zh-cn/application-dev/ui/ts-custom-component-lifecycle-callbacks.md
...ication-dev/ui/ts-custom-component-lifecycle-callbacks.md
+2
-2
未找到文件。
zh-cn/application-dev/reference/arkui-js/figures/EventParameters.gif
0 → 100644
浏览文件 @
c98e1a8b
9.5 KB
zh-cn/application-dev/reference/arkui-js/js-components-custom-event-parameter.md
浏览文件 @
c98e1a8b
...
@@ -28,6 +28,7 @@ export default {
...
@@ -28,6 +28,7 @@ export default {
```
html
```
html
<!-- xxx.hml -->
<!-- xxx.hml -->
<element
name=
'comp'
src=
'../../common/comp/comp.hml'
></element>
<div
class=
"container"
>
<div
class=
"container"
>
<text>
父组件:{{text}}
</text>
<text>
父组件:{{text}}
</text>
<comp
@
event-type1=
"textClicked"
></comp>
<comp
@
event-type1=
"textClicked"
></comp>
...
@@ -46,3 +47,5 @@ export default {
...
@@ -46,3 +47,5 @@ export default {
},
},
}
}
```
```
![
EventParameters
](
figures/EventParameters.gif
)
\ No newline at end of file
zh-cn/application-dev/reference/arkui-ts/ts-basic-components-patternlock.md
浏览文件 @
c98e1a8b
...
@@ -80,12 +80,16 @@ struct PatternLockExample {
...
@@ -80,12 +80,16 @@ struct PatternLockExample {
.
backgroundColor
(
Color
.
White
)
.
backgroundColor
(
Color
.
White
)
.
autoReset
(
true
)
.
autoReset
(
true
)
.
onPatternComplete
((
input
:
Array
<
number
>
)
=>
{
.
onPatternComplete
((
input
:
Array
<
number
>
)
=>
{
if
(
input
==
null
||
input
==
undefined
||
input
.
length
<
5
)
{
// 判断输出的密码格式
if
(
input
===
null
||
input
===
undefined
||
input
.
length
<
5
)
{
this
.
message
=
'
The password length needs to be greater than 5.
'
this
.
message
=
'
The password length needs to be greater than 5.
'
// 重新触发该回调
return
return
}
}
// 判断密码长度是否大于0
if
(
this
.
passwords
.
length
>
0
)
{
if
(
this
.
passwords
.
length
>
0
)
{
if
(
this
.
passwords
.
toString
()
==
input
.
toString
())
{
// 判断俩次输入的密码是否相等
if
(
this
.
passwords
.
toString
()
===
input
.
toString
())
{
this
.
passwords
=
input
this
.
passwords
=
input
this
.
message
=
'
Set password successfully:
'
+
this
.
passwords
.
toString
()
this
.
message
=
'
Set password successfully:
'
+
this
.
passwords
.
toString
()
}
else
{
}
else
{
...
...
zh-cn/application-dev/reference/arkui-ts/ts-container-scroll.md
浏览文件 @
c98e1a8b
...
@@ -23,7 +23,7 @@ Scroll(scroller?: Scroller)
...
@@ -23,7 +23,7 @@ Scroll(scroller?: Scroller)
| 名称 | 参数类型 | 描述 |
| 名称 | 参数类型 | 描述 |
| -------------- | ---------------------------------------- | --------- |
| -------------- | ---------------------------------------- | --------- |
| scrollable | ScrollDirection | 设置滚动方
法
。
<br/>
默认值:ScrollDirection.Vertical |
| scrollable | ScrollDirection | 设置滚动方
向
。
<br/>
默认值:ScrollDirection.Vertical |
| scrollBar |
[
BarState
](
ts-appendix-enums.md#barstate
)
| 设置滚动条状态。
<br/>
默认值:BarState.Off |
| scrollBar |
[
BarState
](
ts-appendix-enums.md#barstate
)
| 设置滚动条状态。
<br/>
默认值:BarState.Off |
| scrollBarColor | string
\|
number
\|
Color | 设置滚动条的颜色。 |
| scrollBarColor | string
\|
number
\|
Color | 设置滚动条的颜色。 |
| scrollBarWidth | string
\|
number | 设置滚动条的宽度。 |
| scrollBarWidth | string
\|
number | 设置滚动条的宽度。 |
...
@@ -147,7 +147,7 @@ scrollToIndex(value: number): void
...
@@ -147,7 +147,7 @@ scrollToIndex(value: number): void
| value | number | 是 | 要滑动到的列表项在列表中的索引值。 |
| value | number | 是 | 要滑动到的列表项在列表中的索引值。 |
### scrollBy
### scrollBy
<sup>9+</sup>
scrollBy(dx: Length, dy: Length): void
scrollBy(dx: Length, dy: Length): void
...
...
zh-cn/application-dev/reference/arkui-ts/ts-gesture-settings.md
浏览文件 @
c98e1a8b
...
@@ -55,7 +55,7 @@
...
@@ -55,7 +55,7 @@
-
GestureEvent对象说明
-
GestureEvent对象说明
| 名称 | 类型 | 描述 |
| 名称 | 类型 | 描述 |
| -------- | -------- | -------- |
| -------- | -------- | -------- |
| timestamp
<sup>
8+
</sup>
| number | 事件时间戳。 |
| timestamp
<sup>
8+
</sup>
| number | 事件时间戳。
触发事件时距离系统启动的时间间隔,单位纳秒。
|
| target
<sup>
8+
</sup>
|
[
EventTarget
](
ts-universal-events-click.md
)
| 触发手势事件的元素对象显示区域。 |
| target
<sup>
8+
</sup>
|
[
EventTarget
](
ts-universal-events-click.md
)
| 触发手势事件的元素对象显示区域。 |
| source
<sup>
8+
</sup>
| SourceType | 事件输入设备。 |
| source
<sup>
8+
</sup>
| SourceType | 事件输入设备。 |
| repeat | boolean | 是否为重复触发事件,用于LongPressGesture手势触发场景。 |
| repeat | boolean | 是否为重复触发事件,用于LongPressGesture手势触发场景。 |
...
@@ -79,8 +79,8 @@
...
@@ -79,8 +79,8 @@
| 名称 | 类型 | 描述 |
| 名称 | 类型 | 描述 |
| -------- | -------- | -------- |
| -------- | -------- | -------- |
| id | number | 手指的索引编号。 |
| id | number | 手指的索引编号。 |
| globalX | number | 相对于
设备屏幕
左上角的x轴坐标。 |
| globalX | number | 相对于
应用窗口
左上角的x轴坐标。 |
| globalY | number | 相对于
设备屏幕
左上角的y轴坐标。 |
| globalY | number | 相对于
应用窗口
左上角的y轴坐标。 |
| localX | number | 相对于当前组件元素左上角的x轴坐标。 |
| localX | number | 相对于当前组件元素左上角的x轴坐标。 |
| localY | number | 相对于当前组件元素左上角的y轴坐标。 |
| localY | number | 相对于当前组件元素左上角的y轴坐标。 |
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-events-click.md
浏览文件 @
c98e1a8b
...
@@ -15,13 +15,13 @@
...
@@ -15,13 +15,13 @@
## ClickEvent对象说明
## ClickEvent对象说明
| 属性名称 | 类型 | 描述 |
| 属性名称 | 类型 | 描述 |
| ------------------- | --------------------------------
|
------------------- |
| ------------------- | --------------------------------
---- | -------------------------------------
------------------- |
| screenX | number
| 点击点相对于设备屏幕左边沿的X坐标。
|
| screenX | number
| 点击点相对于应用窗口左上角的X坐标。
|
| screenY | number
| 点击点相对于设备屏幕上边沿的Y坐标。
|
| screenY | number
| 点击点相对于应用窗口左上角的Y坐标。
|
| x | number
| 点击点相对于被点击元素左边沿的X坐标。
|
| x | number
| 点击点相对于被点击元素左上角的X坐标。
|
| y | number
| 点击点相对于被点击元素上边沿的Y坐标。
|
| y | number
| 点击点相对于被点击元素左上角的Y坐标。
|
| target
<sup>
8+
</sup>
|
[
EventTarget
](
#eventtarget8对象说明
)
| 被点击元素对象。 |
| target
<sup>
8+
</sup>
|
[
EventTarget
](
#eventtarget8对象说明
)
| 被点击元素对象。 |
| timestamp | number
| 事件时间戳。
|
| timestamp | number
| 事件时间戳。触发事件时距离系统启动的时间间隔,单位纳秒。
|
## EventTarget<sup>8+</sup>对象说明
## EventTarget<sup>8+</sup>对象说明
| 名称 | 参数类型 | 描述 |
| 名称 | 参数类型 | 描述 |
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-events-touch.md
浏览文件 @
c98e1a8b
...
@@ -16,27 +16,27 @@
...
@@ -16,27 +16,27 @@
## TouchEvent对象说明
## TouchEvent对象说明
| 名称 | 类型 | 描述 |
| 名称 | 类型 | 描述 |
| ------------------- | ---------------------------------------- | ------------ |
| ------------------- | ---------------------------------------- | ------------ |
| type |
[
TouchType
](
ts-appendix-enums.md#touchtype
)
| 触摸事件的类型。 |
| type |
[
TouchType
](
ts-appendix-enums.md#touchtype
)
| 触摸事件的类型。 |
| touches | Array
<
[TouchObject](#touchobject对象说明)
>
| 全部手指信息。 |
| touches | Array
<
[TouchObject](#touchobject对象说明)
>
| 全部手指信息。 |
| changedTouches | Array
<
[TouchObject](#touchobject对象说明)
>
| 当前发生变化的手指信息。 |
| changedTouches | Array
<
[TouchObject](#touchobject对象说明)
>
| 当前发生变化的手指信息。 |
| stopPropagation | () => void | 阻塞事件冒泡。 |
| stopPropagation | () => void | 阻塞事件冒泡。 |
| timestamp
<sup>
8+
</sup>
| number | 事件时间戳
。 |
| timestamp
<sup>
8+
</sup>
| number | 事件时间戳。触发事件时距离系统启动的时间间隔,单位纳秒
。 |
| target
<sup>
8+
</sup>
|
[
EventTarget
](
ts-universal-events-click.md
)
| 触发手势事件的元素对象显示区域。 |
| target
<sup>
8+
</sup>
|
[
EventTarget
](
ts-universal-events-click.md
)
| 触发手势事件的元素对象显示区域。 |
| source
<sup>
8+
</sup>
|
[
SourceType
](
ts-gesture-settings.md
)
| 事件输入设备。 |
| source
<sup>
8+
</sup>
|
[
SourceType
](
ts-gesture-settings.md
)
| 事件输入设备。 |
## TouchObject对象说明
## TouchObject对象说明
| 名称 | 类型 | 描述 |
| 名称 | 类型 | 描述 |
| ------- | ---------------------------
|
------------------- |
| ------- | ---------------------------
---------------- | ------------------
------------------- |
| type |
[
TouchType
](
ts-appendix-enums.md#touchtype
)
| 触摸事件的类型。 |
| type |
[
TouchType
](
ts-appendix-enums.md#touchtype
)
| 触摸事件的类型。 |
| id | number | 手指唯一标识符。 |
| id | number | 手指唯一标识符。 |
| screenX | number
| 触摸点相对于设备屏幕左边沿的X坐标。
|
| screenX | number
| 触摸点相对于应用窗口左上角的X坐标。
|
| screenY | number
| 触摸点相对于设备屏幕上边沿的Y坐标。
|
| screenY | number
| 触摸点相对于应用窗口左上角的Y坐标。
|
| x | number
| 触摸点相对于被触摸元素左边沿
的X坐标。 |
| x | number
| 触摸点相对于被触摸元素左上角
的X坐标。 |
| y | number
| 触摸点相对于被触摸元素上边沿
的Y坐标。 |
| y | number
| 触摸点相对于被触摸元素左上角
的Y坐标。 |
## 示例
## 示例
...
...
zh-cn/application-dev/reference/arkui-ts/ts-universal-mouse-key.md
浏览文件 @
c98e1a8b
...
@@ -19,14 +19,14 @@
...
@@ -19,14 +19,14 @@
| 名称 | 属性类型 | 描述 |
| 名称 | 属性类型 | 描述 |
| --------- | ------------------------------- | -------------------- |
| --------- | ------------------------------- | -------------------- |
| screenX | number | 点击触点相对于
屏幕左上角的x轴坐标。
|
| screenX | number | 点击触点相对于
应用窗口左上角的x轴坐标。
|
| screenY | number | 点击触点相对于
屏幕左上角的y轴坐标。
|
| screenY | number | 点击触点相对于
应用窗口左上角的y轴坐标。
|
| x | number | 点击触点相对于当前组件左上角的x轴坐标。 |
| x | number | 点击触点相对于当前组件左上角的x轴坐标。 |
| y | number | 点击触点相对于当前组件左上角的y轴坐标。 |
| y | number | 点击触点相对于当前组件左上角的y轴坐标。 |
| button |
[
MouseButton
](
ts-appendix-enums.md#mousebutton
)
| 鼠标按键。 |
| button |
[
MouseButton
](
ts-appendix-enums.md#mousebutton
)
| 鼠标按键。 |
| action |
[
MouseAction
](
ts-appendix-enums.md#mouseaction
)
| 事件动作。 |
| action |
[
MouseAction
](
ts-appendix-enums.md#mouseaction
)
| 事件动作。 |
| stopPropagation | () => void | 阻塞事件冒泡。 |
| stopPropagation | () => void | 阻塞事件冒泡。 |
| timestamp
<sup>
8+
</sup>
| number | 事件时间戳。
|
| timestamp
<sup>
8+
</sup>
| number | 事件时间戳。
触发事件时距离系统启动的时间间隔,单位纳秒。
|
| target
<sup>
8+
</sup>
|
[
EventTarget
](
ts-universal-events-click.md
)
| 触发手势事件的元素对象显示区域。 |
| target
<sup>
8+
</sup>
|
[
EventTarget
](
ts-universal-events-click.md
)
| 触发手势事件的元素对象显示区域。 |
| source
<sup>
8+
</sup>
|
[
SourceType
](
ts-gesture-settings.md
)
| 事件输入设备。 |
| source
<sup>
8+
</sup>
|
[
SourceType
](
ts-gesture-settings.md
)
| 事件输入设备。 |
...
...
zh-cn/application-dev/ui/js-framework-syntax-hml.md
浏览文件 @
c98e1a8b
...
@@ -136,8 +136,10 @@ export default {
...
@@ -136,8 +136,10 @@ export default {
-
绑定并阻止冒泡事件向上冒泡:grab:{event}.bubble。grab:{event}等价于grab:{event}.bubble。
-
绑定并阻止冒泡事件向上冒泡:grab:{event}.bubble。grab:{event}等价于grab:{event}.bubble。
> **说明:**
> **说明:**
>
> 冒泡事件是指多个组件嵌套时,组件之间会有层次关系,当这些组件注册了相同的事件时,这个事件会首先运行在该元素上的处理程序,然后运行其父元素上的处理程序,一直向上到其他祖先上的处理程序。如果当一个组件触发了这个事件,它会首先触发该组件的回调函数,然后触发其父元素上的回调函数,然后触发其他祖先上的处理程序。
>
> 详细冒泡事件说明参见[通用事件](../reference/arkui-js/js-components-common-events.md)章节。
> 详细冒泡事件说明参见[通用事件](../reference/arkui-js/js-components-common-events.md)章节。
-
示例
-
示例
```
html
```
html
<!-- xxx.hml -->
<!-- xxx.hml -->
...
...
zh-cn/application-dev/ui/ts-application-states-appstorage.md
浏览文件 @
c98e1a8b
...
@@ -64,8 +64,8 @@ struct ComponentA {
...
@@ -64,8 +64,8 @@ struct ComponentA {
}
}
build
()
{
build
()
{
Column
(){
Row
({
space
:
20
})
{
Row
({
space
:
20
})
{
Button
(
`
${
this
.
label
}
:
${
this
.
varA
}
`
)
Button
(
`
${
this
.
label
}
:
${
this
.
varA
}
`
)
.
onClick
(()
=>
{
.
onClick
(()
=>
{
AppStorage
.
Set
<
number
>
(
'
varA
'
,
AppStorage
.
Get
<
number
>
(
'
varA
'
)
+
1
)
AppStorage
.
Set
<
number
>
(
'
varA
'
,
AppStorage
.
Get
<
number
>
(
'
varA
'
)
+
1
)
...
@@ -80,6 +80,20 @@ struct ComponentA {
...
@@ -80,6 +80,20 @@ struct ComponentA {
this
.
label
=
(
this
.
lang
===
'
zh
'
)
?
'
数
'
:
'
Count
'
this
.
label
=
(
this
.
lang
===
'
zh
'
)
?
'
数
'
:
'
Count
'
})
})
}
}
.
margin
({
bottom
:
50
})
Row
(){
Button
(
`更改@StorageLink修饰的变量:
${
this
.
varA
}
`
).
fontSize
(
10
)
.
onClick
(()
=>
{
this
.
varA
++
})
}.
margin
({
bottom
:
50
})
Row
(){
Button
(
`更改@StorageProp修饰的变量:
${
this
.
lang
}
`
).
fontSize
(
10
)
.
onClick
(()
=>
{
this
.
lang
=
'
test
'
})
}
}
}
}
}
}
```
```
...
...
zh-cn/application-dev/ui/ts-custom-component-lifecycle-callbacks.md
浏览文件 @
c98e1a8b
...
@@ -9,8 +9,8 @@
...
@@ -9,8 +9,8 @@
| ---------------- | ------------------------------------------------------------ |
| ---------------- | ------------------------------------------------------------ |
| aboutToAppear | 函数在创建自定义组件的新实例后,在执行其build函数之前执行。允许在aboutToAppear函数中改变状态变量,更改将在后续执行build函数中生效。 |
| aboutToAppear | 函数在创建自定义组件的新实例后,在执行其build函数之前执行。允许在aboutToAppear函数中改变状态变量,更改将在后续执行build函数中生效。 |
| aboutToDisappear | 函数在自定义组件析构销毁之前执行。不允许在aboutToDisappear函数中改变状态变量,特别是@Link变量的修改可能会导致应用程序行为不稳定。 |
| aboutToDisappear | 函数在自定义组件析构销毁之前执行。不允许在aboutToDisappear函数中改变状态变量,特别是@Link变量的修改可能会导致应用程序行为不稳定。 |
| onPageShow | 页面显示时触发一次,包括路由过程、应用进入前后台等场景,仅@Entry修饰的自定义组件生效。 |
| onPageShow | 页面
每次
显示时触发一次,包括路由过程、应用进入前后台等场景,仅@Entry修饰的自定义组件生效。 |
| onPageHide | 页面
消失
时触发一次,包括路由过程、应用进入前后台等场景,仅@Entry修饰的自定义组件生效。 |
| onPageHide | 页面
每次隐藏
时触发一次,包括路由过程、应用进入前后台等场景,仅@Entry修饰的自定义组件生效。 |
| onBackPress | 当用户点击返回按钮时触发,仅
\@
Entry修饰的自定义组件生效。
<br/>
-
返回true表示页面自己处理返回逻辑,
不进行页面路由。
<br/>
-
返回false表示使用默认的返回逻辑。
<br/>
-
不返回值会作为false处理。 |
| onBackPress | 当用户点击返回按钮时触发,仅
\@
Entry修饰的自定义组件生效。
<br/>
-
返回true表示页面自己处理返回逻辑,
不进行页面路由。
<br/>
-
返回false表示使用默认的返回逻辑。
<br/>
-
不返回值会作为false处理。 |
...
...
编辑
预览
Markdown
is supported
0%
请重试
或
添加新附件
.
添加附件
取消
You are about to add
0
people
to the discussion. Proceed with caution.
先完成此消息的编辑!
取消
想要评论请
注册
或
登录