
HarmonyOS API:通用属性
版本:v3.1 Beta
布局约束
更新时间: 2023-02-17 09:19
通过组件的宽高比和显示优先级约束组件显示效果。
说明
从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
属性
名称 | 参数说明 | 描述 |
aspectRatio | number | 指定当前组件的宽高比,aspectRatio = width/height。 |
displayPriority | number | 设置当前组件在布局容器中显示的优先级,当父容器空间不足时,低优先级的组件会被隐藏。 小数点后的数字不作优先级区分,即区间为[x, x + 1)内的数字视为相同优先级。例如:1.0与1.9为同一优先级。 说明: 仅在Row/Column/Flex(单行)容器组件中生效。 |
示例
图1 竖屏显示
图2 横屏显示
Flex布局
更新时间: 2023-02-17 09:19
说明
- 从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
- 仅当父组件是 Flex、Column、Row 时生效。
属性
名称 | 参数说明 | 描述 |
flexBasis | number | string | 设置组件在父容器主轴方向上的基准尺寸。 默认值:'auto'(表示组件在主轴方向上的基准尺寸为组件原本的大小)。 不支持百分比设置。 |
flexGrow | number | 设置父容器的剩余空间分配给此属性所在组件的比例。 默认值:0 |
flexShrink | number | 设置父容器压缩尺寸分配给此属性所在组件的比例。 父容器为Row、Column时,默认值:0 父容器为flex时,默认值:1 |
alignSelf | 子组件在父容器交叉轴的对齐格式,会覆盖Flex布局容器中的alignItems设置。 默认值:ItemAlign.Auto |
示例
边框设置
更新时间: 2023-02-17 09:19
设置组件边框样式。
说明
从API Version 7开始支持。后续版本如有新增内容,则采用上角标单独标记该内容的起始版本。
从API Version 9开始,父节点的border显示在子节点内容之上。
属性
名称 | 参数类型 | 描述 |
border | { width?: Length | EdgeWidths9+, color?: ResourceColor | EdgeColors9+, radius?: Length | BorderRadiuses9+, style?: BorderStyle | EdgeStyles9+ } | 统一边框样式设置接口。 - width:设置边框宽度。 - color:设置边框颜色。 - radius:设置边框圆角半径。 - style:设置边框样式。 |
borderStyle | BorderStyle | EdgeStyles9+ | 设置元素的边框样式。 默认值:BorderStyle.Solid |
borderWidth | Length | EdgeWidths9+ | 设置元素的边框宽度,不支持百分比。 |
borderColor | ResourceColor | EdgeColors9+ | 设置元素的边框颜色。 默认值:Color.Black |
borderRadius | Length | BorderRadiuses9+ | 设置元素的边框圆角半径,不支持百分比。 |
EdgeWidths9+对象说明
引入该对象时,至少传入一个参数。
名称 | 参数类型 | 必填 | 描述 |
left | Length | 否 | 左侧边框宽度。 |
right | Length | 否 | 右侧边框宽度。 |
top | Length | 否 | 上侧边框宽度。 |
bottom | Length | 否 | 下侧边框宽度。 |
EdgeColors9+对象说明
引入该对象时,至少传入一个参数。
名称 | 参数类型 | 必填 | 描述 |
left | 否 | 左侧边框颜色。 | |
right | 否 | 右侧边框颜色。 | |
top | 否 | 上侧边框颜色。 | |
bottom | 否 | 下侧边框颜色。 |
BorderRadiuses9+对象说明
引用该对象时,至少传入一个参数。
名称 | 参数类型 | 必填 | 描述 |
topLeft | Length | 否 | 左上角圆角半径。 |
topRight | Length | 否 | 右上角圆角半径。 |
bottomLeft | Length | 否 | 左下角圆角半径。 |
bottomRight | Length | 否 | 右下角圆角半径。 |
EdgeStyles9+对象说明
引入该对象时,至少传入一个参数。
名称 | 参数类型 | 必填 | 描述 |
left | 否 | 左侧边框样式。 | |
right | 否 | 右侧边框样式。 | |
top | 否 | 上侧边框样式。 | |
bottom | 否 | 下侧边框样式。 |
示例
