对README_zh.md进行规范性整改-applications_app

已合并

对README_zh.md进行规范性整改 #7726

tianlongdevcode创建于 2025年11月20日从tianlongdevcode/applications_app_samples_1253： question_fix_1120.001 合入到 openharmony/applications_app_samples： master

对README_zh.md进行规范性整改 #7726

已合并

tianlongdevcode创建于 2025年11月20日

从tianlongdevcode/applications_app_samples_1253 question_fix_1120.001合入到openharmony/applications_app_samples master

共 6 个文件变更+49-43

Mcode/DocsSample/ArkUISample/EventProject/README_zh.md+14-26

	@@ -6,12 +6,12 @@
6		6
7	1. [触屏事件](https://gitcode.com/openharmony/docs/blob/OpenHarmony-5.0.1-Release/zh-cn/application-dev/ui/arkts-common-events-touch-screen-event.md)	7	1. [触屏事件](https://gitcode.com/openharmony/docs/blob/OpenHarmony-5.0.1-Release/zh-cn/application-dev/ui/arkts-common-events-touch-screen-event.md)
8	2. [键鼠事件](https://gitcode.com/openharmony/docs/blob/OpenHarmony-5.0.1-Release/zh-cn/application-dev/ui/arkts-common-events-device-input-event.md)	8	2. [键鼠事件](https://gitcode.com/openharmony/docs/blob/OpenHarmony-5.0.1-Release/zh-cn/application-dev/ui/arkts-common-events-device-input-event.md)
9	-3. [焦点事件](https://gitcode.com/openharmony/docs/blob/OpenHarmony-5.0.1-Release/zh-cn/application-dev/ui/arkts-common-events-focus-event.md)	9	+3. [支持焦点处理](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/ui/arkts-common-events-focus-event.md)
10	-4. [拖拽事件](https://gitcode.com/openharmony/docs/blob/OpenHarmony-5.0.1-Release/zh-cn/application-dev/ui/arkts-common-events-drag-event.md)	10	+4. [支持统一拖拽](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/ui/arkts-common-events-drag-event.md)
11	-5. [单一手势](https://gitcode.com/openharmony/docs/blob/OpenHarmony-5.0.1-Release/zh-cn/application-dev/ui/arkts-gesture-events-single-gesture.md)	11	+5. [单一手势](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/ui/arkts-gesture-events-single-gesture.md)
12	-6. [组合手势](https://gitcode.com/openharmony/docs/blob/OpenHarmony-5.0.1-Release/zh-cn/application-dev/ui/arkts-gesture-events-combined-gestures.md)	12	+6. [组合手势](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/ui/arkts-gesture-events-combined-gestures.md)
13	-7. [手势拦截](https://gitcode.com/openharmony/docs/blob/OpenHarmony-5.0.1-Release/zh-cn/application-dev/ui/arkts-gesture-events-gesture-judge.md)	13	+7. [手势冲突处理](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/ui/arkts-gesture-events-gesture-judge.md)
14	-8. [统一拖拽](https://gitcode.com/openharmony/applications_app_samples/tree/master/code/DocsSample/ArkUISample/EventProject)	14	+8. [支持键盘输入事件](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/ui/arkts-interaction-development-guide-keyboard.md)
15	### 效果预览	15	### 效果预览
16		16
17	\| 首页 \| 交互类组件目录 \| 单一手势示例 \|	17	\| 首页 \| 交互类组件目录 \| 单一手势示例 \|
	@@ -100,26 +100,14 @@ entry/src/ohosTest/
100	```	100	```
101		101
102	### 具体实现	102	### 具体实现
103	-<<<<<<< TJS	103	+1. 触屏事件指当手指/手写笔在组件上按下、滑动、抬起时触发的回调事件。包括点击事件、拖拽事件和触摸事件。
104	-	104	+2. 键鼠事件指键盘，鼠标外接设备的输入事件。支持的鼠标事件包含通过外设鼠标、触控板触发的事件。
105	-1、选择目标组件	105	+3. 使用外接键盘的按键走焦（TAB键/Shift+TAB键/方向键）、使用requestFocus申请焦点、clearFocus清除焦点、focusOnTouch点击申请焦点等接口导致的焦点转移。焦点激活态：焦点激活是用来显示当前获焦组件焦点框的视觉样式。焦点传递规则:焦点传递是指当用户激活应用焦点系统时，焦点如何从根节点逐级向下传递到具体组件的过程。
106	-确定要在哪个 UI 组件上绑定手势（如 Column、Text、Image 等）。	106	+4. 从一个组件位置拖出（drag）数据并将其拖入（drop）到另一个组件位置，以触发响应。在这一过程中，拖出方提供数据，而拖入方负责接收和处理数据。这一操作使用户能够便捷地移动、复制或删除指定内容。
107	-调用 .gesture() 方法	107	+5. 可以通过在拖动手势的回调函数中修改组件的布局位置信息来实现组件的拖动。
108	-使用 .gesture(Gesture) 方法将手势绑定到组件上。	108	+6. Column组件上绑定了translate属性，通过修改该属性可以设置组件的位置移动。然后在该组件上绑定LongPressGesture和PanGesture组合而成的Sequence组合手势。当触发LongPressGesture时，更新显示的数字。当长按后进行拖动时，根据拖动手势的回调函数，实现组件的拖动。
109	-2、创建手势对象	109	+7. 嵌套滚动、通过过滤组件响应手势的范围来优化交互体验。手势拦截主要采用手势触发控制和手势响应控制两种方式实现。
110	-调用对应的手势构造函数，如 TapGesture()、PanGesture() 等，可传入参数配置行为。	110	+8. 物理按键产生的按键事件为非指向性事件，与触摸等指向性事件不同，其事件并没有坐标位置信息，所以其会按照一定次序向获焦组件进行派发，大多数文字输入场景下，按键事件都会优先派发给输入法进行处理，以便其处理文字的联想和候选词，应用可以通过onKeyPreIme提前感知事件。
111	-注册事件回调
112	-通过 .onAction()、.onActionStart()、.onActionUpdate()、.onActionEnd() 等方法监听手势状态变化。
113	-3、更新状态或执行逻辑
114	-在回调中修改 @State 变量、触发动画、调用函数等。
115	-
116	-=======
117	-焦点：指向当前应用界面上唯一的一个可交互元素，当用户使用键盘、电视遥控器、车机摇杆/旋钮等非指向性输入设备与应用程序进行间接交互时，基于焦点的导航和交互是重要的输入手段。
118	-焦点链：在应用的组件树形结构中，当一个组件获得焦点时，从根节点到该组件节点的整条路径上的所有节点都会处于焦点状态，形成一条连续的焦点链。
119	-走焦：指焦点在应用内的组件之间转移的行为。这一过程对用户是透明的，但开发者可以通过监听onFocus（焦点获取）和onBlur（焦点失去）事件来捕捉这些变化。关于走焦的具体方式和规则，详见走焦规范。
120	-焦点激活态：焦点激活是用来显示当前获焦组件焦点框的视觉样式。
121	-焦点传递规则:焦点传递是指当用户激活应用焦点系统时，焦点如何从根节点逐级向下传递到具体组件的过程。
122	->>>>>>> master
123	### 相关权限	111	### 相关权限
124		112
125	不涉及。	113	不涉及。

Mcode/DocsSample/ArkUISample/InterAction/README_zh.md+11-6

	@@ -2,9 +2,14 @@
2		2
3	### 介绍	3	### 介绍
4		4
5	-本示例通过使用[ArkUI指南文档](https://gitCode .com/openharmony/docs/tree/master/zh-cn/application-dev/ui)	5	+本示例通过使用[ArkUI指南文档](https://gitCode.com/openharmony/docs/tree/master/zh-cn/application-dev/ui)
6	中各场景的开发示例，展示在工程中，帮助开发者更好地理解ArkUI提供的组件及组件属性并合理使用。	6	中各场景的开发示例，展示在工程中，帮助开发者更好地理解ArkUI提供的组件及组件属性并合理使用。
7		7
		8	+### 示例文档
		9	+[交互基础机制说明](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/ui/arkts-interaction-basic-principles.md)
		10	+[支持鼠标输入事件](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/ui/arkts-interaction-development-guide-mouse.md)
		11	+[支持触屏输入事件](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/ui/arkts-interaction-development-guide-touch-screen.md)
		12	+
8	### 效果预览	13	### 效果预览
9		14
10	\| 首页 \| 交互类组件目录 \| 单一手势示例 \|	15	\| 首页 \| 交互类组件目录 \| 单一手势示例 \|
	@@ -55,17 +60,17 @@ entry/src/ohosTest/
55		60
56	### 具体实现	61	### 具体实现
57		62
58	-1、默认情况下，组件的响应热区即为组件自身的位置和大小，这与用户看到的范围相	63	+1. 默认情况下，组件的响应热区即为组件自身的位置和大小，这与用户看到的范围相
59	一致，从而最大程度地保证用户操作的手眼一致性。在极少数情况下，应用需调整热区	64	一致，从而最大程度地保证用户操作的手眼一致性。在极少数情况下，应用需调整热区
60	大小以限制或扩大组件响应的操作范围，这一功能通过组件的responseRegion接口实现。	65	大小以限制或扩大组件响应的操作范围，这一功能通过组件的responseRegion接口实现。
61	响应热区影响指向性事件的派发，通过与组件自身区域的相对关系进行指定，可以指定一	66	响应热区影响指向性事件的派发，通过与组件自身区域的相对关系进行指定，可以指定一
62	个或多个区域，将组件的响应热区分割为多个部分；	67	个或多个区域，将组件的响应热区分割为多个部分；
63	-2、鼠标事件回调。每当鼠标指针在绑定该API的组件内产生行为（MouseAction）时，触	68	+2. 鼠标事件回调。每当鼠标指针在绑定该API的组件内产生行为（MouseAction）时，触
64	发事件回调，参数为MouseEvent对象，表示触发此次的鼠标事件。该事件支持自定义冒泡	69	发事件回调，参数为MouseEvent对象，表示触发此次的鼠标事件。该事件支持自定义冒泡
65	设置，默认父子冒泡；	70	设置，默认父子冒泡；
66	-3、重采样会合并同一个触点在同一帧内多次上报的move事件，并通过算法尽可能计算出一	71	+3. 重采样会合并同一个触点在同一帧内多次上报的move事件，并通过算法尽可能计算出一
67	个合适的坐标上报给应用；	72	个合适的坐标上报给应用；
68	-4、在支持多指触控的触屏设备上，上报的事件中同时包含了窗口所有按压手指的信息，可	73	+4. 在支持多指触控的触屏设备上，上报的事件中同时包含了窗口所有按压手指的信息，可
69	以通过touches获取；	74	以通过touches获取；
70		75
71	### 相关权限	76	### 相关权限
	@@ -92,6 +97,6 @@ entry/src/ohosTest/
92	git init	97	git init
93	git config core.sparsecheckout true	98	git config core.sparsecheckout true
94	echo code/DocsSample/ArkUISample/EventProject > .git/info/sparse-checkout	99	echo code/DocsSample/ArkUISample/EventProject > .git/info/sparse-checkout
95	-git remote add origin https://gitCode .com/openharmony/applications_app_samples.git	100	+git remote add origin https://gitcode.com/openharmony/applications_app_samples.git
96	git pull origin master	101	git pull origin master
97	````	102	````

Mcode/DocsSample/ArkUISample/MultilevelGestureEvents/README_zh.md+4-3

	@@ -1,10 +1,11 @@
1	-# ArkUI使用文本控件指南文档示例	1	+# 多层级手势事件指南
2		2
3	### 介绍	3	### 介绍
4		4
5	本示例通过使用[ArkUI指南文档](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/ui)中各场景的开发示例，展示在工程中，帮助开发者更好地理解ArkUI提供的组件及组件属性并合理使用。该工程中展示的代码详细描述可查如下链接：	5	本示例通过使用[ArkUI指南文档](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/ui)中各场景的开发示例，展示在工程中，帮助开发者更好地理解ArkUI提供的组件及组件属性并合理使用。该工程中展示的代码详细描述可查如下链接：
6		6
7	-1. [多层级手势事件](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/ui/arkts-gesture-events-multi-level-gesture.md)。	7	+### 示例文档
		8	+[多层级手势事件](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/ui/arkts-gesture-events-multi-level-gesture.md)。
8		9
9	### 效果预览	10	### 效果预览
10	不涉及	11	不涉及
	@@ -17,7 +18,7 @@
17	4. 常见多级手势应用：	18	4. 常见多级手势应用：
18	单击 + 双击：适用于图片或文档查看场景，如双击放大、单击退出；	19	单击 + 双击：适用于图片或文档查看场景，如双击放大、单击退出；
19	滑动 + 缩放：适用于图表场景，如滑动移动视图、双指缩放查看细节；	20	滑动 + 缩放：适用于图表场景，如滑动移动视图、双指缩放查看细节；
20	-长按 + 滑动：适用于拖拽场景，如长按后滑动以移动元素位置，满足复杂交互需求。	21	+长按 + 滑动：适用于拖拽场景，如长按后滑动以移动元素位置，满足复杂交互需求。
21		22
22	### 工程目录	23	### 工程目录
23	```	24	```

Mcode/DocsSample/ArkUISample/NdkNodeQueryOperate/README_zh.md+4-1

	@@ -1,4 +1,4 @@
1	-# ArkUI查询和操作自定义节点知道文档	1	+# ArkUI查询和操作自定义节点指南
2		2
3	## 介绍	3	## 介绍
4		4
	@@ -14,6 +14,9 @@
14	\| OH_ArkUI_NodeUtils_GetLastChildIndexWithoutExpand \| 获取目标节点在树上的最后一个子节点的下标。 \|	14	\| OH_ArkUI_NodeUtils_GetLastChildIndexWithoutExpand \| 获取目标节点在树上的最后一个子节点的下标。 \|
15	\| OH_ArkUI_NodeUtils_GetChildWithExpandMode \| 用不同的展开模式获取对应下标的子节点。 \|	15	\| OH_ArkUI_NodeUtils_GetChildWithExpandMode \| 用不同的展开模式获取对应下标的子节点。 \|
16		16
		17	+### 示例文档
		18	+[节点查询](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/ui/ndk-node-query-operate.md)。
		19	+
17	## 效果预览	20	## 效果预览
18	<table>	21	<table>
19	<tr>	22	<tr>

Mcode/DocsSample/ArkUISample/NdkScopeTask/README_zh.md+4-1

	@@ -2,7 +2,10 @@
2		2
3	### 介绍	3	### 介绍
4		4
5	-本示例演示了如何使用OH_ArkUI_RunTaskInScope接口实现NDK多窗口场景下的跨实例组件操作。通过动态切换执行上下文，确保在页面B中安全地修改页面A创建的组件属性，避免因实例上下文不匹配导致的接口调用异常。[示例文档](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/ui/ndk-scope-task.md)。	5	+此示例展示了如何使用OH_ArkUI_RunTaskInScope接口实现多窗口场景下的跨实例组件操作。通过动态切换执行上下文，确保在页面PageB中安全地修改页面PageA创建的组件属性，避免因实例上下文不匹配导致的接口调用异常。
		6	+
		7	+### 示例文档
		8	+[组件操作](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/ui/ndk-scope-task.md)。
6		9
7	### 使用说明	10	### 使用说明
8	1. 安装编译生成的hap包，并启动应用程序；	11	1. 安装编译生成的hap包，并启动应用程序；

Mcode/DocsSample/ArkUISample/StateStyle/README_zh.md+12-6

	@@ -1,9 +1,16 @@
1	-# ArkUI使用支持交互事件指南文档示例	1	+# 手势响应指南
2		2
3	### 介绍	3	### 介绍
4		4
5	-本示例通过使用[ArkUI指南文档](https://gitcode.com/openharmony/docs/tree/master/zh-cn/application-dev/ui)	5	+1. 本示例通过使用[ArkUI指南文档](https://gitcode.com/openharmony/docs/tree/master/zh-cn/application-dev/ui)
6	中各场景的开发示例，展示在工程中，帮助开发者更好地理解ArkUI提供的组件及组件属性并合理使用。	6	中各场景的开发示例，展示在工程中，帮助开发者更好地理解ArkUI提供的组件及组件属性并合理使用。
		7	+2. 单击作为常用的手势，可以方便地使用onClick接口实现。尽管被称为事件，它实际上是基本手势类型，等同于将count配置为1的TapGesture，即单击手势。
		8	+3. 组合手势由多种单一手势组合而成，通过在GestureGroup中使用不同的GestureMode来声明该组合手势的类型，支持顺序识别、并行识别和互斥识别三种类型。
		9	+4. 多层级手势事件指父子组件嵌套时，父子组件均绑定了手势或事件。在该场景下，手势或者事件的响应受到多个因素的影响，相互之间发生传递和竞争，容易出现预期外的响应。
		10	+5. 手势冲突是指多个手势识别器在同一组件或重叠区域同时识别时产生竞争，导致识别结果不符合预期。
		11	+
		12	+### 示例文档
		13	+[stateStyles：多态样式](https://gitcode.com/openharmony/docs/blob/master/zh-cn/application-dev/ui/state-management/arkts-statestyles.md)
7		14
8	### 效果预览	15	### 效果预览
9		16
	@@ -42,10 +49,9 @@ entry/src/ohosTest/
42		49
43	### 具体实现	50	### 具体实现
44		51
45	-stateStyles 通过为组件的不同内部状态（如 normal、focused、pressed 等）	52	+1. stateStyles 通过为组件的不同内部状态（如 normal、focused、pressed 等）。
46	-绑定对应的样式规则，实现动态的多态视觉效果，其使用方式是在组件上调用	53	+2. 绑定对应的样式规则，实现动态的多态视觉效果，其使用方式是在组件上调用。
47	-.stateStyles({}) 方法，传入一个以状态名为键的对象，每个状态内通过链式调	54	+3. stateStyles({}) 方法，传入一个以状态名为键的对象，每个状态内通过链式调用设置通用样式属性，从而在用户交互时自动切换外观，提升用户体验。
48	-用设置通用样式属性，从而在用户交互时自动切换外观，提升用户体验。
49		55
50	### 相关权限	56	### 相关权限
51		57