From b4375e87b6f6fdac8bf837dcb1a6c6b7f7f24650 Mon Sep 17 00:00:00 2001 From: Tianyi Tao Date: Wed, 18 Sep 2024 09:17:24 +0800 Subject: [PATCH] Apply suggestions from code review Co-authored-by: A1lo --- .../aria/attributes/aria-colspan/index.md | 30 +++++++++---------- 1 file changed, 15 insertions(+), 15 deletions(-) diff --git a/files/zh-cn/web/accessibility/aria/attributes/aria-colspan/index.md b/files/zh-cn/web/accessibility/aria/attributes/aria-colspan/index.md index 5bb7cce0ee6c77..d121fec8459101 100644 --- a/files/zh-cn/web/accessibility/aria/attributes/aria-colspan/index.md +++ b/files/zh-cn/web/accessibility/aria/attributes/aria-colspan/index.md @@ -11,37 +11,37 @@ l10n: ## 描述 -`aria-colspan` 主要用于不包含在原生 HTML {{HTMLElement('table')}} 中的 [`cell`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/cell_role) 和 [`gridcell`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/gridcell_role)。该属性值定义了一个单元格在 ARIA [`table`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/table_role)、[`grid`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/grid_role) 或 [`treegrid`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/treegrid_role) 中跨越的列数。 +`aria-colspan` 主要用于不包含在原生 HTML {{HTMLElement('table')}} 中的 [`cell`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/cell_role) 和 [`gridcell`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/gridcell_role)，该属性值定义了一个单元格在 ARIA [`table`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/table_role)、[`grid`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/grid_role) 或 [`treegrid`](/zh-CN/docs/Web/Accessibility/ARIA/Roles/treegrid_role) 中跨越的列数。 在 HTML 中，{{HTMLElement('th')}} 和 {{HTMLElement('td')}} 元素具有 [`colspan`](/zh-CN/docs/Web/HTML/Element/td#attributes) 属性。当使用语义化的 {{HTMLElement('table')}} 时，按设计使用原生的 `colspan` 属性即可。此 ARIA 属性用于不包含在原生表格中的单元格和网格单元格，如果用于 {{HTMLElement('table')}} 中的单元格，将被忽略。 > [!NOTE] -> 使用 ARIA 的首要规则是，如果可以使用具有所需语义和行为的原生功能，而不是重新定义元素并**添加** ARIA 角色、状态或属性使其可访问，那么就这样做。尽可能使用 HTML {{HTMLelement('table')}} 元素，包括 {{HTMLelement('td')}} 和 {{HTMLelement('th')}} 以及 `colspan` 属性，而不是带有 ARIA 角色和属性的非语义元素。 +> 使用 ARIA 的首要规则是，如果可以使用具有所需语义和行为的原生特性，而不是重新定义元素并**添加** ARIA 角色、状态或属性使其变得无障碍，那么就这样做。尽可能使用 HTML {{HTMLelement('table')}} 元素（包括 {{HTMLelement('td')}} 和 {{HTMLelement('th')}} 以及 `colspan` 属性），而不是带有 ARIA 角色和属性的非语义元素。 `aria-colspan` 的值应为正整数。单元格跨越的默认或假定值为 1。确保所包含的值不会导致单元格或网格单元格与同一行中的下一个单元格重叠，也不会导致单元格跨越超出包含的表格、网格或树网格。 ## 示例 -以下是一个保龄球锦标赛联赛计分表的部分示例。每场比赛跨越 10 个回合，每个回合跨越 3 个分数：两球和当前总分。每场比赛的第 10 个（也是最后一个）回合跨越 4 列，以防有人计分全中。 +以下是一个保龄球锦标赛联赛计分表的部分示例。每场比赛跨越 10 计分格（frame），每个计分格跨越 3 个分数：两球和当前总分。每场比赛的第 10 个（也是最后一个）计分格跨越 4 列，以防有人记全倒。 ```html
- Team - Player - Game 1 Frames - Game 2 Frames - Game 3 Frames - Total + 队伍 + 玩家 + 第 1 局计分格 + 第 2 局计分格 + 第 3 局计分格 + 合计
- Last Name - First Name + 姓 + 名 1 2 3 @@ -76,7 +76,7 @@ l10n:
- The Mighty Quokkas + 强力短尾矮袋鼠队 Henderson Alice 7 @@ -132,14 +132,14 @@ l10n:
``` -如果我们使用 {{HTMLElement('table')}} 和语义化的表格元素，我们的标记将会更简洁，并且默认具有可访问性。 +如果我们使用 {{HTMLElement('table')}} 和语义化的表格元素，我们的标记将会更简洁，并且默认具有无障碍性。 ## 值 - `` - : 一个大于或等于默认值 1 的整数，定义单元格跨越的列数。该值必须小于会导致单元格与同一行中的下一个单元格重叠的数值。 -## 关联接口 +## 相关接口 - {{domxref("Element.ariaColSpan")}} - : [`ariaColSpan`](/zh-CN/docs/Web/API/Element/ariaColSpan) 属性，作为每个元素接口的一部分，反映了 `aria-colspan` 属性的值，该属性定义了单元格或网格单元格在表格、网格或树网格中跨越的列数。