From a113177992e0bfc2d550672b1359e92132543e3f Mon Sep 17 00:00:00 2001 From: Tianyi Tao <146603607+tianyeeT@users.noreply.github.com> Date: Wed, 29 May 2024 21:20:05 +0800 Subject: [PATCH 1/2] [zh-cn]: create the translation of `aria-colindextext` --- .../attributes/aria-colindextext/index.md | 98 +++++++++++++++++++ 1 file changed, 98 insertions(+) create mode 100644 files/zh-cn/web/accessibility/aria/attributes/aria-colindextext/index.md diff --git a/files/zh-cn/web/accessibility/aria/attributes/aria-colindextext/index.md b/files/zh-cn/web/accessibility/aria/attributes/aria-colindextext/index.md new file mode 100644 index 00000000000000..9d023095a000b6 --- /dev/null +++ b/files/zh-cn/web/accessibility/aria/attributes/aria-colindextext/index.md @@ -0,0 +1,98 @@ +--- +title: aria-colindextext +slug: Web/Accessibility/ARIA/Attributes/aria-colindextext +l10n: + sourceCommit: 019ca5c9ce641bfa02825e1ba0444f35dfb646cc +--- + +{{AccessibilitySidebar}} + +`aria-colindextext` 属性定义了数字 [`aria-colindex`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colindex) 的可读文本替代。 + +## 描述 + +当你有一个非常大的表格，或者当你有意地只想显示表格的一部分时，可能不是所有的列都会出现在 DOM 中。当出现这种情况时，我们使用具有整数值的 [`aria-colcount`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colcount) 来定义表格（或网格）如果所有列都存在时会有多少列，并在每一列上添加 [`aria-colindex`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colindex) 属性，以提供有关该较大表格中列索引的信息。 + +在下面的 HTML 片段中，我们的表格有 8 列，但我们只显示了 4 列。“城市”列是我们较大表格的第五列，由 `aria-colindex="5"` 定义。 + +```html + + + + + + + + + + … +
First nameLast nameCityZip
+``` + +这个表格并不是很复杂。如果这是一个拥有 100 多列的电子表格，或者是一个没有列标题的网格，比如象棋棋盘，那么 `aria-colindex` 的提供或计算出的值可能不具有意义，或者可能不反映出显示的索引。在这种情况下，可以包含 `aria-colindextext`。该值是一个字符串，是数字 `aria-colindex` 的可读文本替代。 + +```html + + + + + + + + + + … +
+ NYSE + + 01/21 + + 01/22 + 推荐
+``` + +在上面的示例中，表格有 128 列，但只显示了 4 列。`aria-colindextext` 在三列中使用，提供了可读的文本替代。通过包含 `aria-colindextext="2021 年初价值"`，辅助技术可以宣布“2021 年初价值”，而不是“列 110”。 + +只有在提供或计算的 `aria-colindex` 的值不具有意义或不反映出显示的索引时，才使用 `aria-colindextext`。每当包含 `aria-colindextext` 时，也要保留 `aria-colindex`，因为一些辅助技术依赖于数字列索引来跟踪用户的位置，并提供替代的表格导航。 + +> **备注：** 虽然当所有存在的列都是连续的时，`aria-colindex` 可以添加到行中，因为可以推断出顺序值，但 `aria-colindextext` 不是 [`row`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/row_role) 的受支持属性。 + +请参阅相关的 [`aria-rowindextext`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-rowindextext)。 + +## 值 + +- `` + - 数字 [`aria-colindex`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colindex) 的可读文本替代 + +## 关联接口 + +- {{domxref("Element.ariaColIndexText")}} + - ：{{domxref("Element")}} 接口的一部分，反映了 [`ariaColIndexText`](/zh-CN/docs/Web/API/Element/ariaColIndexText) 属性的值。 +- {{domxref("ElementInternals.ariaColIndexText")}} + - ：{{domxref("ElementInternals")}} 接口的一部分，反映了 [`ariaColIndexText`](/zh-CN/docs/Web/API/Element/ariaColIndexText) 属性的值。 + +## 关联角色 + +用于角色： + +- [`cell`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/cell_role) + 继承到角色： +- [`columnheader`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/columnheader_role) +- [`rowheader`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/columnheader_role) + +## 规范 + +{{Specifications}} + +## 参见 + +- [`Element.ariaColIndexText`](/zh-CN/docs/Web/API/Element/ariaColIndexText) +- [`aria-colindex`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colindex) +- [`aria-rowindextext`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-rowindextext) +- [`aria-colcount`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colcount) +- [`cell` 角色](/zh-CN/docs/Web/Accessibility/ARIA/Roles/cell_role) +- [`columnheader` 角色](/zh-CN/docs/Web/Accessibility/ARIA/Roles/columnheader_role) +- [`rowheader` 角色](/zh-CN/docs/Web/Accessibility/ARIA/Roles/columnheader_role) From 8202d554bb84dd776269090fa94a07851ca65932 Mon Sep 17 00:00:00 2001 From: Allo Date: Sat, 15 Jun 2024 09:42:12 +0800 Subject: [PATCH 2/2] minor fixes --- .../attributes/aria-colindextext/index.md | 26 ++++++++++--------- 1 file changed, 14 insertions(+), 12 deletions(-) diff --git a/files/zh-cn/web/accessibility/aria/attributes/aria-colindextext/index.md b/files/zh-cn/web/accessibility/aria/attributes/aria-colindextext/index.md index 9d023095a000b6..78b6fd2d85a45b 100644 --- a/files/zh-cn/web/accessibility/aria/attributes/aria-colindextext/index.md +++ b/files/zh-cn/web/accessibility/aria/attributes/aria-colindextext/index.md @@ -11,7 +11,7 @@ l10n: ## 描述 -当你有一个非常大的表格，或者当你有意地只想显示表格的一部分时，可能不是所有的列都会出现在 DOM 中。当出现这种情况时，我们使用具有整数值的 [`aria-colcount`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colcount) 来定义表格（或网格）如果所有列都存在时会有多少列，并在每一列上添加 [`aria-colindex`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colindex) 属性，以提供有关该较大表格中列索引的信息。 +当你有一个非常大的表格，或者当你有意地只想显示表格的一部分时，可能不是所有的列都会出现在 DOM 中。当出现这种情况时，我们使用具有整数值的 [`aria-colcount`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colcount) 来定义表格（或网格）在所有列都存在时会有多少列，并在每一列上添加 [`aria-colindex`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colindex) 属性，以提供有关该较大表格中列索引的信息。 在下面的 HTML 片段中，我们的表格有 8 列，但我们只显示了 4 列。“城市”列是我们较大表格的第五列，由 `aria-colindex="5"` 定义。 @@ -19,10 +19,10 @@ l10n: - - - - + + + + … @@ -41,10 +41,10 @@ l10n: scope="col"> NYSE - - @@ -54,7 +54,7 @@ l10n:
First nameLast nameCityZip名字姓氏城市邮编
+ 01/21 + 01/22 推荐
``` -在上面的示例中，表格有 128 列，但只显示了 4 列。`aria-colindextext` 在三列中使用，提供了可读的文本替代。通过包含 `aria-colindextext="2021 年初价值"`，辅助技术可以宣布“2021 年初价值”，而不是“列 110”。 +在上面的示例中，表格有 128 列，但只显示了 4 列。`aria-colindextext` 在三列中使用，提供了可读的文本替代。通过包含 `aria-colindextext="2021 年初值"`，辅助技术可以宣告“2021 年初值”，而不是“110 列”。 只有在提供或计算的 `aria-colindex` 的值不具有意义或不反映出显示的索引时，才使用 `aria-colindextext`。每当包含 `aria-colindextext` 时，也要保留 `aria-colindex`，因为一些辅助技术依赖于数字列索引来跟踪用户的位置，并提供替代的表格导航。 @@ -65,21 +65,23 @@ l10n: ## 值 - `` - - 数字 [`aria-colindex`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colindex) 的可读文本替代 + - : 数字 [`aria-colindex`](/zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-colindex) 的可读文本替代 ## 关联接口 - {{domxref("Element.ariaColIndexText")}} - - ：{{domxref("Element")}} 接口的一部分，反映了 [`ariaColIndexText`](/zh-CN/docs/Web/API/Element/ariaColIndexText) 属性的值。 + - : {{domxref("Element")}} 接口的 [`ariaColIndexText`](/zh-CN/docs/Web/API/Element/ariaColIndexText) 属性，反映了 HTML 属性 `aria-colindextext` 的值。 - {{domxref("ElementInternals.ariaColIndexText")}} - - ：{{domxref("ElementInternals")}} 接口的一部分，反映了 [`ariaColIndexText`](/zh-CN/docs/Web/API/Element/ariaColIndexText) 属性的值。 + - : {{domxref("ElementInternals")}} 接口的 [`ariaColIndexText`](/zh-CN/docs/Web/API/ElementInternals/ariaColIndexText) 属性反映了 HTML 属性 `aria-colindextext` 的值。 ## 关联角色 用于角色： - [`cell`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/cell_role) - 继承到角色： + +继承到角色： + - [`columnheader`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/columnheader_role) - [`rowheader`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/columnheader_role)