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)