Skip to content

Commit

Permalink
fix broken links to learning-area repo main branch (#14084)
Browse files Browse the repository at this point in the history
  • Loading branch information
yin1999 authored Jul 9, 2023
1 parent 2066750 commit 555aa50
Show file tree
Hide file tree
Showing 50 changed files with 162 additions and 162 deletions.
10 changes: 5 additions & 5 deletions files/zh-cn/learn/accessibility/css_and_javascript/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -161,7 +161,7 @@ a:active {
</div>
```

你可以在我们的 [form-css.html](https://github.com/mdn/learning-area/blob/master/accessibility/css/form-css.html) 示例中看到一些很好的示例 CSS([查看示例](http://mdn.github.io/learning-area/accessibility/css/form-css.html))。
你可以在我们的 [form-css.html](https://github.com/mdn/learning-area/blob/main/accessibility/css/form-css.html) 示例中看到一些很好的示例 CSS([查看示例](http://mdn.github.io/learning-area/accessibility/css/form-css.html))。

你将为表单编写的大多数 CSS 将用于调整元素大小、排列标签和输入,以及让它们看起来整洁。

Expand All @@ -171,7 +171,7 @@ a:active {

用于显示表格数据的表。

你可以在 [table-css.html](https://github.com/mdn/learning-area/blob/master/accessibility/css/table-css.html) 示例中看到表 HTML 和 CSS 的一个很好的简单示例([查看示例](http://mdn.github.io/learning-area/accessibility/css/table-css.html))。
你可以在 [table-css.html](https://github.com/mdn/learning-area/blob/main/accessibility/css/table-css.html) 示例中看到表 HTML 和 CSS 的一个很好的简单示例([查看示例](http://mdn.github.io/learning-area/accessibility/css/table-css.html))。

表的 CSS 通常使表更适合你的设计,看起来不那么难看。最好确保表标题醒目(通常使用粗体),并使用斑马条带化使不同的行更易于解析。

Expand All @@ -187,7 +187,7 @@ a:active {

### 隐藏的东西

在很多情况下,可视化设计需要并非同时显示所有内容。例如,在我们的 [Tabbed info box 示例](http://mdn.github.io/learning-area/css/css-layout/practical-positioning-examples/info-box.html)(参见[源码](https://github.com/mdn/learning-area/blob/master/css/css-layout/practical-positioning-examples/info-box.html)),我们有三个信息面板,但我们将它们放在彼此之上,并提供可以单击以显示每个选项卡的选项卡(也可以使用键盘——你也可以使用 Tab 和 Enter/Return 以选择它们)。
在很多情况下,可视化设计需要并非同时显示所有内容。例如,在我们的 [Tabbed info box 示例](http://mdn.github.io/learning-area/css/css-layout/practical-positioning-examples/info-box.html)(参见[源码](https://github.com/mdn/learning-area/blob/main/css/css-layout/practical-positioning-examples/info-box.html)),我们有三个信息面板,但我们将它们放在彼此之上,并提供可以单击以显示每个选项卡的选项卡(也可以使用键盘——你也可以使用 Tab 和 Enter/Return 以选择它们)。

![](tabbed-info-box.png)

Expand Down Expand Up @@ -238,7 +238,7 @@ JavaScript 还可能会中断无障碍,具体取决于其使用方式。
- 提供客户端表单验证,它快速提醒用户表单条目出现的问题,而无需等待服务器检查数据。如果表单不可用,则窗口仍然有效,但验证速度可能较慢。
- 为 HTML5 `<video>` 提供自定义控件,这些控件仅供键盘用户访问,以及如果 JavaScript 不可用 (默认 `<video>` 浏览器控件在大多数浏览器中无法使用键盘访问),就直接通过链接访问视频。

例如,我们编写了一个快速而糟糕的客户端客户端表单验证示例——参见[form-validation.html](https://github.com/mdn/learning-area/blob/master/accessibility/css/form-validation.html)[查看在线演示](http://mdn.github.io/learning-area/accessibility/css/form-validation.html))。在示例中,你会看到一个简单的表格;当你尝试提交一个或两个字段为空的表单时,提交将失败,并且会出现一个错误消息框,告诉你出了什么问题。
例如,我们编写了一个快速而糟糕的客户端客户端表单验证示例——参见[form-validation.html](https://github.com/mdn/learning-area/blob/main/accessibility/css/form-validation.html)[查看在线演示](http://mdn.github.io/learning-area/accessibility/css/form-validation.html))。在示例中,你会看到一个简单的表格;当你尝试提交一个或两个字段为空的表单时,提交将失败,并且会出现一个错误消息框,告诉你出了什么问题。

这种表单验证并不引人注目——在 JavaScript 不可用的情况下,你仍然可以很好的使用表单,并且任何合理的表单实现都将激活服务器端验证,因为恶意用户很容易绕过客户端验证(例如,通过在浏览器中关闭 JavaScript)。客户端验证对于报告错误仍然非常有用——用户可以立即了解他们所犯的错误,而不必等待到服务器的往返和页面重新加载。这是一个明确的可用性优势。

Expand Down Expand Up @@ -327,7 +327,7 @@ function createLink(testItem) {

让我们看一个示例:突出显示了何时可能有用。我们想要实现一个缩略图:当鼠标悬停或聚焦在图像上,可以放大图像(正如电子商务产品目录所展示的)。

我们做了一个非常简单的示例,你可以在 [mouse-and-keyboard-events.html](http://mdn.github.io/learning-area/accessibility/css/mouse-and-keyboard-events.html) 中找到(参见[源码](https://github.com/mdn/learning-area/blob/master/accessibility/css/mouse-and-keyboard-events.html))。该代码具有显示和隐藏放大图像的两个函数。它由以下几行行实现,这些行将它们设置为事件处理程序:
我们做了一个非常简单的示例,你可以在 [mouse-and-keyboard-events.html](http://mdn.github.io/learning-area/accessibility/css/mouse-and-keyboard-events.html) 中找到(参见[源码](https://github.com/mdn/learning-area/blob/main/accessibility/css/mouse-and-keyboard-events.html))。该代码具有显示和隐藏放大图像的两个函数。它由以下几行行实现,这些行将它们设置为事件处理程序:

```js
imgThumb.onmouseover = showImg;
Expand Down
6 changes: 3 additions & 3 deletions files/zh-cn/learn/accessibility/html/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -256,7 +256,7 @@ This is the second subsection of my content. I think is more interesting than th

通过 UI 控件,我们指的是与用户交互的 Web 文档的主要部分 - 通常是按钮,链接和表单控件。在本节中,我们将介绍创建此类控件时要注意的基本无障碍问题。稍后关于 WAI-ARIA 和多媒体的文章将着眼于 UI 无障碍的其他方面。

UI 控件无障碍的一个关键方面是,默认情况下,浏览器允许用户通过键盘操作它们。您可以使用我们的 [native-keyboard-accessibility.html](http://mdn.github.io/learning-area/tools-testing/cross-browser-testing/accessibility/native-keyboard-accessibility.html) 示例(请参阅 [源代码](https://github.com/mdn/learning-area/blob/master/tools-testing/cross-browser-testing/accessibility/native-keyboard-accessibility.html) )。尝试此操作 - 在新选项卡中打开此项,然后尝试按 Tab 键; 几次按下后,您应该看到标签焦点开始移动到不同的元素; 在每个浏览器中,获得焦点元素都会有一个“突出显示“的默认样式(它在不同浏览器之间略有不同),以便您可以确定当前哪些元素获得焦点。
UI 控件无障碍的一个关键方面是,默认情况下,浏览器允许用户通过键盘操作它们。您可以使用我们的 [native-keyboard-accessibility.html](http://mdn.github.io/learning-area/tools-testing/cross-browser-testing/accessibility/native-keyboard-accessibility.html) 示例(请参阅 [源代码](https://github.com/mdn/learning-area/blob/main/tools-testing/cross-browser-testing/accessibility/native-keyboard-accessibility.html) )。尝试此操作 - 在新选项卡中打开此项,然后尝试按 Tab 键; 几次按下后,您应该看到标签焦点开始移动到不同的元素; 在每个浏览器中,获得焦点元素都会有一个“突出显示“的默认样式(它在不同浏览器之间略有不同),以便您可以确定当前哪些元素获得焦点。

![](button-focused-unfocused.png)

Expand Down Expand Up @@ -318,7 +318,7 @@ UI 控件无障碍的一个关键方面是,默认情况下,浏览器允许

#### 重新建立键盘的无障碍

重新添加这些优点需要一些工作(您可以在我们的 [fake-div-buttons.html](http://mdn.github.io/learning-area/tools-testing/cross-browser-testing/accessibility/fake-div-buttons.html) 示例中使用示例代码 - 另请参阅 [源代码](https://github.com/mdn/learning-area/blob/master/tools-testing/cross-browser-testing/accessibility/fake-div-buttons.html) )。在这里,我们通过赋予每个 `<div>` 按钮属性`tabindex =“0”` 来使它能够被聚焦(包括通过选项卡):
重新添加这些优点需要一些工作(您可以在我们的 [fake-div-buttons.html](http://mdn.github.io/learning-area/tools-testing/cross-browser-testing/accessibility/fake-div-buttons.html) 示例中使用示例代码 - 另请参阅 [源代码](https://github.com/mdn/learning-area/blob/main/tools-testing/cross-browser-testing/accessibility/fake-div-buttons.html) )。在这里,我们通过赋予每个 `<div>` 按钮属性`tabindex =“0”` 来使它能够被聚焦(包括通过选项卡):

```html
<div data-message="This is from the first button" tabindex="0">Click me!</div>
Expand Down Expand Up @@ -427,7 +427,7 @@ Fill in your name: <input type="text" id="name" name="name">

但是这有问题 - 屏幕阅读器用户无法将行或列作为数据分组关联在一起。要做到这一点,你需要知道标题行是什么,以及它们是否在行,列等标题上。这只能在上面的表中以可视化方式完成(参见 [bad-table.html](http://mdn.github.io/learning-area/accessibility/html/bad-table.html) ,并自己尝试这个例子)。

现在看看我们的 [punk bands table example](https://github.com/mdn/learning-area/blob/master/css/styling-boxes/styling-tables/punk-bands-complete.html) - 您可以在这里看到一些辅助工具(accessibility aids):
现在看看我们的 [punk bands table example](https://github.com/mdn/learning-area/blob/main/css/styling-boxes/styling-tables/punk-bands-complete.html) - 您可以在这里看到一些辅助工具(accessibility aids):

- 表头使用 `{{htmlelement("th")}}` 元素定义 - 您还可以使用 `scope` 属性指定它们是行还是列的标题。这提供给了屏幕阅读器可以理解的完整数据组。
- `{{htmlelement("caption")}}` 元素和 `<table>` `summary` 属性都执行类似的工作 - 它们充当表格的替代文本,为屏幕阅读器用户提供有用的表格内容快速摘要。 `<caption>` 通常是首选,因为它使内容可供视力良好的用户访问,而且他们也可能会发现它很有用。你并不需要两者都使用!。
Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/learn/accessibility/multimedia/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -91,7 +91,7 @@ HTML5 视频和音频共享 API — HTML Media Element — 允许您将自定义

#### 基本设置

首先,获取我们的[custom-controls-start.html](https://github.com/mdn/learning-area/blob/master/accessibility/multimedia/custom-controls-start.html)[custom-controls.css](https://github.com/mdn/learning-area/blob/master/accessibility/multimedia/custom-controls.css)[rabbit320.mp4](https://raw.githubusercontent.com/mdn/learning-area/master/accessibility/multimedia/rabbit320.mp4)[rabbit320.webm](https://raw.githubusercontent.com/mdn/learning-area/master/accessibility/multimedia/rabbit320.webm)文件的副本,并将它们保存在硬盘上的新目录中。
首先,获取我们的[custom-controls-start.html](https://github.com/mdn/learning-area/blob/main/accessibility/multimedia/custom-controls-start.html)[custom-controls.css](https://github.com/mdn/learning-area/blob/main/accessibility/multimedia/custom-controls.css)[rabbit320.mp4](https://raw.githubusercontent.com/mdn/learning-area/main/accessibility/multimedia/rabbit320.mp4)[rabbit320.webm](https://raw.githubusercontent.com/mdn/learning-area/main/accessibility/multimedia/rabbit320.webm)文件的副本,并将它们保存在硬盘上的新目录中。

创建一个名为 main.js 的新文件并将其保存在同一目录中。

Expand Down
14 changes: 7 additions & 7 deletions files/zh-cn/learn/accessibility/wai-aria_basics/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -190,7 +190,7 @@ WAI-ARIA 给浏览器增加了 [`role`](https://www.w3.org/TR/wai-aria-1.1/#role

问题在于现代 Web 应用程序通常不仅仅是静态文本——它们往往有很多动态更新内容,即通过 [XMLHttpRequest](/zh-CN/docs/Web/API/XMLHttpRequest)[Fetch](/zh-CN/docs/Web/API/Fetch_API)[DOM API](/zh-CN/docs/Web/API/Document_Object_Model) 等机制重新加载整个页面的内容。这些有时被称为**实时区域**

我们来看一个小例子—— [aria-no-live.html](https://github.com/mdn/learning-area/blob/master/accessibility/aria/aria-no-live.html) ([在线 demo](http://mdn.github.io/learning-area/accessibility/aria/aria-no-live.html))。在这个例子我们哟一个小的随机引用块:
我们来看一个小例子—— [aria-no-live.html](https://github.com/mdn/learning-area/blob/main/accessibility/aria/aria-no-live.html) ([在线 demo](http://mdn.github.io/learning-area/accessibility/aria/aria-no-live.html))。在这个例子我们哟一个小的随机引用块:

```html
<section>
Expand Down Expand Up @@ -218,7 +218,7 @@ var intervalID = window.setInterval(showQuote, 10000);

通常来说 `assertive` 设置足以让你的更新在显示时按时序读出,因此,如果改变多次,那么他只会念出最后一个改变。除非紧急程度高到需要覆盖其他的更新才选择使用 `rude`

我们可以复制 [aria-no-live.html](https://github.com/mdn/learning-area/blob/master/accessibility/aria/aria-no-live.html)[quotes.json](https://github.com/mdn/learning-area/blob/master/accessibility/aria/quotes.json) ,然后像下面一样更新你的 `<section>` tag :
我们可以复制 [aria-no-live.html](https://github.com/mdn/learning-area/blob/main/accessibility/aria/aria-no-live.html)[quotes.json](https://github.com/mdn/learning-area/blob/main/accessibility/aria/quotes.json) ,然后像下面一样更新你的 `<section>` tag :

```html
<section aria-live="assertive">
Expand All @@ -236,7 +236,7 @@ var intervalID = window.setInterval(showQuote, 10000);

这个 `aria-atomic="true"` 属性告诉屏幕阅读器去读取整个元素的内容作为一个原子单位,而不是里头某个字符串更新了。

> **备注:** 你可在此完成此例子 [aria-live.html](https://github.com/mdn/learning-area/blob/master/accessibility/aria/aria-live.html) ([在线 demo](http://mdn.github.io/learning-area/accessibility/aria/aria-live.html)).
> **备注:** 你可在此完成此例子 [aria-live.html](https://github.com/mdn/learning-area/blob/main/accessibility/aria/aria-live.html) ([在线 demo](http://mdn.github.io/learning-area/accessibility/aria/aria-live.html)).
> **备注:** [`aria-relevant`](https://www.w3.org/TR/wai-aria-1.1/#aria-relevant) 属性对于控制更新实时区域时读取的内容也非常有用。例如,你读取内容添加或删除。
Expand Down Expand Up @@ -274,7 +274,7 @@ var intervalID = window.setInterval(showQuote, 10000);

我们可以在 ARIA 的应用上更进一步,并提供更多验证上的帮助。例如支出某个字段是否必填,或者是要填的年龄的区间该是多少?

1. 首先,复制刚刚的 [form-validation.html](https://github.com/mdn/learning-area/blob/master/accessibility/css/form-validation.html) 还有 [validation.js](https://github.com/mdn/learning-area/blob/master/accessibility/css/validation.js) 文件,然后保存到本地。
1. 首先,复制刚刚的 [form-validation.html](https://github.com/mdn/learning-area/blob/main/accessibility/css/form-validation.html) 还有 [validation.js](https://github.com/mdn/learning-area/blob/main/accessibility/css/validation.js) 文件,然后保存到本地。
2. 把两个文件都用文本编辑器打开并且看看运作原理。
3. 首先,在`<form>` 标签的正上方添加一个段落,如下,并用星号标记表单\<label>。这通常是我们为有视力的用户标记必填字段的一个常用手法。

Expand Down Expand Up @@ -335,7 +335,7 @@ function toggleMusician(bool) {

但是屏幕阅读器呢?他们还是看着这个元素并不是一个 button,如果你用屏幕阅读器测试我们的 [fake-div-buttons.html](http://mdn.github.io/learning-area/tools-testing/cross-browser-testing/accessibility/fake-div-buttons.html) 例子,你会听到一段短语描述这个按钮,内容大概是 "Click me!, group",显然这会让人疑惑。

依旧,WAI-ARIA 的角色可以解决一切,复制文件 [fake-div-buttons.html](https://github.com/mdn/learning-area/blob/master/tools-testing/cross-browser-testing/accessibility/fake-div-buttons.html),然后加上 [`role="button"`](https://www.w3.org/TR/wai-aria-1.1/#button) 到每一个 button `<div>`,如下所示
依旧,WAI-ARIA 的角色可以解决一切,复制文件 [fake-div-buttons.html](https://github.com/mdn/learning-area/blob/main/tools-testing/cross-browser-testing/accessibility/fake-div-buttons.html),然后加上 [`role="button"`](https://www.w3.org/TR/wai-aria-1.1/#button) 到每一个 button `<div>`,如下所示

```html
<div data-message="This is from the first button" tabindex="0" role="button">Click me!</div>
Expand All @@ -349,11 +349,11 @@ function toggleMusician(bool) {

还有许多其他 [roles](https://www.w3.org/TR/wai-aria-1.1/#role_definitions) 可以将非语义元素结构识别为常见的 UI 功能,这些功能超出了标准 HTML 中可用的功能,例如 [`combobox`](https://www.w3.org/TR/wai-aria-1.1/#combobox), [`slider`](https://www.w3.org/TR/wai-aria-1.1/#slider), [`tabpanel`](https://www.w3.org/TR/wai-aria-1.1/#tabpanel), [`tree`](https://www.w3.org/TR/wai-aria-1.1/#tree).。你可以在 [Deque university code library](https://dequeuniversity.com/library/) 中看到许多有用的示例,以便了解如何使这些控件做到无障碍的。

让我们来看看我们自己的一个例子。我们将返回到我们简单的绝对定位选项卡界面(请参阅我们的 CSS 和 JavaScript 无障碍的文章的 [Hiding things](/zh-CN/docs/Learn/Accessibility/CSS_and_JavaScript#Hiding_things) 段落),你可以在 [Tabbed info box example](http://mdn.github.io/learning-area/css/css-layout/practical-positioning-examples/info-box.html)中找到它([源码地址](https://github.com/mdn/learning-area/blob/master/css/css-layout/practical-positioning-examples/info-box.html))。
让我们来看看我们自己的一个例子。我们将返回到我们简单的绝对定位选项卡界面(请参阅我们的 CSS 和 JavaScript 无障碍的文章的 [Hiding things](/zh-CN/docs/Learn/Accessibility/CSS_and_JavaScript#Hiding_things) 段落),你可以在 [Tabbed info box example](http://mdn.github.io/learning-area/css/css-layout/practical-positioning-examples/info-box.html)中找到它([源码地址](https://github.com/mdn/learning-area/blob/main/css/css-layout/practical-positioning-examples/info-box.html))。

这个例子在键盘无障碍方面运行良好 —— 你可以愉快地在不同选项卡之间进行 tab 并选择它们然后显示选项卡内容。它也是相当容易访问的 —— 你可以滚动浏览内容并使用标题进行导航,即使你无法看到屏幕上发生的事情。然而,内容并不明显 —— 屏幕阅读器目前将内容报告为链接列表,以及一些内容包含三个标题。它不会让你知道内容之间的关系。为用户提供有关内容结构的更多线索总是好的。

为了优化它,我们创建了一个新的例子,名为: [aria-tabbed-info-box.html](https://github.com/mdn/learning-area/blob/master/accessibility/aria/aria-tabbed-info-box.html) ([看在线 demo](http://mdn.github.io/learning-area/accessibility/aria/aria-tabbed-info-box.html)). 我们更新了选项卡式界面的结构,如下所示:
为了优化它,我们创建了一个新的例子,名为: [aria-tabbed-info-box.html](https://github.com/mdn/learning-area/blob/main/accessibility/aria/aria-tabbed-info-box.html) ([看在线 demo](http://mdn.github.io/learning-area/accessibility/aria/aria-tabbed-info-box.html)). 我们更新了选项卡式界面的结构,如下所示:

```html
<ul role="tablist">
Expand Down
Loading

0 comments on commit 555aa50

Please sign in to comment.