1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
|
---
title: border-width
slug: Web/CSS/border-width
tags:
- CSS
- CSS プロパティ
- CSS 背景と境界
- Reference
- border
- border-width
- リファレンス
translation_of: Web/CSS/border-width
---
<div>{{CSSRef}}</div>
<p><a href="/ja/docs/Web/CSS">CSS</a> の <strong><code>border-width</code></strong> プロパティは、要素の境界線の四辺すべての線の幅を設定する<a href="/ja/docs/Web/CSS/Shorthand_properties">一括指定</a>プロパティです。</p>
<div>{{EmbedInteractiveExample("pages/css/border-width.html")}}</div>
<p>それぞれの辺は個別に、 {{cssxref("border-top-width")}}, {{cssxref("border-right-width")}}, {{cssxref("border-bottom-width")}}, {{cssxref("border-left-width")}} や、書字方向による指定を利用して {{cssxref("border-block-start-width")}}, {{cssxref("border-block-end-width")}}, {{cssxref("border-inline-start-width")}}, {{cssxref("border-inline-end-width")}} で設定することができます。</p>
<h2 id="Syntax" name="Syntax">構文</h2>
<pre class="brush: css no-line-numbers">/* キーワード値 */
border-width: thin;
border-width: medium;
border-width: thick;
/* <length> 値 */<em>
</em>border-width: 4px;
border-width: 1.2rem;<em>
</em>
/* 上下 | 左右 */
border-width: 2px 1.5em;
/* 上 | 左右 | 下 */
border-width: 1px 2em 1.5cm;
/* 上 | 右 | 下 | 左 */
border-width: 1px 2em 0 4rem;
/* グローバルキーワード */
border-width: inherit;
border-width: initial;
border-width: unset;
</pre>
<p><code>border-width</code> プロパティは一つ、二つ、三つ、四つの値を使って指定することができます。</p>
<ul>
<li>値が<strong>一つ</strong>指定された場合、<strong>全四辺</strong>に同じ幅が適用される。</li>
<li>値が<strong>二つ</strong>指定された場合、1つ目の幅は<strong>上下</strong>、2つ目は<strong>左右</strong>の辺に適用される。</li>
<li>値が<strong>三つ</strong>指定された場合、1つ目の幅は<strong>上</strong>、2つ目は<strong>左右</strong>、3つ目は<strong>下</strong>の辺に適用される。</li>
<li>値が<strong>四つ</strong>指定された場合、幅はそれぞれ<strong>上</strong>、<strong>右</strong>、<strong>下</strong>、<strong>左</strong>の順 (時計回り) に適用される。</li>
</ul>
<h3 id="Values" name="Values">値</h3>
<dl>
<dt><code><line-width></code></dt>
<dd>明示的な非負の {{cssxref("<length>")}} またはキーワードで、境界の幅を定義します。キーワードの場合、以下の値のうちの一つでなければなりません。
<table class="standard-table">
<tbody>
<tr>
<td style="vertical-align: middle;"><code>thin</code></td>
<td style="vertical-align: middle;">
<div style="margin: 0.5em; width: 3em; height: 3em; border-style: solid; border-width: thin; background-color: palegreen;"> </div>
</td>
<td style="vertical-align: middle;">細い境界線</td>
</tr>
<tr>
<td style="vertical-align: middle;"><code>medium</code></td>
<td style="vertical-align: middle;">
<div style="margin: 0.5em; width: 3em; height: 3em; border-style: solid; border-width: medium; background-color: palegreen;"> </div>
</td>
<td style="vertical-align: middle;">中くらいの境界線</td>
</tr>
<tr>
<td style="vertical-align: middle;"><code>thick</code></td>
<td style="vertical-align: middle;">
<div style="margin: 0.5em; width: 3em; height: 3em; border-style: solid; border-width: thick; background-color: palegreen;"> </div>
</td>
<td style="vertical-align: middle;">太い境界線</td>
</tr>
</tbody>
</table>
<div class="note">
<p><strong>メモ:</strong> 仕様書ではそれぞれのキーワードで示される正確な太さを定義していないため、何れか一つを使用した場合の詳細な結果は、実装に依存します。とは言っても、常に <code>thin ≤ medium ≤ thick</code> というパターンに従い、値は同じ文書の中では一貫しています。</p>
</div>
</dd>
</dl>
<h3 id="Formal_syntax" name="Formal_syntax">形式文法</h3>
{{csssyntax}}
<h2 id="Examples" name="Examples">例</h2>
<h3 id="A_mix_of_values_and_lengths" name="A_mix_of_values_and_lengths">値と長さの組み合わせ</h3>
<h4 id="HTML">HTML</h4>
<pre class="brush: html"><p id="sval">
one value: 6px wide border on all 4 sides</p>
<p id="bival">
two different values: 2px wide top and bottom border, 10px wide right and left border</p>
<p id="treval">
three different values: 0.3em top, 9px bottom, and zero width right and left</p>
<p id="fourval">
four different values: "thin" top, "medium" right, "thick" bottom, and 1em left</p></pre>
<h4 id="CSS">CSS</h4>
<pre class="brush: css">#sval {
border: ridge #ccc;
border-width: 6px;
}
#bival {
border: solid red;
border-width: 2px 10px;
}
#treval {
border: dotted orange;
border-width: 0.3em 0 9px;
}
#fourval {
border: solid lightgreen;
border-width: thin medium thick 1em;
}
p {
width: auto;
margin: 0.25em;
padding: 0.25em;
}</pre>
<h4 id="Result" name="Result">結果</h4>
<p>{{ EmbedLiveSample('A_mix_of_values_and_lengths', 320, 320) }}</p>
<h2 id="Specifications" name="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('CSS3 Backgrounds', '#the-border-width', 'border-width')}}</td>
<td>{{Spec2('CSS3 Backgrounds')}}</td>
<td>直接は変更なし。 CSS の {{cssxref("<length>")}} データ型拡張がこのプロパティに影響。</td>
</tr>
<tr>
<td>{{SpecName('CSS2.1', 'box.html#border-width-properties', 'border-width')}}</td>
<td>{{Spec2('CSS2.1')}}</td>
<td>値の意味が文書内で一定でなければならないという制限を追加。</td>
</tr>
<tr>
<td>{{SpecName('CSS1', '#border-width', 'border-width')}}</td>
<td>{{Spec2('CSS1')}}</td>
<td>初回定義</td>
</tr>
</tbody>
</table>
<p>{{cssinfo}}</p>
<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの対応</h2>
<div class="hidden">このページの互換性一覧表は構造化データから生成されています。データに協力していただけるのであれば、 <a class="external" href="https://github.com/mdn/browser-compat-data">https://github.com/mdn/browser-compat-data</a> をチェックアウトしてプルリクエストを送信してください。</div>
<p>{{Compat("css.properties.border-width")}}</p>
<h2 id="See_also" name="See_also">関連情報</h2>
<ul>
<li>境界線に関する一括指定プロパティ: {{Cssxref("border")}}, {{Cssxref("border-style")}}, {{Cssxref("border-color")}}</li>
<li>境界線の幅に関するプロパティ: {{Cssxref("border-bottom-width")}}, {{Cssxref("border-left-width")}}, {{Cssxref("border-right-width")}}, {{Cssxref("border-top-width")}}</li>
</ul>
|