From 3ff51b4657c896eca9fac07ab4909ac01103e7a9 Mon Sep 17 00:00:00 2001
From: Gahotx <53534938+Gahotx@users.noreply.github.com>
Date: Fri, 23 Aug 2024 17:46:18 +0800
Subject: [PATCH] [zh-cn]: update the translation of the SVG attribute `stroke`

---
 files/zh-cn/web/svg/attribute/stroke/index.md | 116 +++++++++++++++---
 1 file changed, 98 insertions(+), 18 deletions(-)

diff --git a/files/zh-cn/web/svg/attribute/stroke/index.md b/files/zh-cn/web/svg/attribute/stroke/index.md
index b016fd9b5219f6..08fc08c557cf36 100644
--- a/files/zh-cn/web/svg/attribute/stroke/index.md
+++ b/files/zh-cn/web/svg/attribute/stroke/index.md
@@ -5,42 +5,122 @@ slug: Web/SVG/Attribute/stroke
 
 {{SVGRef}}
 
-`stroke` 属性定义了给定图形元素的外轮廓的颜色。它的默认值是 **`none`**。
+**`stroke`** 属性是一个表现属性，定义了给定图形元素的外轮廓的颜色。
 
-## 用法
+> [!NOTE]
+> 作为一个表现属性，`stroke` 可以用作 CSS 属性。
+
+你可以将此属性与以下 SVG 元素一起使用：
 
-| 类别   | 外观属性                                  |
-| ------ | ----------------------------------------- |
-| 值     | [\<paint>](/zh-CN/SVG/Content_type#Paint) |
-| 可变性 | 是                                        |
+- {{SVGElement('circle')}}
+- {{SVGElement('ellipse')}}
+- {{SVGElement('line')}}
+- {{SVGElement('path')}}
+- {{SVGElement('polygon')}}
+- {{SVGElement('polyline')}}
+- {{SVGElement('rect')}}
+- {{SVGElement('text')}}
+- {{SVGElement('textPath')}}
+- {{SVGElement('tref')}}
+- {{SVGElement('tspan')}}
 
 ## 示例
 
-## SVG 描边的线
+### 基础颜色和渐变色描边
 
-### 示例 1：用 stroke 属性画一条绿色的直线
+```css hidden
+html,
+body,
+svg {
+  height: 100%;
+}
+```
 
 ```html
-<svg height="50" width="300">
-  <path stroke="green" d="M5 20 1215 0" />
+<svg viewBox="0 0 20 10" xmlns="http://www.w3.org/2000/svg">
+  <!-- 使用单一颜色描边 -->
+  <circle cx="5" cy="5" r="4" fill="none" stroke="green" />
+
+  <!-- 使用渐变色描边 -->
+  <defs>
+    <linearGradient id="myGradient">
+      <stop offset="0%" stop-color="green" />
+      <stop offset="100%" stop-color="white" />
+    </linearGradient>
+  </defs>
+
+  <circle cx="15" cy="5" r="4" fill="none" stroke="url(#myGradient)" />
 </svg>
 ```
 
-### 示例 2：用 Stroke 属性画一个拥有蓝色边框的黑色的圆形
+输出如下：
 
-```html
-<svg height="200" width="200">
-  <circle cx="50" cy="50" r="40" stroke="blue" stroke-width="2" fill="black" />
+{{EmbedLiveSample("Basic color and gradient stroke", '100%', 200)}}
+
+### `context-stroke` 示例
+
+在这个示例中，我们使用 {{SVGElement('path')}} 元素定义了三个形状的图形，每个图形都设置了不同的 [`stroke`](/zh-CN/docs/Web/SVG/Attribute/fill) 和 [`fill`](/zh-CN/docs/Web/SVG/Attribute/fill) 颜色。我们还通过 {{SVGElement('circle')}} 元素和 {{SVGElement('marker')}} 元素定义了一个圆形的标记。每个图形都通过 ['marker'](/zh-CN/docs/Web/CSS/marker) CSS 属性应用了标记。
+
+{{SVGElement('circle')}} 元素上设置了 `stroke="context-stroke"` 和 `fill="context-fill"` 。因为它被设置为图形的上下文标记，所以这些属性会导致它在各种情况下都会继承设置在 {{SVGElement('path')}} 属性上的 `fill` 和 `stroke`。
+
+```html-nolint
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 300 90">
+  <style>
+    path {
+      stroke-width: 2px;
+      marker: url(#circle);
+    }
+  </style>
+  <path d="M 10 44.64 L 30 10 L 70 10 L 90 44.64 L 70 79.28 L 30 79.28 Z"
+        stroke="red" fill="orange" />
+  <path d="M 100 44.64 L 80 10 L 120 10 L 140 44.64 L 120 79.28 L 80 79.28 Z"
+        stroke="green" fill="lightgreen" />
+  <path d="M 150 44.64 L 130 10 L 170 10 L 190 44.64 L 170 79.28 L 130 79.28 Z"
+        stroke="blue" fill="lightblue" />
+  <marker id="circle" markerWidth="12" markerHeight="12"
+          refX="6" refY="6" markerUnits="userSpaceOnUse">
+    <circle cx="6" cy="6" r="3" stroke-width="2"
+            stroke="context-stroke" fill="context-fill"  />
+  </marker>
 </svg>
 ```
 
-## 元素
+输出如下：
 
-下列元素可以使用`stroke`属性：
+{{EmbedLiveSample("`context-stroke` 示例", '100%', 220)}}
 
-- [形状元素](/zh-CN/SVG/Element#Shape) »
-- [文本内容元素](/zh-CN/SVG/Element#TextContent) »
+> [!NOTE]
+> 当元素被 {{SVGElement('use')}} 元素引用时，元素还可以使用 `context-stroke` 和 `context-fill` 来继承 `stroke` 和 `fill` 的值。
+
+## 用法
+
+<table class="properties">
+  <tbody>
+    <tr>
+      <th scope="row">值</th>
+      <td>
+        <strong
+          ><a href="/zh-CN/docs/Web/SVG/Content_type#涂色"
+            >&#x3C;paint></a
+          ></strong
+        >
+      </td>
+    </tr>
+    <tr>
+      <th scope="row">默认值</th>
+      <td><code>none</code></td>
+    </tr>
+    <tr>
+      <th scope="row">可动画化</th>
+      <td>是</td>
+    </tr>
+  </tbody>
+</table>
 
 ## 规范
 
 {{Specifications}}
+
+## 浏览器兼容性
+
+{{Compat}}