CSS の border-top プロパティは、 border-top-colorborder-top-styleborder-top-width の一括指定プロパティです。これらのプロパティは要素の上の境界線(border)を記述します。

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

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

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

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

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

構文

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

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

<br-width>
border-top-width を参照してください。
<br-style>
border-top-style を参照してください。
<color>
border-top-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-top: 4px dashed blue;
  background-color: gold;
  height: 100px;
  width: 100px;
  font-weight: bold;
  text-align: center;
}

仕様策定状況

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

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

ブラウザーの対応

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

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

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