普通网友-优快云博客

原创鸿蒙HarmonyOS 【ArkTS组件】通用属性-安全区域

摘要：本文介绍了ArkUI框架中的安全区域概念及其实现方式。安全区域默认不与系统非安全区（如状态栏、导航栏）重叠，开发者可通过expandSafeArea属性扩展组件绘制区域至安全区外，支持配置安全区类型和方向。同时提供了setKeyboardAvoidMode方法设置键盘弹出时的页面避让模式（默认上抬），并说明了两者的交互效果。文章通过6个代码示例，分别演示了沉浸式效果、固定宽高限制、键盘避让场景、滚动容器适配等典型应用。其中强调：设置expandSafeArea需注意组件边界条件，避免与滚动容器冲突；键

2025-05-30 17:04:37 774

原创鸿蒙HarmonyOS 【ArkTS组件】通用属性-文本通用

摘要：本文介绍了ArkUI框架中文本样式的通用属性设置接口，包括fontColor（字体颜色）、fontSize（字体大小）、fontStyle（字体样式）、fontWeight（字体粗细）、fontFamily（字体列表）、lineHeight（行高）和decoration（装饰线样式）。这些接口从API 9开始支持ArkTS卡片，从API 11开始支持元服务。文章详细说明了各属性的参数类型、取值范围和默认设置，并提供了示例代码展示不同文本样式效果，如红色斜体加粗文本、橙色正常文本以及各种装饰线样式文本。

2025-05-30 14:02:40 1700

原创鸿蒙HarmonyOS 【ArkTS组件】通用属性-显隐控制

visibility接口用于控制组件的显隐状态，支持从API version 9开始在ArkTS卡片中使用，并从API version 11开始在元服务中使用。该接口通过Visibility枚举值控制组件的显示或隐藏，默认值为Visibility.Visible。示例代码展示了如何使用visibility配置不同的显隐效果，包括None（隐藏且不占位）、Hidden（隐藏但占位）和Visible（正常显示）。开发者可根据具体场景选择使用条件渲染或visibility来控制组件的显隐。

2025-05-22 13:58:17 902

原创鸿蒙HarmonyOS【ArkTS组件】通用属性-位置设置

本文介绍了如何设置组件的对齐方式、布局方向和显示位置。通过align属性可以设置容器内子元素的对齐方式，适用于Stack、Button等组件。direction属性用于设置容器内主轴方向的布局，支持自动根据系统语言方向布局。position属性用于绝对定位，确定子组件相对于父组件的位置，支持基于四边的定位方式。markAnchor属性用于设置元素在位置定位时的锚点，进一步调整偏移。offset属性用于相对偏移，组件相对于原本的布局位置进行偏移。此外，alignRules属性用于在相对容器中设置子组件的对齐规

2025-05-19 21:45:11 941

原创鸿蒙HarmonyOS 【ArkTS组件】通用属性-尺寸设置

本文介绍了用于设置组件宽高、边距的接口及其特性。width和height接口用于设置组件的宽度和高度，支持自适应和calc计算特性。size接口用于同时设置高宽尺寸。padding和margin接口分别用于设置内边距和外边距，支持百分比和calc计算。layoutWeight接口用于在父容器中按权重分配子组件尺寸。constraintSize接口用于设置组件的尺寸约束，优先级高于width和height。这些接口从API version 9开始支持在ArkTS卡片中使用，从API version 11开始支

2025-05-19 18:03:40 667

原创鸿蒙HarmonyOS 【ArkTS组件】自定义事件拦截

从API Version 12开始，开发者可以通过onTouchIntercept接口为组件提供自定义的事件拦截能力。该接口允许开发者根据触摸事件的位置、输入源等信息，动态调整组件的HitTestMode属性，从而控制事件的响应行为。onTouchIntercept接受一个回调函数，该函数接收TouchEvent对象并返回HitTestMode值，决定组件是否响应触摸事件。示例代码展示了如何在组件中使用onTouchIntercept，通过判断触摸事件的位置来修改HitTestMode属性，实现自定义的事件

2025-05-19 16:05:42 621

原创鸿蒙HarmonyOS【ArkTS组件】自定义事件分发

ArkUI在处理触屏事件时，会在触屏事件触发前进行按压点和组件区域的触摸测试，来收集需要响应触屏事件的组件，再基于触摸测试结果分发相应的触屏事件。在父节点，开发者可以通过onChildTouchTest决定如何让子节点去做触摸测试，影响子组件的触摸测试，最终影响后续的触屏事件分发，具体影响参考TouchTestStrategy枚举说明。从API Version 11开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

2025-05-11 22:20:29 437

原创鸿蒙HarmonyOS 【ArkTS组件】组件快捷键事件

开发者可以设置组件的自定义组合键，每个组件可以设置多个组合键。即使组件未获焦或是在所在页面未展示，只要已经挂载到获焦窗口的组件树上就会响应自定义组合键。开发者在设置组合键的同时可以设置自定义事件，组合键按下时，触发该自定义事件，若没有设置自定义事件，则组合键行为与click行为一致。从API Version 10开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

2025-05-11 21:14:18 474

原创鸿蒙HarmonyOS 【ArkTS组件】组件可见区域变化事件

组件可见区域变化事件（onVisibleAreaChange）是当组件在屏幕中的显示面积发生变化时触发的事件，适用于广告曝光埋点等场景。该事件从APIVersion9开始支持，并在APIVersion11中扩展至元服务API。通过设置阈值数组（ratios），开发者可以监控组件可见面积与自身面积的比值变化，当比值接近预设阈值时触发回调。此功能仅计算组件相对于所有祖先节点的相对裁切面积，不支持兄弟组件或祖先兄弟节点的遮挡计算，也不适用于非挂树节点。示例代码展示了如何通过设置ratios为[0.0,1.0]来检

2025-05-11 20:05:16 662

原创鸿蒙HarmonyOS 【ArkTS组件】组件尺寸变化事件

该事件描述的是在组件尺寸发生变化时触发的onSizeChange事件。从APIVersion 12开始支持此功能，后续版本如有新增内容，会通过上角标标记起始版本。onSizeChange事件仅在布局变化导致组件尺寸变化时触发，绘制变化如translate、offset等不会触发此回调。该接口支持在ArkTS卡片和元服务中使用，系统能力为SystemCapability.ArkUI.ArkUI.Full。事件回调参数包括变化前后的尺寸信息，示例代码展示了如何在Text组件中设置并触发onSizeChange事

2025-05-09 21:40:17 614

原创鸿蒙HarmonyOS 【ArkTS组件】无障碍悬浮事件

从API Version 12开始，系统在开启无障碍模式后，Touch事件会转换为无障碍悬浮事件。开发者可以通过onAccessibilityHover回调函数监听这一事件，并在单指触摸绑定该回调的组件时触发相应的操作。该回调函数提供了isHover和event两个参数，分别用于判断手指是否悬浮在组件上以及获取悬浮事件的相关信息，如手指位置等。系统还支持多种无障碍悬浮类型，如HOVER_ENTER、HOVER_MOVE、HOVER_EXIT和HOVER_CANCEL。示例代码展示了如何通过onAccessi

2025-05-09 18:13:18 471