• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# 触摸测试控制
2
3设置组件的触摸测试类型。ArkUI开发框架在处理触屏事件时，会在触屏事件触发前，进行按压点和组件区域的触摸测试来收集需要响应触屏事件的组件，然后基于触摸测试结果分发相应的触屏事件。hitTestBehavior属性可以设置不同的触摸测试响应模式，影响组件的触摸测试收集结果，最终影响后续的触屏事件分发，具体影响参考[HitTestMode](#hittestmode枚举说明)枚举说明。
4
5>  **说明：**
6>  - 从API Version 9开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。
7>  - 当Stack组件中有多个节点触摸区域重叠时，如两个节点，默认只会对显示在最上层的节点做触摸测试，若需要显示在下层的节点触发触摸测试，请给显示在上层的节点设置hitTestBehavior为HitTestMode.Transparent。
8
9
10## 属性
11
12| **名称**               | **参数类型**     | **描述**                                  |
13| -------------------- | -------- | ---------------------------------------- |
14| hitTestBehavior      | [HitTestMode](#hittestmode枚举说明) | 设置当前组件的触摸测试类型。<br>默认值： HitTestMode.Default |
15
16## HitTestMode枚举说明
17
18  | 名称          | 描述                                       |
19  | ------------| ----------------------------------------- |
20  | Default     | 默认触摸测试效果，自身和子节点都响应触摸测试，但会阻塞兄弟节点的触摸测试。 |
21  | Block       | 自身响应触摸测试，阻塞子节点和兄弟节点的触摸测试。 |
22  | Transparent | 自身和子节点都响应触摸测试，不会阻塞兄弟节点的触摸测试。 |
23  | None        | 自身不响应触摸测试，不会阻塞子节点和兄弟节点的触摸测试。 |
24
25
26## 示例
27
28Text组件设置hitTestBehavior为HitTestMode.Transparent，不会阻塞内层Stack的触摸测试，因此Text和内层Stack的onTouch事件都会触发。
29内层Stack设置hitTestBehavior为HitTestMode.Block，会阻塞子节点和外层Button进行触摸测试，因此内层Button和外层Button组件不会响应onTouch事件。
30
31```ts
32// xxx.ets
33@Entry
34@Component
35struct HitTestBehaviorExample {
36  build() {
37    // outer stack
38    Stack() {
39      Button('outer button')
40        .onTouch((event) => {
41          console.info('outer button touched type: ' + event.type)
42        })
43      // inner stack
44      Stack() {
45        Button('inner button')
46          .onTouch((event) => {
47            console.info('inner button touched type: ' + event.type)
48          })
49      }
50      .width("100%").height("100%")
51      .hitTestBehavior(HitTestMode.Block)
52      .onTouch((event) => {
53        console.info('stack touched type: ' + event.type)
54      })
55
56      Text('Transparent')
57        .hitTestBehavior(HitTestMode.Transparent)
58        .width("100%").height("100%")
59        .onTouch((event) => {
60          console.info('text touched type: ' + event.type)
61        })
62    }.width(300).height(300)
63  }
64}
65```