Web/CSS/text-decoration を更新 (#400)

* Web/CSS/text-decoration を更新

- 2021/03/16 時点の英語版に同期

* Web/CSS/text-decoration-thickness を新規翻訳

2021/03/16 の英語版に基づき新規翻訳

2 files changed, 191 insertions, 55 deletions

diff --git a/files/ja/web/css/text-decoration-thickness/index.html b/files/ja/web/css/text-decoration-thickness/index.html
new file mode 100644
index 0000000000..63fcce1a71
--- /dev/null
+++ b/files/ja/web/css/text-decoration-thickness/index.html
@@ -0,0 +1,124 @@
+---
+title: text-decoration-thickness
+slug: Web/CSS/text-decoration-thickness
+tags:
+  - CSS
+  - CSS Text Decoration
+  - Property
+  - Reference
+  - 'recipe:css-property'
+  - text-decoration
+  - text-decoration-thickness
+translation_of: Web/CSS/text-decoration-thickness
+---
+<div>{{CSSRef}}</div>
+
+<p><strong><code>text-decoration-thickness</code></strong> は <a href="/ja/docs/Web/CSS">CSS</a> のプロパティで、要素内のテキストに用いられる装飾線、例えば取り消し線、下線、上線の太さを設定します。</p>
+
+<h2 id="Syntax">構文</h2>
+
+<pre class="brush:css no-line-numbers">/* 単独のキーワード */
+text-decoration-thickness: auto;
+text-decoration-thickness: from-font;
+
+/* 長さ */
+text-decoration-thickness: 0.1em;
+text-decoration-thickness: 3px;
+
+/* パーセント値 */
+text-decoration-thickness: 10%;
+
+/* グローバル値 */
+text-decoration-thickness: inherit;
+text-decoration-thickness: initial;
+text-decoration-thickness: unset;
+</pre>
+
+<h3 id="Values">値</h3>
+
+<dl>
+ <dt><code>auto</code></dt>
+ <dd>ブラウザーがテキスト装飾線の適切な太さを選択します。</dd>
+ <dt><code>from-font</code></dt>
+ <dd>フォントファイルに推奨する太さの情報が含まれている場合は、その値を使用します。フォントファイルにこの情報が含まれていない場合は、 <code>auto</code> が設定されているのと同様に動作し、ブラウザーが適切な太さを選択します。</dd>
+ <dt><code>&lt;length&gt;</code></dt>
+ <dd>テキスト装飾線の太さを {{cssxref('length')}} として指定し、フォントファイルの推奨値やブラウザーの既定値を無視します。</dd>
+ <dt><code>&lt;percentage&gt;</code></dt>
+ <dd>テキスト装飾線の太さを現在のフォントの <strong>1em</strong> に対する {{cssxref('percentage')}} で指定します。パーセント値は相対値として継承されるので、フォントが変わるとそれに合わせて変わります。ブラウザーは最小でも 1 デバイスピクセルを使用しなければなりません。このプロパティを適用した場合、フォントの大きさが異なる子要素があっても、適用されたボックス全体で太さが一定になります。</dd>
+</dl>
+
+<h2 id="Formal_definition">公式定義</h2>
+
+<p>{{CSSInfo}}</p>
+
+<h2 id="Formal_syntax">形式文法</h2>
+
+{{csssyntax}}
+
+<h2 id="Examples">例</h2>
+
+<h3 id="Varying_thickness">様々な太さ</h3>
+
+<h4 id="HTML">HTML</h4>
+
+<pre class="brush: html">&lt;p class="thin"&gt;赤い 1px の下線を引いたテキストです。&lt;/p&gt;
+&lt;p class="thick"&gt;赤い 5px の下線を引いたテキストです。&lt;/p&gt;
+&lt;p class="shorthand"&gt;これは同等の一括指定を使用しています。&lt;/p&gt;</pre>
+
+<h4 id="CSS">CSS</h4>
+
+<pre class="brush: css">.thin {
+  text-decoration-line: underline;
+  text-decoration-style: solid;
+  text-decoration-color: red;
+  text-decoration-thickness: 1px;
+}
+
+.thick {
+  text-decoration-line: underline;
+  text-decoration-style: solid;
+  text-decoration-color: red;
+  text-decoration-thickness: 5px;
+}
+
+.shorthand {
+  text-decoration: underline solid red 5px;
+}</pre>
+
+<h4 id="Results">結果</h4>
+
+<p>{{ EmbedLiveSample('Varying_thickness', '', '', '') }}</p>
+
+<h2 id="Specifications">仕様書</h2>
+
+<table class="standard-table">
+ <thead>
+  <tr>
+   <th scope="col">仕様書</th>
+   <th scope="col">状態</th>
+   <th scope="col">備考</th>
+  </tr>
+ </thead>
+ <tbody>
+  <tr>
+   <td>{{SpecName('CSS4 Text Decoration', '#text-decoration-width-property', 'text-decoration-width')}}</td>
+   <td>{{Spec2('CSS4 Text Decoration')}}</td>
+   <td>初回定義</td>
+  </tr>
+ </tbody>
+</table>
+
+<div class="notecard note">
+<p><strong>注</strong>: このプロパティは <code>text-decoration-width</code> と呼ばれていましたが、 2019 年に <code>text-decoration-thickness</code> に更新されました。</p>
+</div>
+
+<h2 id="Browser_compatibility">ブラウザーの互換性</h2>
+
+<p>{{Compat("css.properties.text-decoration-thickness")}}</p>
+
+<h2 id="See_also">関連情報</h2>
+
+<ul>
+ <li>{{cssxref("text-decoration")}}</li>
+ <li>{{cssxref("text-underline-offset")}}</li>
+</ul>
diff --git a/files/ja/web/css/text-decoration/index.html b/files/ja/web/css/text-decoration/index.html
index 79d0ccd4fb..8e77aba241 100644
--- a/files/ja/web/css/text-decoration/index.html
+++ b/files/ja/web/css/text-decoration/index.html
@@ -3,9 +3,10 @@ title: text-decoration
 slug: Web/CSS/text-decoration
 tags:
   - CSS
-  - CSS テキスト装飾
-  - CSS プロパティ
+  - CSS Property
+  - CSS Text Decoration
   - Reference
+  - 'recipe:css-shorthand-property'
   - text-decoration
   - text-decoration-color
   - text-decoration-line
@@ -18,32 +19,47 @@ translation_of: Web/CSS/text-decoration
 
 <div>{{EmbedInteractiveExample("pages/css/text-decoration.html")}}</div>
 
-<p class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</p>
+<p>文字列の装飾は、子孫の文字列要素に適用されます。つまり、要素に文字列装飾が指定されれば、子要素では装飾を外すことができません。例えば、 <code>&lt;p&gt;This text has &lt;em&gt;some emphasized words&lt;/em&gt; in it.&lt;/p&gt;</code> というマークアップと、 <code>p { text-decoration: underline; }</code> のスタイル規則では、段落全体に下線が引かれます。 <code>em { text-decoration: none; }</code> のスタイル規則を適用しても変化せず、段落全体に下線が引かれたままになります。しかし、 <code>em { text-decoration: overline; }</code> の規則で "some emphasized words" に第二の装飾が施されます。</p>
 
-<p>文字列装飾は、子孫の文字列要素に適用されます。つまり、要素に文字列装飾が指定されれば、子要素では装飾を外すことができません。例えば、 <code>&lt;p&gt;This text has &lt;em&gt;some emphasized words&lt;/em&gt; in it.&lt;/p&gt;</code> という文と、 <code>p { text-decoration: underline; }</code> のスタイル規則では、段落全体に下線が引かれます。 <code>em { text-decoration: none; }</code> のスタイル規則を適用しても変化せず、段落全体に下線が引かれたままになります。しかし、 <code>em { text-decoration: overline; }</code> の規則で "some emphasized words" に第二の装飾が施されます。</p>
+<h2 id="Constituent_properties">構成要素のプロパティ</h2>
 
-<h2 id="Syntax" name="Syntax">構文</h2>
+<p>このプロパティは以下の CSS プロパティの一括指定です。</p>
 
-<p><code>text-decoration</code> プロパティは、個別指定の text-decoration プロパティを表す1つまたは複数の値を空白で区切って指定します。</p>
+<ul>
+	<li><a href="/ja/docs/Web/CSS/text-decoration-color"><code>text-decoration-color</code></a></li>
+	<li><a href="/ja/docs/Web/CSS/text-decoration-line"><code>text-decoration-line</code></a></li>
+	<li><a href="/ja/docs/Web/CSS/text-decoration-style"><code>text-decoration-style</code></a></li>
+	<li><a href="/ja/docs/Web/CSS/text-decoration-thickness"><code>text-decoration-thickness</code></a></li>
+</ul>
+
+<h2 id="Syntax">構文</h2>
 
-<h3 id="Values" name="Values">値</h3>
+<p><code>text-decoration</code> プロパティは、個別指定の text-decoration プロパティを表す 1 つまたは複数の値を空白で区切って指定します。</p>
+
+<h3 id="Values">値</h3>
 
 <dl>
- <dt>{{cssxref("text-decoration-line")}}</dt>
- <dd>使用する装飾の種類を設定します。 <code>underline</code> や <code>line-through</code> などです。</dd>
- <dt>{{cssxref("text-decoration-color")}}</dt>
- <dd>装飾の色を設定します。</dd>
- <dt>{{cssxref("text-decoration-style")}}</dt>
- <dd>装飾に使用する線のスタイルを設定します。 <code>solid</code>, <code>wavy</code>, <code>dashed</code> などです。</dd>
- <dt>{{cssxref("text-decoration-thickness")}}</dt>
- <dd>装飾に使われる線の太さを設定します。</dd>
+	<dt>{{cssxref("text-decoration-line")}}</dt>
+	<dd>使用する装飾の種類を設定します。 <code>underline</code> や <code>line-through</code> などです。</dd>
+	<dt>{{cssxref("text-decoration-color")}}</dt>
+	<dd>装飾の色を設定します。</dd>
+	<dt>{{cssxref("text-decoration-style")}}</dt>
+	<dd>装飾に使用する線のスタイルを設定します。 <code>solid</code>, <code>wavy</code>, <code>dashed</code> などです。</dd>
+	<dt>{{cssxref("text-decoration-thickness")}}</dt>
+<dd>装飾に使われる線の太さを設定します。</dd>
 </dl>
 
-<h3 id="Formal_syntax" name="Formal_syntax">形式文法</h3>
+<h2 id="Formal_definition">公式定義</h2>
+
+<p>{{CSSInfo}}</p>
+
+<h2 id="Formal_syntax">形式文法</h2>
 
 {{csssyntax}}
 
-<h2 id="Examples" name="Examples">例</h2>
+<h2 id="Examples">例</h2>
+
+<h3 id="Demonstration_of_text-decoration_values">text-decoration の値のデモ</h3>
 
 <pre class="brush: css">.under {
   text-decoration: underline red;
@@ -89,51 +105,47 @@ translation_of: Web/CSS/text-decoration
 
 <p>{{EmbedLiveSample('Examples','auto','320')}}</p>
 
-<h2 id="Specifications" name="Specifications">仕様書</h2>
+<h2 id="Specifications">仕様書</h2>
 
 <table class="standard-table">
- <thead>
-  <tr>
-   <th scope="col">仕様書</th>
-   <th scope="col">状態</th>
-   <th scope="col">備考</th>
-  </tr>
- </thead>
- <tbody>
-  <tr>
-   <td>{{SpecName('CSS4 Text Decoration')}}</td>
-   <td>{{Spec2('CSS4 Text Decoration')}}</td>
-   <td>{{cssxref("text-decoration-thickness")}} を追加。なお、これはまだ公式には一括指定の一部ではありません。これはまだ未定義です。</td>
-  </tr>
-  <tr>
-   <td>{{SpecName('CSS3 Text Decoration', '#text-decoration-property', 'text-decoration')}}</td>
-   <td>{{Spec2('CSS3 Text Decoration')}}</td>
-   <td>一括指定プロパティへ変更。 {{cssxref('text-decoration-style')}} の値への対応を追加。</td>
-  </tr>
-  <tr>
-   <td>{{SpecName('CSS2.1', 'text.html#lining-striking-props', 'text-decoration')}}</td>
-   <td>{{Spec2('CSS2.1')}}</td>
-   <td>実質的な変更なし。</td>
-  </tr>
-  <tr>
-   <td>{{SpecName('CSS1', '#text-decoration', 'text-decoration')}}</td>
-   <td>{{Spec2('CSS1')}}</td>
-   <td>初回定義</td>
-  </tr>
- </tbody>
+	<thead>
+		<tr>
+			<th scope="col">仕様書</th>
+			<th scope="col">状態</th>
+			<th scope="col">備考</th>
+		</tr>
+	</thead>
+	<tbody>
+		<tr>
+			<td>{{SpecName('CSS4 Text Decoration')}}</td>
+			<td>{{Spec2('CSS4 Text Decoration')}}</td>
+			<td>{{cssxref("text-decoration-thickness")}} を追加。なお、これはまだ公式には一括指定の一部ではありません。これはまだ未定義です。</td>
+		</tr>
+		<tr>
+			<td>{{SpecName('CSS3 Text Decoration', '#text-decoration-property', 'text-decoration')}}</td>
+			<td>{{Spec2('CSS3 Text Decoration')}}</td>
+			<td>一括指定プロパティへ変更。 {{cssxref('text-decoration-style')}} の値への対応を追加。</td>
+		</tr>
+		<tr>
+			<td>{{SpecName('CSS2.1', 'text.html#lining-striking-props', 'text-decoration')}}</td>
+			<td>{{Spec2('CSS2.1')}}</td>
+			<td>実質的な変更なし。</td>
+		</tr>
+		<tr>
+			<td>{{SpecName('CSS1', '#text-decoration', 'text-decoration')}}</td>
+			<td>{{Spec2('CSS1')}}</td>
+			<td>初回定義</td>
+		</tr>
+	</tbody>
 </table>
 
-<p>{{cssinfo}}</p>
-
-<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>
-
-<p class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</p>
+<h2 id="Browser_compatibility">ブラウザーの互換性</h2>
 
 <p>{{Compat("css.properties.text-decoration")}}</p>
 
-<h2 id="See_also" name="See_also">関連情報</h2>
+<h2 id="See_also">関連情報</h2>
 
 <ul>
- <li>text-decoration の個別指定プロパティは、 {{cssxref("text-decoration-line")}}, {{cssxref("text-decoration-color")}}, {{cssxref("text-decoration-style")}} です。</li>
- <li>{{cssxref("list-style")}} 属性は HTML の {{HTMLElement("ol")}} および {{HTMLElement("ul")}} のリストの表示方法を制御します。</li>
+	<li>text-decoration の個別指定プロパティは、 {{cssxref("text-decoration-line")}}, {{cssxref("text-decoration-color")}}, {{cssxref("text-decoration-style")}} です。</li>
+	<li>{{cssxref("list-style")}} 属性は HTML の {{HTMLElement("ol")}} および {{HTMLElement("ul")}} のリストの表示方法を制御します。</li>
 </ul>