• Home
  • Line#
  • Scopes#
  • Navigate#
  • Raw
  • Download
1# RowSplit
2
3将子组件横向布局,并在每个子组件之间插入一根纵向的分割线。
4
5>  **说明:**
6>
7> 该组件从API version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
8
9## 子组件
10
11可以包含子组件。
12
13RowSplit通过分割线限制子组件的宽度。初始化时,分割线位置根据子组件的宽度来计算。初始化后,后续动态修改子组件的宽度则不生效,分割线位置保持不变,子组件宽度可以通过拖动相邻分割线进行改变。
14
15初始化后,动态修改[margin](ts-universal-attributes-size.md#margin)、[border](ts-universal-attributes-border.md#border)、[padding](ts-universal-attributes-size.md#padding)通用属性导致子组件宽度大于相邻分割线间距的异常情况下,不支持拖动分割线改变子组件的宽度。
16## 接口
17
18RowSplit()
19
20带分割线的子组件横向分隔布局。
21
22**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
23
24**系统能力:** SystemCapability.ArkUI.ArkUI.Full
25
26## 属性
27
28### resizeable
29
30resizeable(value: boolean)
31
32设置分割线是否可拖拽。
33
34**原子化服务API:** 从API version 11开始,该接口支持在原子化服务中使用。
35
36**系统能力:** SystemCapability.ArkUI.ArkUI.Full
37
38**参数:**
39
40| 参数名 | 类型 | 必填 | 说明 |
41| -------- | -------- | -------- | -------- |
42| value | boolean | 是 | 分割线是否可拖拽。<br/>默认值:false |
43
44>  **说明:**
45>
46> RowSplit的分割线可以改变左右两边子组件的宽度,子组件可改变宽度的范围取决于子组件的最大最小宽度。
47>
48> 支持[clip](ts-universal-attributes-sharp-clipping.md#clip)、[margin](ts-universal-attributes-size.md#margin)等通用属性,clip不设置的时候默认值为true。
49
50
51## 示例
52
53RowSplit的基本用法。设置可拖动的、横向布局的子组件。
54
55```ts
56// xxx.ets
57@Entry
58@Component
59struct RowSplitExample {
60  build() {
61    Column() {
62      Text('The second line can be dragged').fontSize(9).fontColor(0xCCCCCC).width('90%')
63      RowSplit() {
64        Text('1').width('10%').height(100).backgroundColor(0xF5DEB3).textAlign(TextAlign.Center)
65        Text('2').width('10%').height(100).backgroundColor(0xD2B48C).textAlign(TextAlign.Center)
66        Text('3').width('10%').height(100).backgroundColor(0xF5DEB3).textAlign(TextAlign.Center)
67        Text('4').width('10%').height(100).backgroundColor(0xD2B48C).textAlign(TextAlign.Center)
68        Text('5').width('10%').height(100).backgroundColor(0xF5DEB3).textAlign(TextAlign.Center)
69      }
70      .resizeable(true) // 可拖动
71      .width('90%').height(100)
72    }.width('100%').margin({ top: 5 })
73  }
74}
75```
76
77![zh-cn_image_0000001219982729](figures/zh-cn_image_0000001219982729.gif)
78