From 35f5c825192f2146fd4f944a6900992fed2781c5 Mon Sep 17 00:00:00 2001 From: zcdqs Date: Wed, 28 Jun 2023 09:31:14 +0800 Subject: [PATCH] remove contradictory instructions of grid Signed-off-by: zcdqs Change-Id: I7e92d5fd426b6b4a48e5701f3a329f1631ea8aae --- .../reference/arkui-ts/ts-container-grid.md | 12 ++---------- .../reference/arkui-ts/ts-container-griditem.md | 2 +- 2 files changed, 3 insertions(+), 11 deletions(-) diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-grid.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-grid.md index c909f603f5..87c2afd92b 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-grid.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-grid.md @@ -26,7 +26,8 @@ > Grid子组件的visibility属性设置为Hidden或None时依然会计算索引值。 > > Grid子组件的visibility属性设置为None时不显示，但依然会占用子组件对应的网格。 - +> +> Grid子组件设置position属性，会占用子组件对应的网格，子组件将显示在相对Grid左上角偏移position的位置。该子组件不会随其对应网格滚动，在对应网格滑出Grid显示范围外后不显示。 ## 接口 @@ -70,10 +71,6 @@ Grid组件根据rowsTemplate、columnsTemplate属性的设置情况，可分为 - Grid的宽高没有设置时，默认适应父组件尺寸。 - Gird网格列大小按照Gird自身内容区域大小减去所有行列Gap后按各个行列所占比重分配。 - GridItem默认填满网格大小。 -- 此模式下GridItem同时设置了rowStart、columnStart，会用设置的rowStart、columnStart所在位置摆放GridItem。如果这个位置已经有GridItem则会发生重叠。 -- 如果GridItem设置了rowStart、columnStart其中一个，会从上一个GridItem布局位置开始遍历寻找满足rowStart或columnStart的空闲位置摆放，如果无满足条件的空闲位置，则不布局该GridItem。 -- 如果GridItem的rowStart、columnStart属性都没有设置，会从上一个GridItem布局位置开始遍历寻找空闲位置摆放，如果没有空闲位置，则不布局该GridItem。 -- 如果GridItem的rowEnd有设置，但是rowStart没有设置，当做rowStart已经设置，并且和rowEnd设置为相同值。如果GridItem的columnEnd有设置，但是columnStart没有设置，当做columnStart已经设置，并且和columnEnd设置为相同值。 2、rowsTemplate、columnsTemplate仅设置其中的一个： @@ -83,10 +80,6 @@ Grid组件根据rowsTemplate、columnsTemplate属性的设置情况，可分为 - 此模式下以下属性不生效：layoutDirection、maxCount、minCount、cellLength。 - 网格交叉轴方向尺寸根据Gird自身内容区域交叉轴尺寸减去交叉轴方向所有Gap后按所占比重分配。 - 网格主轴方向尺寸取当前网格交叉轴方向所有GridItem高度最大值。 -- 此模式下GridItem同时设置了rowStart、columnStart，会用设置的rowStart、columnStart所在位置摆放GridItem。如果这个位置已经有GridItem则会发生重叠。 -- 如果GridItem设置了rowStart、columnStart其中一个，会从上一个GridItem布局位置开始遍历寻找满足rowStart或columnStart的空闲位置摆放。 -- 如果GridItem的rowStart、columnStart属性都没有设置，会从上一个GridItem布局位置开始遍历寻找空闲位置摆放。 -- 如果GridItem的rowEnd有设置，但是rowStart没有设置，当做rowStart已经设置，并且和rowEnd设置为相同值。如果GridItem的columnEnd有设置，但是columnStart没有设置，当做columnStart已经设置，并且和columnEnd设置为相同值。 3、rowsTemplate、columnsTemplate都不设置： @@ -95,7 +88,6 @@ Grid组件根据rowsTemplate、columnsTemplate属性的设置情况，可分为 - 此模式下仅生效以下属性：layoutDirection、maxCount、minCount、cellLength、editMode、columnsGap、rowsGap。 - 当前layoutDirection设置为Row时，先从左到右排列，排满一行再排一下一列。剩余高度不足时不再布局，整体内容顶部居中。 - 当前layoutDirection设置为Column时，先从上到下排列，排满一列再排一下一列，剩余宽度度不足时不再。整体内容顶部居中。 -- 此模式下GridItem的rowStart、columnStart不生效。 ## GridDirection8+枚举说明 diff --git a/zh-cn/application-dev/reference/arkui-ts/ts-container-griditem.md b/zh-cn/application-dev/reference/arkui-ts/ts-container-griditem.md index cd30ed6413..787125941f 100644 --- a/zh-cn/application-dev/reference/arkui-ts/ts-container-griditem.md +++ b/zh-cn/application-dev/reference/arkui-ts/ts-container-griditem.md @@ -32,7 +32,7 @@ GridItem() > > 起始行号、终点行号、起始列号、终点列号生效规则如下： > -> rowStart/rowEnd合理取值范围为0~总行数-1，columnStart/columnEnd合理取值范围为0~总列数-1。 +> rowStart/rowEnd合理取值范围为0\~总行数-1，columnStart/columnEnd合理取值范围为0\~总列数-1。 > > 只有在设置columnTemplate和rowTemplate的Grid中，设置合理的rowStart/rowEnd/columnStart/columnEnd四个属性的GridItem才能按照指定的行列号布局。 > -- GitLab