From c0b4540677a75d8eb4f8c64f261aeb32449476e2 Mon Sep 17 00:00:00 2001
From: Tianyi Tao <146603607+tianyeeT@users.noreply.github.com>
Date: Wed, 29 May 2024 00:59:16 +0800
Subject: [PATCH 1/2] [zh-cn]: create the translation of `aria-colindex`
---
.../aria/attributes/aria-colindex/index.md | 115 ++++++++++++++++++
1 file changed, 115 insertions(+)
create mode 100644 files/zh-cn/web/accessibility/aria/attributes/aria-colindex/index.md
diff --git a/files/zh-cn/web/accessibility/aria/attributes/aria-colindex/index.md b/files/zh-cn/web/accessibility/aria/attributes/aria-colindex/index.md
new file mode 100644
index 00000000000000..7071e5f9967dca
--- /dev/null
+++ b/files/zh-cn/web/accessibility/aria/attributes/aria-colindex/index.md
@@ -0,0 +1,115 @@
+---
+title: aria-colindex
+slug: Web/Accessibility/ARIA/Attributes/aria-colindex
+l10n:
+ sourceCommit: 019ca5c9ce641bfa02825e1ba0444f35dfb646cc
+---
+
+{{AccessibilitySidebar}}
+
+`aria-colindex` 属性定义了元素相对于 `table`、`grid` 或 `treegrid` 中总列数的列索引或位置。
+
+## 描述
+
+某些表格非常大,因此只显示了部分内容。虽然在加载过程中仅显示一部分列可能会改善用户体验,但你需要让所有用户知道显示了哪些内容的部分,并且并未显示所有表格的内容。
+
+ARIA 提供了几个属性来提供关于 `table`、`grid` 和 `treegrid` 结构的信息。`aria-colindex` 属性定义了在这些结构中的子结构中,元素相对于总列数的列索引或位置。
+
+与 [`aria-colcount`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colcount) 属性一起使用,后者告知辅助技术如果所有列都存在,则表格将拥有多少列,`aria-colindex` 用于表示元素相对于该总列数的列索引或位置。
+
+如果所有列都在 DOM 中,则不需要包括 `aria-colindex`,因为用户代理可以计算每个单元格或网格单元的列索引。然而,如果在任何时候将任何列留在 DOM 之外,则使用 `aria-colindex` 来指示每个单元格或网格单元相对于完整表格的列。
+
+`aria-colindex` 的值是大于或等于 1 的整数。每个值应大于前一列的 `aria-colindex` ,并且小于或等于完整表格中的列数。
+
+如果单元格或网格单元跨越多列,则设置 [`aria-colspan`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colspan) 为其跨越的列数(如果未使用{{htmlelement('td')}}和{{htmlelement('th')}} HTML 元素),并将 `aria-colindex` 设置为跨越范围的开始值;如果它只跨越了一个列宽度,则它将仅跨越其列中的第一个值。
+
+如果 DOM 中存在的列集是连续的,并且在该集中没有跨越多行或多列的单元格,则只需在每行的第一列中一次放置 `aria-colindex`。如果列不连续,则在每行的所有子元素或拥有的元素上包含 `aria-colindex` 值。
+
+下面的示例显示了一个网格,其中有 6 列,其中列 1、2、5 和 6 显示给用户。表格本身的总列数设置为 aria-colcount="6"。由于列不是连续的,因此每个[单元格](/zh-CN/docs/Web/Accessibility/ARIA/Roles/cell_role)(在本例中为 [`columnheader`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/columnheader_role) 和 [`gridcell`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/gridcell_role) 元素)都设置了 `aria-colindex` 属性。
+
+```html
+
+
+
+
+
德布拉
+
伯克斯
+
纽约
+
14127
+
+
+ …
+
+```
+
+ARIA 使用的第一条规则是:“如果你可以使用具有你所需语义和行为的本地功能,而不是重新用一个元素并**添加**一个 ARIA 角色、状态或属性来使其无障碍,那么请这样做。”如果我们使用具有语义化的 HTML 元素,如 {{HTMLElement('table')}} 、{{HTMLElement('th')}} 、{{HTMLElement('td')}} 等,那么 `aria-colcount` 属性仍然是必需的,但标记不会那么冗长。
+
+当使用语义化的表头元素且并非所有列都在 DOM 中时,仍然需要使用 `aria-colcount`,但只需要在每列的列头 {{HTMLElement('th')}} 中定义一次 `aria-colindex` 属性。
+
+```html
+
+
+
+ 名字 |
+ 姓氏 |
+ 城市 |
+ 邮编 |
+
+
+
+
+ 德布拉 |
+ 伯克斯 |
+ 纽约 |
+ 14127 |
+
+ …
+
+
+```
+
+如果所有列都在 DOM 中,则 `aria-colcount` 和 `aria-colindex` 都不是必需的。
+
+## 值
+
+- ``
+ - :大于或等于 1 且小于或等于如果所有列都存在时的总列数。
+
+## 关联接口
+
+- {{domxref("Element.ariaColIndex")}}
+ - : [`ariaColIndex`](/zh-CN/docs/Web/API/Element/ariaColIndex) 属性是 {{domxref("Element")}} 接口的一部分,反映了 `aria-colindex` 属性的值。
+- {{domxref("ElementInternals.ariaColIndex")}}
+ - : [`ariaColIndex`](/zh-CN/docs/Web/API/ElementInternals/ariaColIndex) 属性是 {{domxref("ElementInternals")}} 接口的一部分,反映了 `aria-colindex` 属性的值。
+
+## 关联角色
+
+用于角色:
+
+- [`cell`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/cell_role)
+- [`row`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/row_role)
+ 继承到角色:
+
+- [`columnheader`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/columnheader_role)
+- [`gridcell`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/gridcell_role)
+- [`rowheader`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/rowheader_role)
+
+## 规范
+
+{{Specifications}}
+
+## 参见
+
+- [`aria-colindextext`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colindextext) 属性
+- [`aria-colcount`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colcount) 属性
+- [`aria-colspan`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colspan) 属性
+- HTML {{HTMLElement('table')}} 元素
+- HTML {{HTMLElement('th')}} 元素
+- HTML {{HTMLElement('td')}} 元素
From fed87a63d28b35a06f8912aa4314d98a963d8a88 Mon Sep 17 00:00:00 2001
From: Allo
Date: Mon, 17 Jun 2024 10:16:33 +0800
Subject: [PATCH 2/2] minor fixes
---
.../aria/attributes/aria-colindex/index.md | 19 ++++++++++---------
1 file changed, 10 insertions(+), 9 deletions(-)
diff --git a/files/zh-cn/web/accessibility/aria/attributes/aria-colindex/index.md b/files/zh-cn/web/accessibility/aria/attributes/aria-colindex/index.md
index 7071e5f9967dca..b9c646330f5232 100644
--- a/files/zh-cn/web/accessibility/aria/attributes/aria-colindex/index.md
+++ b/files/zh-cn/web/accessibility/aria/attributes/aria-colindex/index.md
@@ -11,7 +11,7 @@ l10n:
## 描述
-某些表格非常大,因此只显示了部分内容。虽然在加载过程中仅显示一部分列可能会改善用户体验,但你需要让所有用户知道显示了哪些内容的部分,并且并未显示所有表格的内容。
+某些表格非常大,因此最初只显示了部分内容。虽然在加载过程中仅显示一部分列可能会改善用户体验,但你需要让所有用户知道显示了哪部分的内容,并且并未所有表格内容都存在。
ARIA 提供了几个属性来提供关于 `table`、`grid` 和 `treegrid` 结构的信息。`aria-colindex` 属性定义了在这些结构中的子结构中,元素相对于总列数的列索引或位置。
@@ -19,13 +19,13 @@ ARIA 提供了几个属性来提供关于 `table`、`grid` 和 `treegrid` 结构
如果所有列都在 DOM 中,则不需要包括 `aria-colindex`,因为用户代理可以计算每个单元格或网格单元的列索引。然而,如果在任何时候将任何列留在 DOM 之外,则使用 `aria-colindex` 来指示每个单元格或网格单元相对于完整表格的列。
-`aria-colindex` 的值是大于或等于 1 的整数。每个值应大于前一列的 `aria-colindex` ,并且小于或等于完整表格中的列数。
+`aria-colindex` 的值是大于等于 1 的整数。每个值应大于前一列的 `aria-colindex`,并且小于或等于完整表格中的列数。
-如果单元格或网格单元跨越多列,则设置 [`aria-colspan`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colspan) 为其跨越的列数(如果未使用{{htmlelement('td')}}和{{htmlelement('th')}} HTML 元素),并将 `aria-colindex` 设置为跨越范围的开始值;如果它只跨越了一个列宽度,则它将仅跨越其列中的第一个值。
+如果单元格或网格单元跨越多列,则设置 [`aria-colspan`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colspan) 为其跨越的列数(如果未使用 {{htmlelement('td')}} 和 {{htmlelement('th')}} HTML 元素),并将 `aria-colindex` 设置为跨越范围的开始值;如果它跨越的列宽仅为一,则它将只跨越其列中的第一个。
如果 DOM 中存在的列集是连续的,并且在该集中没有跨越多行或多列的单元格,则只需在每行的第一列中一次放置 `aria-colindex`。如果列不连续,则在每行的所有子元素或拥有的元素上包含 `aria-colindex` 值。
-下面的示例显示了一个网格,其中有 6 列,其中列 1、2、5 和 6 显示给用户。表格本身的总列数设置为 aria-colcount="6"。由于列不是连续的,因此每个[单元格](/zh-CN/docs/Web/Accessibility/ARIA/Roles/cell_role)(在本例中为 [`columnheader`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/columnheader_role) 和 [`gridcell`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/gridcell_role) 元素)都设置了 `aria-colindex` 属性。
+下面的示例显示了一个网格,其中有 6 列,其中列 1、2、5 和 6 显示给用户。表格本身的总列数设置为 `aria-colcount="6"`。由于列不是连续的,因此每个[单元格](/zh-CN/docs/Web/Accessibility/ARIA/Roles/cell_role)(在本例中为 [`columnheader`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/columnheader_role) 和 [`gridcell`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/gridcell_role) 元素)都设置了 `aria-colindex` 属性。
```html
@@ -49,7 +49,7 @@ ARIA 提供了几个属性来提供关于 `table`、`grid` 和 `treegrid` 结构
```
-ARIA 使用的第一条规则是:“如果你可以使用具有你所需语义和行为的本地功能,而不是重新用一个元素并**添加**一个 ARIA 角色、状态或属性来使其无障碍,那么请这样做。”如果我们使用具有语义化的 HTML 元素,如 {{HTMLElement('table')}} 、{{HTMLElement('th')}} 、{{HTMLElement('td')}} 等,那么 `aria-colcount` 属性仍然是必需的,但标记不会那么冗长。
+ARIA 使用的第一条规则是:“如果你可以使用具有你所需语义和行为的原生特性,而不是重新用一个元素并**添加**一个 ARIA 角色、状态或属性来使其无障碍,那么请这样做。”如果我们使用具有语义化的 HTML 元素,如 {{HTMLElement('table')}}、{{HTMLElement('th')}}、{{HTMLElement('td')}} 等,那么 `aria-colcount` 属性仍然是必需的,但标记不会那么冗长。
当使用语义化的表头元素且并非所有列都在 DOM 中时,仍然需要使用 `aria-colcount`,但只需要在每列的列头 {{HTMLElement('th')}} 中定义一次 `aria-colindex` 属性。
@@ -80,14 +80,14 @@ ARIA 使用的第一条规则是:“如果你可以使用具有你所需语义
## 值
- ``
- - :大于或等于 1 且小于或等于如果所有列都存在时的总列数。
+ - : 大于等于 1 且小于等于如果所有列都存在时的总列数。
## 关联接口
- {{domxref("Element.ariaColIndex")}}
- - : [`ariaColIndex`](/zh-CN/docs/Web/API/Element/ariaColIndex) 属性是 {{domxref("Element")}} 接口的一部分,反映了 `aria-colindex` 属性的值。
+ - : [`ariaColIndex`](/zh-CN/docs/Web/API/Element/ariaColIndex) 属性(属于 {{domxref("Element")}} 接口)反映了 `aria-colindex` 属性的值。
- {{domxref("ElementInternals.ariaColIndex")}}
- - : [`ariaColIndex`](/zh-CN/docs/Web/API/ElementInternals/ariaColIndex) 属性是 {{domxref("ElementInternals")}} 接口的一部分,反映了 `aria-colindex` 属性的值。
+ - : [`ariaColIndex`](/zh-CN/docs/Web/API/ElementInternals/ariaColIndex) 属性(属于 {{domxref("ElementInternals")}} 接口)反映了 `aria-colindex` 属性的值。
## 关联角色
@@ -95,7 +95,8 @@ ARIA 使用的第一条规则是:“如果你可以使用具有你所需语义
- [`cell`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/cell_role)
- [`row`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/row_role)
- 继承到角色:
+
+继承到角色:
- [`columnheader`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/columnheader_role)
- [`gridcell`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/gridcell_role)