鸿蒙HarmonyOS NEXT开发：栅格设置（ArkTS通用属性）

栅格设置

说明：

• 从API Version 7开始支持。后续版本如有新增内容，则采用上角标单独标记该内容的起始版本。

• 栅格布局的列宽、列间距由距离最近的GridContainer父组件决定。使用栅格属性的组件树上至少需要有1个GridContainer容器组件。

• gridSpan、gridOffset属性调用时其父组件或祖先组件必须是GridContainer。

属性

名称	参数类型	描述
useSizeType(deprecated)	{ xs?: number | { span: number, offset: number }, sm?: number | { span: number, offset: number }, md?: number | { span: number, offset: number }, lg?: number | { span: number, offset: number } }	设置在特定设备宽度类型下的占用列数和偏移列数，span: 占用列数; offset: 偏移列数。 当值为number类型时，仅设置列数， 当格式如{“span”: 1, “offset”: 0}时，指同时设置占用列数与偏移列数。 - xs: 指设备宽度类型为SizeType.XS时的占用列数和偏移列数。 - sm: 指设备宽度类型为SizeType.SM时的占用列数和偏移列数。 - md: 指设备宽度类型为SizeType.MD时的占用列数和偏移列数。 - lg: 指设备宽度类型为SizeType.LG时的占用列数和偏移列数。 该属性从API version 9开始废弃，推荐使用新组件GridCol、GridRow。
gridSpan	number	默认占用列数，指useSizeType属性没有设置对应尺寸的列数(span)时，占用的栅格列数。 说明： 设置了栅格span属性，组件的宽度由栅格布局决定。 默认值：1 原子化服务API： 从API version 11开始，该接口支持在原子化服务中使用。
gridOffset	number	默认偏移列数，指useSizeType属性没有设置对应尺寸的偏移(offset)时， 当前组件沿着父组件Start方向，偏移的列数，也就是当前组件位于第n列。 说明： - 配置该属性后，当前组件在父组件水平方向的布局不再跟随父组件原有的布局方式，而是沿着父组件的Start方向偏移一定位移。