layoutWeight(value: number | string):设置组件的布局权重,使组件在父容器(Row/Column/Flex)的主轴方向按照权重分配尺寸。
通过layoutWeight属性动态调整子元素尺寸占比的核心容器,适用于需要灵活布局的场景,下列方案以Row、Column为例,分别展示水平和竖直方向上layoutWeight的分配方法。
@Entry
@Component
struct BottomWithBar {
build() {
Column() {
Row() {
Row() {
Text('左侧');
}
.justifyContent(FlexAlign.Center)
.height('50%') // 因为是Row()组件。所以设置高度以便观察
.backgroundColor('#F1F3F5')
.layoutWeight(2); // 占据2/3宽度
Row() {
Text('右侧');
}
.justifyContent(FlexAlign.Center)
.height('50%') // 因为是Row()组件。所以设置高度以便观察
.backgroundColor('#E5E5EA')
.layoutWeight(1); // 占据1/3宽度
};
}
.width('100%')
.height('100%');
}
} 效果图:

@Entry
@Component
struct BottomWithBar2 {
build() {
Column() {
Column() {
Row() {
Text('顶部');
}
.justifyContent(FlexAlign.Center)
.width('50%') // 因为是Column()组件。所以设置宽度以便观察
.backgroundColor('#F1F3F5')
.layoutWeight(1); // 占据1/2高度
Row() {
Text('底部');
}
.justifyContent(FlexAlign.Center)
.width('50%') // 因为是Column()组件。所以设置宽度以便观察
.backgroundColor('#E5E5EA')
.layoutWeight(1); // 占据1/2高度
};
}
.width('100%')
.height('100%');
}
} 效果图:

Q:如何指定组件到屏幕边缘的距离。例如:Row容器中存在左侧Text,右侧TextInput两个子组件,要求左侧Text组件宽度固定,右侧TextInput宽度自适应,并且Text组件距离左边屏幕边缘和TextInput组件距离右侧屏幕边缘的距离均为16vp。
A:将Row组件的宽度设为屏幕宽度,左右内边距为16vp,Text设为固定宽度,TextInput添加layoutWeight属性即可。
示例代码如下:
@Entry
@Component
struct Index3 {
controller: TextInputController = new TextInputController();
build() {
Row({ space: 16 }) {
Text('示例文本')
.textAlign(TextAlign.Center)
.backgroundColor('#F1F3F5')
.borderRadius(20)
.height(40)
.width(80)
.font({ size: 16, weight: 500 })
.fontColor('#182431');
TextInput({ placeholder: 'input your word...', controller: this.controller })
.placeholderColor(Color.Grey)
.placeholderFont({ size: 14, weight: 400 })
.caretColor(Color.Blue)
.layoutWeight(1);
}
.padding({ left: 16, right: 16 })
.height('100%')
.width('100%')
.justifyContent(FlexAlign.Center);
};
}