CSSborder-width プロパティは、要素の境界線の4辺すべての線の幅を設定するための一括指定プロパティです。

それぞれの辺は個別に、 border-top-width, border-right-width, border-bottom-width, border-left-width や、書字方向による指定を利用して border-block-start-width, border-block-end-width, border-inline-start-width, border-inline-end-width で設定することができます。

構文

/* キーワード値 */
border-width: thin;
border-width: medium;
border-width: thick;

/* <length> 値 */
border-width: 4px;
border-width: 1.2rem;

/* 上下 | 左右 */
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;

border-width プロパティは1つ、2つ、3つ、4つの値を使って指定することができます。

  • 値が1つ指定された場合、全4辺に同じ幅が適用される。
  • 値が2つ指定された場合、1つ目の幅は上下、2つ目は左右の辺に適用される。
  • 値が3つ指定された場合、1つ目の幅は、2つ目は左右、3つ目はの辺に適用される。
  • 値が4つ指定された場合、幅はそれぞれの順(時計回り)に適用される。

<br-width>
境界線の幅を、負の数ではない明確な <length> 又はキーワードで定義します。キーワードの場合は、次の値のうちの一つでなければなりません。
thin
 
細い境界線
medium
 
中くらいの境界線
thick
 
太い境界線

メモ: 仕様書がそれぞれのキーワードで示される正確な太さを定義していないため、何れか一つを使用したときの詳細な結果は実装に依存します。とは言っても、常に thin ≦ medium ≦ thick というパターンに従い、値は常に同じ文書の中では一定です。

形式文法

<br-width>{1,4}

where
<br-width> = <length> | thin | medium | thick

値と長さの組み合わせ

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>

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;
}

結果

仕様策定状況

仕様書 策定状況 コメント
CSS Backgrounds and Borders Module Level 3
border-width の定義
勧告候補 直接は変更なし。 CSS の <length> データ型拡張がこのプロパティに影響。
CSS Level 2 (Revision 1)
border-width の定義
勧告 値の意味が文書内で一定でなければならないという制限を追加。
CSS Level 1
border-width の定義
勧告 初回定義

初期値以下の一括指定の各プロパティとして
適用対象全要素。 ::first-letter にも適用されます。
継承なし
メディアvisual
計算値以下の一括指定の各プロパティとして
アニメーションの種類以下の一括指定の各プロパティとして
正規順序形式文法で定義される一意のあいまいでない順序

ブラウザーの対応

機能ChromeEdgeFirefoxInternet ExplorerOperaSafari
基本対応112143.51
機能Android webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
基本対応2 ? あり4113 ?

関連情報

ドキュメントのタグと貢献者

このページの貢献者: mfuji09, Sebastianz, Prinz_Rana, teoli, ethertank, Yuichiro
最終更新者: mfuji09,