From 1e5ef69352fca974bc2c3b0c507b20c97189fd1e Mon Sep 17 00:00:00 2001 From: MDN Date: Sun, 22 Aug 2021 00:45:00 +0000 Subject: [CRON] sync translated content --- files/zh-cn/_redirects.txt | 8 +- files/zh-cn/_wikihistory.json | 42 +- .../border-image_generator/index.html | 2628 ------------------ .../border-radius_generator/index.html | 1600 ----------- .../box-shadow_generator/index.html | 2881 -------------------- .../border-image_generator/index.html | 2629 ++++++++++++++++++ .../border-radius_generator/index.html | 1600 +++++++++++ .../box-shadow_generator/index.html | 2881 ++++++++++++++++++++ files/zh-cn/web/guide/houdini/index.html | 91 + files/zh-cn/web/houdini/index.html | 90 - 10 files changed, 7228 insertions(+), 7222 deletions(-) delete mode 100644 files/zh-cn/web/css/css_background_and_borders/border-image_generator/index.html delete mode 100644 files/zh-cn/web/css/css_background_and_borders/border-radius_generator/index.html delete mode 100644 files/zh-cn/web/css/css_background_and_borders/box-shadow_generator/index.html create mode 100644 files/zh-cn/web/css/css_backgrounds_and_borders/border-image_generator/index.html create mode 100644 files/zh-cn/web/css/css_backgrounds_and_borders/border-radius_generator/index.html create mode 100644 files/zh-cn/web/css/css_backgrounds_and_borders/box-shadow_generator/index.html create mode 100644 files/zh-cn/web/guide/houdini/index.html delete mode 100644 files/zh-cn/web/houdini/index.html (limited to 'files/zh-cn') diff --git a/files/zh-cn/_redirects.txt b/files/zh-cn/_redirects.txt index 566a22782a..5653358610 100644 --- a/files/zh-cn/_redirects.txt +++ b/files/zh-cn/_redirects.txt @@ -1670,9 +1670,12 @@ /zh-CN/docs/Web/CSS/Block_formatting_context /zh-CN/docs/Web/Guide/CSS/Block_formatting_context /zh-CN/docs/Web/CSS/CSS3中的关键帧 /zh-CN/docs/Web/CSS/@keyframes /zh-CN/docs/Web/CSS/CSSOM_View/坐标系 /zh-CN/docs/Web/CSS/CSSOM_View/Coordinate_systems -/zh-CN/docs/Web/CSS/CSS_Background_and_Borders/圆角边框发生器 /zh-CN/docs/Web/CSS/CSS_Background_and_Borders/Border-radius_generator +/zh-CN/docs/Web/CSS/CSS_Background_and_Borders/Border-image_generator /zh-CN/docs/Web/CSS/CSS_Backgrounds_and_Borders/Border-image_generator +/zh-CN/docs/Web/CSS/CSS_Background_and_Borders/Border-radius_generator /zh-CN/docs/Web/CSS/CSS_Backgrounds_and_Borders/Border-radius_generator +/zh-CN/docs/Web/CSS/CSS_Background_and_Borders/Box-shadow_generator /zh-CN/docs/Web/CSS/CSS_Backgrounds_and_Borders/Box-shadow_generator +/zh-CN/docs/Web/CSS/CSS_Background_and_Borders/圆角边框发生器 /zh-CN/docs/Web/CSS/CSS_Backgrounds_and_Borders/Border-radius_generator /zh-CN/docs/Web/CSS/CSS_Backgrounds_and_Borders/Scaling_background_images /zh-CN/docs/Web/CSS/CSS_Backgrounds_and_Borders/Resizing_background_images -/zh-CN/docs/Web/CSS/CSS_Box_Model/Box-shadow_generator /zh-CN/docs/Web/CSS/CSS_Background_and_Borders/Box-shadow_generator +/zh-CN/docs/Web/CSS/CSS_Box_Model/Box-shadow_generator /zh-CN/docs/Web/CSS/CSS_Backgrounds_and_Borders/Box-shadow_generator /zh-CN/docs/Web/CSS/CSS_Flexible_Box_Layout/Flexbox_的_向下_支持 /zh-CN/docs/Web/CSS/CSS_Flexible_Box_Layout/Backwards_Compatibility_of_Flexbox /zh-CN/docs/Web/CSS/CSS_Flexible_Box_Layout/典型_用例_的_Flexbox /zh-CN/docs/Web/CSS/CSS_Flexible_Box_Layout/Typical_Use_Cases_of_Flexbox /zh-CN/docs/Web/CSS/CSS_Flexible_Box_Layout/弹性盒子与其他布局方法的联系 /zh-CN/docs/Web/CSS/CSS_Flexible_Box_Layout/Relationship_of_Flexbox_to_Other_Layout_Methods @@ -1968,6 +1971,7 @@ /zh-CN/docs/Web/HTTP/策略特征/Using_Feature_Policy /zh-CN/docs/Web/HTTP/Feature_Policy/Using_Feature_Policy /zh-CN/docs/Web/HTTP/缓存_FAQ /zh-CN/docs/Web/HTTP/Caching /zh-CN/docs/Web/HTTP/重定向 /zh-CN/docs/Web/HTTP/Redirections +/zh-CN/docs/Web/Houdini /zh-CN/docs/Web/Guide/Houdini /zh-CN/docs/Web/JavaScript/Equality_comparisons_and_when_to_use_them /zh-CN/docs/Web/JavaScript/Equality_comparisons_and_sameness /zh-CN/docs/Web/JavaScript/Guide/Closures /zh-CN/docs/Web/JavaScript/Closures /zh-CN/docs/Web/JavaScript/Guide/Equality_comparisons_and_when_to_use_them /zh-CN/docs/Web/JavaScript/Equality_comparisons_and_sameness diff --git a/files/zh-cn/_wikihistory.json b/files/zh-cn/_wikihistory.json index c7337931f9..d2764ca101 100644 --- a/files/zh-cn/_wikihistory.json +++ b/files/zh-cn/_wikihistory.json @@ -26104,14 +26104,22 @@ "hutuxu" ] }, - "Web/CSS/CSS_Background_and_Borders/Border-image_generator": { + "Web/CSS/CSS_Backgrounds_and_Borders": { + "modified": "2019-03-18T21:45:20.317Z", + "contributors": [ + "PythonVsJava", + "RainSlide", + "Sheppy" + ] + }, + "Web/CSS/CSS_Backgrounds_and_Borders/Border-image_generator": { "modified": "2019-03-18T21:15:13.389Z", "contributors": [ "Ende93", "yellowstar1992" ] }, - "Web/CSS/CSS_Background_and_Borders/Border-radius_generator": { + "Web/CSS/CSS_Backgrounds_and_Borders/Border-radius_generator": { "modified": "2019-03-23T22:42:48.406Z", "contributors": [ "FrontENG", @@ -26119,7 +26127,7 @@ "regiondavid" ] }, - "Web/CSS/CSS_Background_and_Borders/Box-shadow_generator": { + "Web/CSS/CSS_Backgrounds_and_Borders/Box-shadow_generator": { "modified": "2019-03-18T20:43:42.671Z", "contributors": [ "BychekRU", @@ -26127,14 +26135,6 @@ "charlie" ] }, - "Web/CSS/CSS_Backgrounds_and_Borders": { - "modified": "2019-03-18T21:45:20.317Z", - "contributors": [ - "PythonVsJava", - "RainSlide", - "Sheppy" - ] - }, "Web/CSS/CSS_Backgrounds_and_Borders/Resizing_background_images": { "modified": "2019-03-18T21:38:07.175Z", "contributors": [ @@ -31070,6 +31070,16 @@ "Teago" ] }, + "Web/Guide/Houdini": { + "modified": "2020-11-21T05:08:58.458Z", + "contributors": [ + "xusy", + "bingoYB", + "cutefcc", + "sunfeel", + "xgqfrms" + ] + }, "Web/Guide/Introduction_to_Web_development": { "modified": "2019-03-24T00:00:33.366Z", "contributors": [ @@ -35156,16 +35166,6 @@ "WayneCui" ] }, - "Web/Houdini": { - "modified": "2020-11-21T05:08:58.458Z", - "contributors": [ - "xusy", - "bingoYB", - "cutefcc", - "sunfeel", - "xgqfrms" - ] - }, "Web/JavaScript": { "modified": "2020-09-21T00:46:20.876Z", "contributors": [ diff --git a/files/zh-cn/web/css/css_background_and_borders/border-image_generator/index.html b/files/zh-cn/web/css/css_background_and_borders/border-image_generator/index.html deleted file mode 100644 index 85b576cfd7..0000000000 --- a/files/zh-cn/web/css/css_background_and_borders/border-image_generator/index.html +++ /dev/null @@ -1,2628 +0,0 @@ ---- -title: Border-image 生成器 -slug: Web/CSS/CSS_Background_and_Borders/Border-image_generator -tags: - - CSS - - Tools -translation_of: Web/CSS/CSS_Background_and_Borders/Border-image_generator ---- -

这个工具用于生成 CSS3 {{cssxref("border-image")}} 的值.

- - - -

{{ EmbedLiveSample('Border_Image_Generator', '100%', '1270px') }}

- -

 

diff --git a/files/zh-cn/web/css/css_background_and_borders/border-radius_generator/index.html b/files/zh-cn/web/css/css_background_and_borders/border-radius_generator/index.html deleted file mode 100644 index 70ffc1aad1..0000000000 --- a/files/zh-cn/web/css/css_background_and_borders/border-radius_generator/index.html +++ /dev/null @@ -1,1600 +0,0 @@ ---- -title: 圆角边框生成器 -slug: Web/CSS/CSS_Background_and_Borders/Border-radius_generator -translation_of: Web/CSS/CSS_Background_and_Borders/Border-radius_generator -original_slug: Web/CSS/CSS_Background_and_Borders/圆角边框发生器 ---- -

使用Border-radius generator生成 CSS3 {{cssxref("border-radius")}} 样式

- - - -

{{ EmbedLiveSample('border-radius-generator', '100%', '800px', '') }}

- -

 

diff --git a/files/zh-cn/web/css/css_background_and_borders/box-shadow_generator/index.html b/files/zh-cn/web/css/css_background_and_borders/box-shadow_generator/index.html deleted file mode 100644 index 79b9abe9e2..0000000000 --- a/files/zh-cn/web/css/css_background_and_borders/box-shadow_generator/index.html +++ /dev/null @@ -1,2881 +0,0 @@ ---- -title: Box-shadow generator -slug: Web/CSS/CSS_Background_and_Borders/Box-shadow_generator -translation_of: Web/CSS/CSS_Background_and_Borders/Box-shadow_generator -original_slug: Web/CSS/CSS_Box_Model/Box-shadow_generator ---- -

这个可视化工具可以帮助你生成一个元素的CSS{{cssxref("box-shadow")}}相关代码，添加box shadow效果到你的CSS对象上。

- - - -
{{ EmbedLiveSample('box-shadow_generator', '100%', '1100px', '') }}
- -

Related Tool: Box Shadow CSS Generator

diff --git a/files/zh-cn/web/css/css_backgrounds_and_borders/border-image_generator/index.html b/files/zh-cn/web/css/css_backgrounds_and_borders/border-image_generator/index.html new file mode 100644 index 0000000000..870e84f663 --- /dev/null +++ b/files/zh-cn/web/css/css_backgrounds_and_borders/border-image_generator/index.html @@ -0,0 +1,2629 @@ +--- +title: Border-image 生成器 +slug: Web/CSS/CSS_Backgrounds_and_Borders/Border-image_generator +tags: + - CSS + - Tools +translation_of: Web/CSS/CSS_Background_and_Borders/Border-image_generator +original_slug: Web/CSS/CSS_Background_and_Borders/Border-image_generator +--- +

这个工具用于生成 CSS3 {{cssxref("border-image")}} 的值.

+ + + +

{{ EmbedLiveSample('Border_Image_Generator', '100%', '1270px') }}

+ +

 

diff --git a/files/zh-cn/web/css/css_backgrounds_and_borders/border-radius_generator/index.html b/files/zh-cn/web/css/css_backgrounds_and_borders/border-radius_generator/index.html new file mode 100644 index 0000000000..4781337bc3 --- /dev/null +++ b/files/zh-cn/web/css/css_backgrounds_and_borders/border-radius_generator/index.html @@ -0,0 +1,1600 @@ +--- +title: 圆角边框生成器 +slug: Web/CSS/CSS_Backgrounds_and_Borders/Border-radius_generator +translation_of: Web/CSS/CSS_Background_and_Borders/Border-radius_generator +original_slug: Web/CSS/CSS_Background_and_Borders/Border-radius_generator +--- +

使用Border-radius generator生成 CSS3 {{cssxref("border-radius")}} 样式

+ + + +

{{ EmbedLiveSample('border-radius-generator', '100%', '800px', '') }}

+ +

 

diff --git a/files/zh-cn/web/css/css_backgrounds_and_borders/box-shadow_generator/index.html b/files/zh-cn/web/css/css_backgrounds_and_borders/box-shadow_generator/index.html new file mode 100644 index 0000000000..2847389264 --- /dev/null +++ b/files/zh-cn/web/css/css_backgrounds_and_borders/box-shadow_generator/index.html @@ -0,0 +1,2881 @@ +--- +title: Box-shadow generator +slug: Web/CSS/CSS_Backgrounds_and_Borders/Box-shadow_generator +translation_of: Web/CSS/CSS_Background_and_Borders/Box-shadow_generator +original_slug: Web/CSS/CSS_Background_and_Borders/Box-shadow_generator +--- +

这个可视化工具可以帮助你生成一个元素的CSS{{cssxref("box-shadow")}}相关代码，添加box shadow效果到你的CSS对象上。

+ + + +
{{ EmbedLiveSample('box-shadow_generator', '100%', '1100px', '') }}
+ +

Related Tool: Box Shadow CSS Generator

diff --git a/files/zh-cn/web/guide/houdini/index.html b/files/zh-cn/web/guide/houdini/index.html new file mode 100644 index 0000000000..2c81ff1ed3 --- /dev/null +++ b/files/zh-cn/web/guide/houdini/index.html @@ -0,0 +1,91 @@ +--- +title: CSS Houdini +slug: Web/Guide/Houdini +tags: + - API + - CSS + - Houdini + - Web +translation_of: Web/Houdini +original_slug: Web/Houdini +--- +

Houdini是一组底层API，它们公开了CSS引擎的各个部分，从而使开发人员能够通过加入浏览器渲染引擎的样式和布局过程来扩展CSS。 Houdini是一组API，它们使开发人员可以直接访问CSS 对象模型 （CSSOM），使开发人员可以编写浏览器可以解析为CSS的代码，从而创建新的CSS功能，而无需等待它们在浏览器中本地实现。

+ +

Houdini 的优点

+ +

当样式改变时Houdini相比JavaScript.style 的方式能够能够更快的解析。  浏览器在应用脚本中发现的任何样式更新之前，会对CSSOM进行解析--包括布局、绘制和合成过程。此外，对于JavaScript样式更新，布局、绘制和复合过程也会重复进行。Houdini代码不会等待第一个渲染周期完成。相反，它被包含在第一个周期中--创建可渲染的、可理解的样式。Houdini为在JavaScript中使用CSS值提供了一个基于对象的API。

+ +

Houdini 的 CSS Typed OM 是一个包含类型和方法的 CSS 对象、并且暴露出了作为 JavaScript 对象的值。比起先前基于字符串的，对  HTMLElement.style 进行操作的方案，对 JavaScript 对象进行操作更符合直觉。每个元素和样式表规则都拥有一个样式对应表，该对应表可以通过  StylePropertyMap 来获得。

+ +

一个 CSS Houdini 的特性就是  Worklet。在它的帮助下，你可以通过引入一行 JavaScript 代码来引入配置化的组件，从而创建模块式的 CSS。不依赖任何前置处理器、后置处理器或者 JavaScript 框架。

+ +
<script>
+  CSS.paintWorklet.addModule('csscomponent.js');
+</script>
+
+ +

以上添加进的模块包含一个  registerPaint()函数，这个模块是完全通过可配置的 worklets 来注册的。

+ +

这个 CSS  paint()  函数的参数包括 worklet 的名字，以及其他可选的参数。worklet 同时能够访问元素的自定义属性：它们不需要作为函数参数传递。

+ +
li {
+	background-image: paint(myComponent, stroke, 10px);
+    --hilights: blue;
+    --lowlights: green;
+}
+ +
+

提醒: 能力越大，责任越大！在 Houdini 的帮助下你能够在 css 中实现你自己的布局、栅格、或者区域特性，但是这么做并不是最佳实践。CSS 工作组已经做了许多努力来确保 CSS 中的每一项特性都能正常运行，覆盖各种边界情况，同时考虑到了安全、隐私，以及可用性方面的表现。如果你要深入使用 Houdini，确保你也把以上这些事项考虑在内！并且先从小处开始，再把你的自定义 Houdini 推向一个富有雄心的项目。

+
+ +

Houdini APIs

+ +

在下面，你能够找到一些链接。这些链接指向 Houdini 范围下的 API 的主列表页面，同时链接到一些指导页来帮助你，如果你需要指导如何去使用这些API。

+ + + +
+
CSS Parser API
+
这是一个更直接地暴露出 CSS 解析器的 API，能够把任意 CSS 类语言解析成为一种中间类型。
+
目前还没有该 API 的教程或参考。
+
CSS Properties and Values API 
+
定义了一个用来注册新的 CSS 属性的 API。通过该 API 注册的属性必须用一种特定的解析语法书写，以定义其类型、继承行为以及初始值。
+
+ CSS Properties and Values API reference
+ CSS Properties and Values API guide
+
+
CSS Typed OM
+
该 API 将 CSSOM 字符串转化为有类型意义的 JavaScript。这将对后续的一个重要的表现打下基础。CSS Typed OM 将 CSS 值以类型化处理的 JavaScript 对象的形式暴露出来，以使其表现可以被控制。
+
+ CSS Typed OM reference
+ CSS Typed OM guide
+
CSS Layout API 
+
+

作为一个被设计来提升 CSS 扩展性的 API，该 API 能够让开发者去书写他们自己的布局算法，比如 masonry 或者 line snapping。该 API 目前还没有原生支持。

+ +

目前还没有该 API 的教程或参考。

+
+
CSS Painting API
+
+

作为一个被设计来提升 CSS 扩展性的 API，该 API 允许开发者通过 paint() 方法书写 JavaScript 函数，以控制绘制元素的背景、边框或者内容区域。
+
+ CSS Painting API reference
+ CSS Painting API guide

+
+
Worklets 
+
+

该 API 允许脚本独立于 JavaScript 执行环境，运行在渲染流程的各个阶段。Worklets 在概念上很接近于 Web Workers ，它由渲染引擎调用，并扩展了渲染引擎。
+
+ Worklets reference

+
+
+ +

其他

+ +

以下主题你可能会感兴趣，它们可能在你使用 Houdini API 的时候起一些有趣的作用。

+ +
+
Composite Scrolling and Animation 
+
diff --git a/files/zh-cn/web/houdini/index.html b/files/zh-cn/web/houdini/index.html deleted file mode 100644 index 68259ebd34..0000000000 --- a/files/zh-cn/web/houdini/index.html +++ /dev/null @@ -1,90 +0,0 @@ ---- -title: CSS Houdini -slug: Web/Houdini -tags: - - API - - CSS - - Houdini - - Web -translation_of: Web/Houdini ---- -

Houdini是一组底层API，它们公开了CSS引擎的各个部分，从而使开发人员能够通过加入浏览器渲染引擎的样式和布局过程来扩展CSS。 Houdini是一组API，它们使开发人员可以直接访问CSS 对象模型 （CSSOM），使开发人员可以编写浏览器可以解析为CSS的代码，从而创建新的CSS功能，而无需等待它们在浏览器中本地实现。

- -

Houdini 的优点

- -

当样式改变时Houdini相比JavaScript.style 的方式能够能够更快的解析。  浏览器在应用脚本中发现的任何样式更新之前，会对CSSOM进行解析--包括布局、绘制和合成过程。此外，对于JavaScript样式更新，布局、绘制和复合过程也会重复进行。Houdini代码不会等待第一个渲染周期完成。相反，它被包含在第一个周期中--创建可渲染的、可理解的样式。Houdini为在JavaScript中使用CSS值提供了一个基于对象的API。

- -

Houdini 的 CSS Typed OM 是一个包含类型和方法的 CSS 对象、并且暴露出了作为 JavaScript 对象的值。比起先前基于字符串的，对  HTMLElement.style 进行操作的方案，对 JavaScript 对象进行操作更符合直觉。每个元素和样式表规则都拥有一个样式对应表，该对应表可以通过  StylePropertyMap 来获得。

- -

一个 CSS Houdini 的特性就是  Worklet。在它的帮助下，你可以通过引入一行 JavaScript 代码来引入配置化的组件，从而创建模块式的 CSS。不依赖任何前置处理器、后置处理器或者 JavaScript 框架。

- -
<script>
-  CSS.paintWorklet.addModule('csscomponent.js');
-</script>
-
- -

以上添加进的模块包含一个  registerPaint()函数，这个模块是完全通过可配置的 worklets 来注册的。

- -

这个 CSS  paint()  函数的参数包括 worklet 的名字，以及其他可选的参数。worklet 同时能够访问元素的自定义属性：它们不需要作为函数参数传递。

- -
li {
-	background-image: paint(myComponent, stroke, 10px);
-    --hilights: blue;
-    --lowlights: green;
-}
- -
-

提醒: 能力越大，责任越大！在 Houdini 的帮助下你能够在 css 中实现你自己的布局、栅格、或者区域特性，但是这么做并不是最佳实践。CSS 工作组已经做了许多努力来确保 CSS 中的每一项特性都能正常运行，覆盖各种边界情况，同时考虑到了安全、隐私，以及可用性方面的表现。如果你要深入使用 Houdini，确保你也把以上这些事项考虑在内！并且先从小处开始，再把你的自定义 Houdini 推向一个富有雄心的项目。

-
- -

Houdini APIs

- -

在下面，你能够找到一些链接。这些链接指向 Houdini 范围下的 API 的主列表页面，同时链接到一些指导页来帮助你，如果你需要指导如何去使用这些API。

- - - -
-
CSS Parser API
-
这是一个更直接地暴露出 CSS 解析器的 API，能够把任意 CSS 类语言解析成为一种中间类型。
-
目前还没有该 API 的教程或参考。
-
CSS Properties and Values API 
-
定义了一个用来注册新的 CSS 属性的 API。通过该 API 注册的属性必须用一种特定的解析语法书写，以定义其类型、继承行为以及初始值。
-
- CSS Properties and Values API reference
- CSS Properties and Values API guide
-
-
CSS Typed OM
-
该 API 将 CSSOM 字符串转化为有类型意义的 JavaScript。这将对后续的一个重要的表现打下基础。CSS Typed OM 将 CSS 值以类型化处理的 JavaScript 对象的形式暴露出来，以使其表现可以被控制。
-
- CSS Typed OM reference
- CSS Typed OM guide
-
CSS Layout API 
-
-

作为一个被设计来提升 CSS 扩展性的 API，该 API 能够让开发者去书写他们自己的布局算法，比如 masonry 或者 line snapping。该 API 目前还没有原生支持。

- -

目前还没有该 API 的教程或参考。

-
-
CSS Painting API
-
-

作为一个被设计来提升 CSS 扩展性的 API，该 API 允许开发者通过 paint() 方法书写 JavaScript 函数，以控制绘制元素的背景、边框或者内容区域。
-
- CSS Painting API reference
- CSS Painting API guide

-
-
Worklets 
-
-

该 API 允许脚本独立于 JavaScript 执行环境，运行在渲染流程的各个阶段。Worklets 在概念上很接近于 Web Workers ，它由渲染引擎调用，并扩展了渲染引擎。
-
- Worklets reference

-
-
- -

其他

- -

以下主题你可能会感兴趣，它们可能在你使用 Houdini API 的时候起一些有趣的作用。

- -
-
Composite Scrolling and Animation 
-
-- cgit v1.2.3-54-g00ecf