CSSborder-left プロパティは、 border-left-width, border-left-style, border-left-color の一括指定プロパティです。これらのプロパティは要素の左の境界線 (border) を記述します。

この一括指定プロパティの3つの値は任意の順序で指定可能で、また、1つまたは2つの値を省略する事もできます。

他の一括指定プロパティと同様に、 border-left は、一部の値が指定されていなくても、設定可能なプロパティをすべて設定します。指定されていないプロパティは既定値が設定されます。つまり・・・

border-left-style: dotted;
border-left: thick green;

・・・は、実際には以下と同じです・・・

border-left-style: dotted;
border-left: none thick green;

・・・そして、前の border-left で設定された border-left-style の値は無視されます。 border-left-style の既定値は none なので、 border-style の部分の設定は境界線なしとなります。

構文

border-left: 1px;
border-left: 2px dotted;
border-left: medium dashed green;

この一括指定プロパティの3つの値は任意の順序で指定可能で、また、1つまたは2つの値を省略する事もできます。

<br-width>
border-left-width を参照してください。
<br-style>
border-left-style を参照してください。
<color>
border-left-color を参照してください。

形式文法

<br-width> || <br-style> || <color>

where
<br-width> = <length> | thin | medium | thick
<br-style> = none | hidden | dotted | dashed | solid | double | groove | ridge | inset | outset
<color> = <rgb()> | <rgba()> | <hsl()> | <hsla()> | <hex-color> | <named-color> | currentcolor | <deprecated-system-color>

where
<rgb()> = rgb( <percentage>{3} [ / <alpha-value> ]? ) | rgb( <number>{3} [ / <alpha-value> ]? ) | rgb( <percentage>#{3} , <alpha-value>? ) | rgb( <number>#{3} , <alpha-value>? )
<rgba()> = rgba( <percentage>{3} [ / <alpha-value> ]? ) | rgba( <number>{3} [ / <alpha-value> ]? ) | rgba( <percentage>#{3} , <alpha-value>? ) | rgba( <number>#{3} , <alpha-value>? )
<hsl()> = hsl( <hue> <percentage> <percentage> [ / <alpha-value> ]? ) | hsl( <hue>, <percentage>, <percentage>, <alpha-value>? )
<hsla()> = hsla( <hue> <percentage> <percentage> [ / <alpha-value> ]? ) | hsla( <hue>, <percentage>, <percentage>, <alpha-value>? )

where
<alpha-value> = <number> | <percentage>
<hue> = <number> | <angle>

<div>
  このボックスには左辺に境界線があります。
</div>
div {
  border-left: 4px dashed blue;
  background-color: gold;
  height: 100px;
  width: 100px;
  font-weight: bold;
  text-align: center;
}

仕様書

仕様書 状態 備考
CSS Backgrounds and Borders Module Level 3
border-left の定義
勧告候補 直接的な変更はないが、 border-left-color に適用される値が変更された。
CSS Level 2 (Revision 1)
border-left の定義
勧告 有意な変更点なし。
CSS Level 1
border-left の定義
勧告 初回定義。

初期値一括指定の各プロパティとして
適用対象すべての要素。 ::first-letter にも適用されます。
継承なし
メディア視覚
計算値一括指定の各プロパティとして
アニメーションの種類一括指定の各プロパティとして
正規順序形式文法における値の出現順

ブラウザーの対応

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

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

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