ts-container-row.md 2.9 KB
Newer Older
E
ester.zhou 已提交
1
# Row
Z
zengyawen 已提交
2

E
ester.zhou 已提交
3 4
The **<Row\>** component lays out child components horizontally.

E
ester.zhou 已提交
5 6 7
>  **NOTE**
>
>  This component is supported since API version 7. Updates will be marked with a superscript to indicate their earliest API version.
Z
zengyawen 已提交
8

E
ester.zhou 已提交
9 10 11 12 13 14 15 16

## Child Components

Supported


## APIs

E
ester.zhou 已提交
17 18 19
Row(value?:{space?:  number | string })

**Parameters**
E
ester.zhou 已提交
20

E
ester.zhou 已提交
21 22
| Name| Type| Mandatory| Description|
| -------- | -------- | -------- | -------- |
E
ester.zhou 已提交
23
| space | string \| number | No| Horizontal spacing between two adjacent child components.<br>Since API version 9, this parameter does not take effect when it is set to a negative number.<br>Default value: **0**, in vp|
E
ester.zhou 已提交
24 25 26 27


## Attributes

E
ester.zhou 已提交
28 29 30
| Name| Type| Description|
| -------- | -------- | -------- |
| alignItems | [VerticalAlign](ts-appendix-enums.md#verticalalign) | Alignment mode of child components in the vertical direction.<br>Default value: **VerticalAlign.Center**|
E
ester.zhou 已提交
31
| justifyContent<sup>8+</sup> | [FlexAlign](ts-appendix-enums.md#flexalign) | Alignment mode of the child components in the horizontal direction.<br>FlexAlign.Start |
E
ester.zhou 已提交
32 33 34


## Example
Z
zengyawen 已提交
35

E
esterzhou 已提交
36 37
```ts
// xxx.ets
Z
zengyawen 已提交
38 39 40 41 42
@Entry
@Component
struct RowExample {
  build() {
    Column({ space: 5 }) {
E
ester.zhou 已提交
43
      // Set the horizontal spacing between two adjacent child components to 5.
Z
zengyawen 已提交
44
      Text('space').fontSize(9).fontColor(0xCCCCCC).width('90%')
E
ester.zhou 已提交
45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74
      Row({ space: 5 }) {
        Row().width('30%').height(50).backgroundColor(0xAFEEEE)
        Row().width('30%').height(50).backgroundColor(0x00FFFF)
      }.width('90%').height(107).border({ width: 1 })

      // Set the alignment mode of the child components in the vertical direction.
      Text('alignItems(Bottom)').fontSize(9).fontColor(0xCCCCCC).width('90%')
      Row() {
        Row().width('30%').height(50).backgroundColor(0xAFEEEE)
        Row().width('30%').height(50).backgroundColor(0x00FFFF)
      }.width('90%').alignItems(VerticalAlign.Bottom).height('15%').border({ width: 1 })

      Text('alignItems(Center)').fontSize(9).fontColor(0xCCCCCC).width('90%')
      Row() {
        Row().width('30%').height(50).backgroundColor(0xAFEEEE)
        Row().width('30%').height(50).backgroundColor(0x00FFFF)
      }.width('90%').alignItems(VerticalAlign.Center).height('15%').border({ width: 1 })

      // Set the alignment mode of the child components in the horizontal direction.
      Text('justifyContent(End)').fontSize(9).fontColor(0xCCCCCC).width('90%')
      Row() {
        Row().width('30%').height(50).backgroundColor(0xAFEEEE)
        Row().width('30%').height(50).backgroundColor(0x00FFFF)
      }.width('90%').border({ width: 1 }).justifyContent(FlexAlign.End)

      Text('justifyContent(Center)').fontSize(9).fontColor(0xCCCCCC).width('90%')
      Row() {
        Row().width('30%').height(50).backgroundColor(0xAFEEEE)
        Row().width('30%').height(50).backgroundColor(0x00FFFF)
      }.width('90%').border({ width: 1 }).justifyContent(FlexAlign.Center)
Z
zengyawen 已提交
75 76 77 78 79
    }.width('100%')
  }
}
```

E
ester.zhou 已提交
80
![row](figures/row.png)