Skip to content

Commit

Permalink
[zh-cn] sync translated content (#17266)
Browse files Browse the repository at this point in the history
* zh-cn: sync translated content

* Redirect Web/Guide/Performance to Web/Performance

ref: mdn/content#30767

* Move audio and video guides under Web/Media

ref: mdn/content#30766

---------

Co-authored-by: allo <[email protected]>
  • Loading branch information
mdn-bot and yin1999 authored Dec 5, 2023
1 parent db593a7 commit 6739b5a
Show file tree
Hide file tree
Showing 25 changed files with 111 additions and 143 deletions.
10 changes: 8 additions & 2 deletions files/zh-cn/_redirects.txt
Original file line number Diff line number Diff line change
Expand Up @@ -2033,8 +2033,8 @@
/zh-CN/docs/Web/Accessibility/ARIA/ARIA_Techniques/使用aria-hidden属性 /zh-CN/docs/Web/Accessibility/ARIA/Attributes/aria-hidden
/zh-CN/docs/Web/Accessibility/ARIA/forms /zh-CN/docs/Web/Accessibility/ARIA
/zh-CN/docs/Web/Accessibility/ARIA/forms/alerts /zh-CN/docs/Web/Accessibility/ARIA
/zh-CN/docs/Web/Apps/Fundamentals/Audio_and_video_delivery/WebAudio_playbackRate_explained /zh-CN/docs/Web/Guide/Audio_and_video_delivery/WebAudio_playbackRate_explained
/zh-CN/docs/Web/Apps/Fundamentals/Audio_and_video_delivery/buffering_seeking_time_ranges /zh-CN/docs/Web/Guide/Audio_and_video_delivery/buffering_seeking_time_ranges
/zh-CN/docs/Web/Apps/Fundamentals/Audio_and_video_delivery/WebAudio_playbackRate_explained /zh-CN/docs/Web/Media/Audio_and_video_delivery/WebAudio_playbackRate_explained
/zh-CN/docs/Web/Apps/Fundamentals/Audio_and_video_delivery/buffering_seeking_time_ranges /zh-CN/docs/Web/Media/Audio_and_video_delivery/buffering_seeking_time_ranges
/zh-CN/docs/Web/Apps/Fundamentals/Performance/Optimizing_startup_performance /zh-CN/docs/Web/Performance/Optimizing_startup_performance
/zh-CN/docs/Web/Apps/Progressive /zh-CN/docs/Web/Progressive_web_apps
/zh-CN/docs/Web/Apps/Progressive/App_structure /zh-CN/docs/Web/Progressive_web_apps/Tutorials/js13kGames/App_structure
Expand Down Expand Up @@ -2283,6 +2283,11 @@
/zh-CN/docs/Web/Guide/API /zh-CN/docs/Web/API
/zh-CN/docs/Web/Guide/API/DOM/The_structured_clone_algorithm /zh-CN/docs/Web/API/Web_Workers_API/Structured_clone_algorithm
/zh-CN/docs/Web/Guide/API/DOM/Whitespace_in_the_DOM /zh-CN/docs/Web/API/Document_Object_Model/Whitespace
/zh-CN/docs/Web/Guide/Audio_and_video_delivery/Adding_captions_and_subtitles_to_HTML5_video /zh-CN/docs/Web/Media/Audio_and_video_delivery/Adding_captions_and_subtitles_to_HTML5_video
/zh-CN/docs/Web/Guide/Audio_and_video_delivery/Live_streaming_web_audio_and_video /zh-CN/docs/Web/Media/Audio_and_video_delivery/Live_streaming_web_audio_and_video
/zh-CN/docs/Web/Guide/Audio_and_video_delivery/WebAudio_playbackRate_explained /zh-CN/docs/Web/Media/Audio_and_video_delivery/WebAudio_playbackRate_explained
/zh-CN/docs/Web/Guide/Audio_and_video_delivery/buffering_seeking_time_ranges /zh-CN/docs/Web/Media/Audio_and_video_delivery/buffering_seeking_time_ranges
/zh-CN/docs/Web/Guide/Audio_and_video_manipulation /zh-CN/docs/Web/Media/Audio_and_video_manipulation
/zh-CN/docs/Web/Guide/CSS /zh-CN/docs/Learn/CSS
/zh-CN/docs/Web/Guide/CSS/CSS_Image_Sprites /zh-CN/docs/Web/CSS/CSS_images/Implementing_image_sprites_in_CSS
/zh-CN/docs/Web/Guide/CSS/Consistent_list_indentation /zh-CN/docs/Web/CSS/CSS_lists/Consistent_list_indentation
Expand Down Expand Up @@ -2340,6 +2345,7 @@
/zh-CN/docs/Web/Guide/HTML/Tips_for_authoring_fast-loading_HTML_pages /zh-CN/docs/Learn/HTML/Howto/Author_fast-loading_HTML_pages
/zh-CN/docs/Web/Guide/HTML/Using_data_attributes /zh-CN/docs/Learn/HTML/Howto/Use_data_attributes
/zh-CN/docs/Web/Guide/Introduction_to_Web_development /zh-CN/docs/Learn
/zh-CN/docs/Web/Guide/Performance /zh-CN/docs/Web/Performance
/zh-CN/docs/Web/Guide/Performance/Using_web_workers /zh-CN/docs/Web/API/Web_Workers_API/Using_web_workers
/zh-CN/docs/Web/Guide/Printing /zh-CN/docs/Web/CSS/CSS_media_queries/Printing
/zh-CN/docs/Web/Guide/Using_FormData_Objects /zh-CN/docs/Web/API/XMLHttpRequest_API/Using_FormData_Objects
Expand Down
37 changes: 12 additions & 25 deletions files/zh-cn/_wikihistory.json
Original file line number Diff line number Diff line change
Expand Up @@ -20928,18 +20928,6 @@
"ethertank"
]
},
"Web/Guide/Audio_and_video_delivery/Adding_captions_and_subtitles_to_HTML5_video": {
"modified": "2020-10-27T07:00:04.677Z",
"contributors": ["ICLOUDIRIS", "FranzList"]
},
"Web/Guide/Audio_and_video_delivery/WebAudio_playbackRate_explained": {
"modified": "2019-03-18T20:51:41.158Z",
"contributors": ["chrisdavidmills", "dandanbu3"]
},
"Web/Guide/Audio_and_video_delivery/buffering_seeking_time_ranges": {
"modified": "2019-03-18T20:51:41.383Z",
"contributors": ["chrisdavidmills", "zhangqiong"]
},
"Web/Guide/CSS/Block_formatting_context": {
"modified": "2020-12-09T10:24:24.921Z",
"contributors": [
Expand Down Expand Up @@ -21005,19 +20993,6 @@
"modified": "2019-08-12T08:51:44.801Z",
"contributors": ["RainSlide", "haaling"]
},
"Web/Guide/Performance": {
"modified": "2020-10-09T03:08:14.338Z",
"contributors": [
"kite-js",
"SphinxKnight",
"Imagine-Tom",
"yexk",
"leozhang",
"sunnylost",
"DAVINDAI",
"ziyunfei"
]
},
"Web/HTML": {
"modified": "2020-05-18T02:45:10.401Z",
"contributors": [
Expand Down Expand Up @@ -31387,6 +31362,18 @@
"modified": "2019-08-30T07:28:45.901Z",
"contributors": ["Jwenee", "Forbidden"]
},
"Web/Media/Audio_and_video_delivery/Adding_captions_and_subtitles_to_HTML5_video": {
"modified": "2020-10-27T07:00:04.677Z",
"contributors": ["ICLOUDIRIS", "FranzList"]
},
"Web/Media/Audio_and_video_delivery/WebAudio_playbackRate_explained": {
"modified": "2019-03-18T20:51:41.158Z",
"contributors": ["chrisdavidmills", "dandanbu3"]
},
"Web/Media/Audio_and_video_delivery/buffering_seeking_time_ranges": {
"modified": "2019-03-18T20:51:41.383Z",
"contributors": ["chrisdavidmills", "zhangqiong"]
},
"Web/Media/Autoplay_guide": {
"modified": "2020-11-19T04:43:44.047Z",
"contributors": ["avrinfly", "baijingfeng"]
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -226,7 +226,7 @@ JavaScript 还可能会中断无障碍,具体取决于其使用方式。
简单的内容和功能可以说是很容易使访问——例如文本,图像,表格,窗体和按钮,激活功能。正如我们在 [HTML:辅助功能的良好基础](/zh-CN/docs/Learn/Accessibility/HTML)一文中提到的,主要注意事项包括:

- 良好的语义:为正确的工作使用正确的元素。例如,确保你使用标题和段落,以及 {{htmlelement("button")}} 和 {{htmlelement("a")}} 元素
- 确保内容以文本形式提供,要么直接作为文本内容、表单元素的良好文本标签,也可以确保[文本替代品](/zh-CN/docs/Learn/Accessibility/HTML#文本替代品)(例如图像的 alt 文本)。
- 确保内容以文本形式提供,要么直接作为文本内容、表单元素的良好文本标签,也可以确保[替代文本](/zh-CN/docs/Learn/Accessibility/HTML#替代文本)(例如图像的 alt 文本)。

我们还查看了如何使用 JavaScript 在缺少功能的地方构建的示例 , 参见[重新建立键盘的无障碍](/zh-CN/docs/Learn/Accessibility/HTML#重新建立键盘的无障碍)。这不是理想的——实际上,你应该只使用正确的元素为正确的作业——但它表明在情况下它是可能的,由于某种原因,你不能控制使用的标记。提高非语义 JavaScript 支持的小部件的无障碍的另一种方法是使用 WAI-ARIA 为屏幕阅读器用户提供额外的语义。下一篇文章还将详细介绍这一点。

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/learn/accessibility/html/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -443,7 +443,7 @@ Fill in your name: <input type="text" id="name" name="name" />

> **备注:** 有关可访问数据表的更多详细信息,请参阅我们的 [HTML 表格高级功能和无障碍](/zh-CN/docs/Learn/HTML/Tables/Advanced) 文章。
## 文本替代品
## 替代文本

尽管文本内容本身是可访问的,但对于多媒体内容而言也不一定是这样 - 图像/视频内容不能被视觉障碍人士看到,并且听觉障碍人士不能听到音频内容。稍后我们将在可访问多媒体文章中详细介绍视频和音频内容,但对于本文,我们将探讨低微(humble)的 `{{htmlelement("img")}}` 元素的无障碍。

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -112,7 +112,7 @@ slug: Learn/HTML/Multimedia_and_embedding/Images_in_HTML

本质上,关键在于在图片无法被看见时也提供一个可用的体验,这确保了所有人都不会错失一部分内容。尝试在浏览器中使图片不可见然后看看网页变成什么样了,你会很快意识到在图片无法显示时备选文本能帮上多大忙。

> **备注:** 想知道更多,可以看我们的[备选文本](/zh-CN/docs/Learn/Accessibility/HTML#文本替代品)指南
> **备注:** 想知道更多,可以看我们的[替代文本](/zh-CN/docs/Learn/Accessibility/HTML#替代文本)指南
### 宽度和高度

Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -173,11 +173,11 @@ select:focus {

替代文本对于无障碍非常重要 — 如果一个人有视觉或听觉障碍使他们无法看到或听到某些内容,那么这就是一个问题。可用的最简单的文本替代方法是`alt`属性,我们应该在所有包含相关内容的图像上包括该属性。其中应包含对图像的描述,该描述可在页面上成功传达其含义和内容,并由屏幕阅读器读取并读出给用户。

> **备注:** 更多信息请阅读[Text alternatives](/zh-CN/docs/learn/Accessibility/HTML:%E4%B8%BA%E5%8F%AF%E8%AE%BF%E9%97%AE%E6%80%A7%E6%8F%90%E4%BE%9B%E4%B8%80%E4%B8%AA%E8%89%AF%E5%A5%BD%E7%9A%84%E5%9F%BA%E7%A1%80#%E6%96%87%E6%9C%AC%E6%9B%BF%E4%BB%A3%E5%93%81)
> **备注:** 更多信息请阅读[替代文本](/zh-CN/docs/Learn/Accessibility/HTML#替代文本)
可以通过多种方法来测试缺少的替代文本,例如,使用无障碍[审计工具](#审计工具)

对于视频和音频内容,Alt 文本稍微复杂一些。有一种方法可以定义文本轨道(例如,字幕)并在播放视频时以{{htmlelement("track")}}元素和[WebVTT](/zh-CN/docs/Web/API/WebVTT_API)格式的形式显示它们(请参见[Adding captions and subtitles to HTML5 video](/zh-CN/docs/Web/Guide/Audio_and_video_delivery/Adding_captions_and_subtitles_to_HTML5_video)以获取详细信息)。这些功能的[浏览器兼容性](/zh-CN/docs/Web/Guide/Audio_and_video_delivery/Adding_captions_and_subtitles_to_HTML5_video#%E6%B5%8F%E8%A7%88%E5%99%A8%E5%85%BC%E5%AE%B9)相当好,但是如果你想提供音频的替代文本或支持较旧的浏览器,则在页面某处或单独页面上显示一个简单的文本记录可能是个好主意。
对于视频和音频内容,Alt 文本稍微复杂一些。有一种方法可以定义文本轨道(例如,字幕)并在播放视频时以 {{htmlelement("track")}} 元素和 [WebVTT](/zh-CN/docs/Web/API/WebVTT_API) 格式的形式显示它们(请参见[向 HTML 视频中添加字幕](/zh-CN/docs/Web/Media/Audio_and_video_delivery/Adding_captions_and_subtitles_to_HTML5_video#浏览器兼容性)相当好,但是如果你想提供音频的替代文本或支持较旧的浏览器,则在页面某处或单独页面上显示一个简单的文本记录可能是个好主意。

#### 元素关系和上下文

Expand Down
2 changes: 1 addition & 1 deletion files/zh-cn/mozilla/firefox/releases/32/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -49,7 +49,7 @@ Highlights:
- 实现了 {{domxref("KeyboardEvent.code")}} 属性,不过目前在正式版本中还是禁用状态 ([Firefox bug 865649](https://bugzil.la/865649))。
- Scoped selectors for {{domxref("Document.querySelector()")}} and {{domxref("Document.querySelectorAll()")}}, for example `querySelector(":scope > li")`have been implemented ([Firefox bug 528456](https://bugzil.la/528456)).
- The experimental implementation of the {{domxref("Document.timeline")}} interface, related to the [Web Animation API](http://dev.w3.org/fxtf/web-animations/), has been added ([Firefox bug 998246](https://bugzil.la/998246)). It is controlled by `layout.web-animations.api.enabled` preference, enabled only on Nightly and Aurora for the moment.
- The [Data Store API](/zh-CN/docs/Web/API/Data_Store_API) has been made available to [Web Workers](/zh-CN/docs/Web/Guide/Performance/Using_web_workers) ([Firefox bug 949325](https://bugzil.la/949325)). It still is only activated for certified applications.
- The [Data Store API](/zh-CN/docs/Web/API/Data_Store_API) has been made available to [Web Workers](/zh-CN/docs/Web/API/Web_Workers_API/Using_web_workers) ([Firefox bug 949325](https://bugzil.la/949325)). It still is only activated for certified applications.
- The [ServiceWorker](/zh-CN/docs/Web/API/ServiceWorker_API) {{domxref("InstallPhaseEvent")}} and {{domxref("InstallEvent")}} interfaces have been implemented ([Firefox bug 967264](https://bugzil.la/967264)).
- The [MSISDN Verification API](/zh-CN/docs/Web/API/MSISDN_Verification_API), only activated for privileged apps, has been added ([Firefox bug 988469](https://bugzil.la/988469)).
- The [Gamepad API](/zh-CN/docs/Web/API/Gamepad_API) is now supported on Firefox for Android ([Firefox bug 852935](https://bugzil.la/852935)).
Expand Down
8 changes: 4 additions & 4 deletions files/zh-cn/web/api/cache/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -115,8 +115,8 @@ self.addEventListener("fetch", function (event) {

## 参见

- [Using Service Workers](/zh-CN/docs/Web/API/ServiceWorker_API/Using_Service_Workers)
- [Service workers basic code example](https://github.com/mdn/sw-test)
- [Is ServiceWorker ready?](https://jakearchibald.github.io/isserviceworkerready/)
- [使用 Service Worker](/zh-CN/docs/Web/API/Service_Worker_API/Using_Service_Workers)
- [Service workers 基本代码示例](https://github.com/mdn/dom-examples/tree/main/service-worker/simple-service-worker)
- [是否支持 ServiceWorker](https://jakearchibald.github.io/isserviceworkerready/)
- {{jsxref("Promise")}}
- [Using web workers](/zh-CN/docs/Web/Guide/Performance/Using_web_workers)
- [使用 web worker](/zh-CN/docs/Web/API/Web_Workers_API/Using_web_workers)
4 changes: 2 additions & 2 deletions files/zh-cn/web/api/dedicatedworkerglobalscope/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -88,5 +88,5 @@ _该接口从 {{domxref("WorkerGlobalScope")}} 接口以及它的父接口 {{dom

- {{domxref("Worker")}}
- {{domxref("WorkerGlobalScope")}}
- [使用 web workers](/zh-CN/docs/Web/Guide/Performance/Using_web_workers)
- [Web Workers 可以使用的函数和类](/zh-CN/docs/Web/Guide/Needs_categorization/Functions_available_to_workers)
- [使用 web worker](/zh-CN/docs/Web/API/Web_Workers_API/Using_web_workers)
- [worker 可以使用的函数](/zh-CN/docs/Web/API/Web_Workers_API/Functions_and_classes_available_to_workers)
2 changes: 1 addition & 1 deletion files/zh-cn/web/api/errorevent/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -41,4 +41,4 @@ slug: Web/API/ErrorEvent

## 参见

- [使用 web worker](/zh-CN/docs/Web/Guide/Performance/Using_web_workers), most likely objects to raise such an event
- [使用 web worker](/zh-CN/docs/Web/API/Web_Workers_API/Using_web_workers),最有可能引发此事件的对象
18 changes: 10 additions & 8 deletions files/zh-cn/web/api/extendableevent/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -3,7 +3,9 @@ title: ExtendableEvent
slug: Web/API/ExtendableEvent
---

{{APIRef("Service Workers API")}}{{SeeCompatTable}}作为 service worker 生命周期的一部分,**`ExtendableEvent`** 接口延长了在全局范围上 [`install`](/zh-CN/docs/Web/API/ServiceWorkerGlobalScope/install_event)[`activate`](/zh-CN/docs/Web/API/ServiceWorkerGlobalScope/activate_event) 事件的生命周期。这样可以确保在升级数据库架构并删除过时的 caches 之前,不会调度任何函数事件(如{{domxref("FetchEvent")}})。如果在`ExtendableEvent`处理程序之外调用{{domxref("ExtendableEvent.waitUntil","waitUntil()")}},浏览器应该抛出一个`InvalidStateError`;还要注意,多个调用将堆积起来,结果 promises 将添加到[extend lifetime promises](https://slightlyoff.github.io/ServiceWorker/spec/service_worker/index.html#dfn-extend-lifetime-promises).
{{APIRef("Service Workers API")}}{{SeeCompatTable}}

作为 service worker 生命周期的一部分,**`ExtendableEvent`** 接口延长了在全局范围上 [`install`](/zh-CN/docs/Web/API/ServiceWorkerGlobalScope/install_event)[`activate`](/zh-CN/docs/Web/API/ServiceWorkerGlobalScope/activate_event) 事件的生命周期。这样可以确保在升级数据库架构并删除过时的 caches 之前,不会调度任何函数事件(如{{domxref("FetchEvent")}})。如果在`ExtendableEvent`处理程序之外调用{{domxref("ExtendableEvent.waitUntil","waitUntil()")}},浏览器应该抛出一个`InvalidStateError`;还要注意,多个调用将堆积起来,结果 promises 将添加到[extend lifetime promises](https://slightlyoff.github.io/ServiceWorker/spec/service_worker/index.html#dfn-extend-lifetime-promises).

> **备注:** 上述段落中描述的行为在 firefox 43 中得到了修复(参见 [Firefox bug 1180274](https://bugzil.la/1180274))。
Expand Down Expand Up @@ -78,18 +80,18 @@ self.addEventListener("install", function (event) {

> **备注:** 在获取资源时,如果有可能资源是由不支持 [CORS](http://en.wikipedia.org/wiki/Cross-origin_resource_sharing) 的服务器提供的,那么使用 `{mode: 'no-cors'}` 非常重要。在本例中, [www.chromium.org](http://www.chromium.org) 不支持 CORS。
## Specifications
## 规范

{{Specifications}}

## Browser compatibility
## 浏览器兼容性

{{Compat}}

## See also
## 参见

- [Using Service Workers](/zh-CN/docs/Web/API/ServiceWorker_API/Using_Service_Workers)
- [Service workers basic code example](https://github.com/mdn/sw-test)
- [Is ServiceWorker ready?](https://jakearchibald.github.io/isserviceworkerready/)
- [使用 Service Worker](/zh-CN/docs/Web/API/Service_Worker_API/Using_Service_Workers)
- [Service worker 基本代码示例](https://github.com/mdn/dom-examples/tree/main/service-worker/simple-service-worker)
- [是否支持 ServiceWorker](https://jakearchibald.github.io/isserviceworkerready/)
- {{jsxref("Promise")}}
- [Using web workers](/zh-CN/docs/Web/Guide/Performance/Using_web_workers)
- [使用 web worker](/zh-CN/docs/Web/API/Web_Workers_API/Using_web_workers)
Loading

0 comments on commit 6739b5a

Please sign in to comment.