border-color

border-color 是一種CSS 簡寫屬性,用來綜合設定元件四邊框線的顏色。

嘗試一下

border-color 雖可一次設定四邊框線色彩,但每個邊框亦可用以下屬性分別指定:border-top-colorborder-right-colorborder-bottom-colorborder-left-color;能因應文字書寫方向改變框線相對位置(the writing mode-aware)的屬性如:border-block-start-color (en-US)border-block-end-color (en-US)border-inline-start-color (en-US)border-inline-end-color (en-US),也可達成分別指定的功能。

關於更多邊框色彩的設定說明,請見borders in Applying color to HTML elements using CSS

Constituent properties 屬性組成

border-color簡寫的屬性值內容由以下CSS的屬性值構成。

語法

/* <color> values */
border-color: red;

/* top and bottom | left and right */
border-color: red #f015ca;

/* top | left and right | bottom */
border-color: red rgb(240,30,50,.7) green;

/* top | right | bottom | left */
border-color: red yellow green blue;

/* Global values */
border-color: inherit;
border-color: initial;
border-color: revert;
border-color: revert-layer;
border-color: unset;

border-color 屬性值可設定一到四個輸入值。

  • 一個值:將單一顏色指定給全部四個邊
  • 兩個值:依顏色排列順序分別指定給:上下邊左右邊
  • 三個值:依顏色排列順序分別指定給:上邊框左右邊下邊框
  • 四個值:依顏色排列順序,沿邊框順時鐘方向,分別指定給:上邊框右邊框下邊框左邊框

屬性值

<color> (en-US)

定義框線的顏色。

Formal definition 語法定義

預設值as each of the properties of the shorthand:
Applies toall elements. It also applies to ::first-letter.
繼承與否no
Computed value (en-US)as each of the properties of the shorthand:
Animation typeas each of the properties of the shorthand:

Formal syntax 語法規則

border-color = 
<color>{1,4} (en-US)

<color> =
<absolute-color-base> | (en-US)
currentcolor | (en-US)
<system-color>

<absolute-color-base> =
<hex-color> (en-US) | (en-US)
<absolute-color-function> | (en-US)
<named-color> | (en-US)
transparent

<absolute-color-function> =
<rgb()> | (en-US)
<rgba()> | (en-US)
<hsl()> | (en-US)
<hsla()> | (en-US)
<hwb()> | (en-US)
<lab()> | (en-US)
<lch()> | (en-US)
<oklab()> | (en-US)
<oklch()> | (en-US)
<color()>

<rgb()> =
rgb( [ (en-US) <percentage> (en-US) | (en-US) none ] (en-US){3} (en-US) [ (en-US) / [ (en-US) <alpha-value> | (en-US) none ] (en-US) ] (en-US)? (en-US) ) | (en-US)
rgb( [ (en-US) <number> (en-US) | (en-US) none ] (en-US){3} (en-US) [ (en-US) / [ (en-US) <alpha-value> | (en-US) none ] (en-US) ] (en-US)? (en-US) )

<hsl()> =
hsl( [ (en-US) <hue> | (en-US) none ] (en-US) [ (en-US) <percentage> (en-US) | (en-US) none ] (en-US) [ (en-US) <percentage> (en-US) | (en-US) none ] (en-US) [ (en-US) / [ (en-US) <alpha-value> | (en-US) none ] (en-US) ] (en-US)? (en-US) )

<hwb()> =
hwb( [ (en-US) <hue> | (en-US) none ] (en-US) [ (en-US) <percentage> (en-US) | (en-US) none ] (en-US) [ (en-US) <percentage> (en-US) | (en-US) none ] (en-US) [ (en-US) / [ (en-US) <alpha-value> | (en-US) none ] (en-US) ] (en-US)? (en-US) )

<lab()> =
lab( [ (en-US) <percentage> (en-US) | (en-US) <number> (en-US) | (en-US) none ] (en-US) [ (en-US) <percentage> (en-US) | (en-US) <number> (en-US) | (en-US) none ] (en-US) [ (en-US) <percentage> (en-US) | (en-US) <number> (en-US) | (en-US) none ] (en-US) [ (en-US) / [ (en-US) <alpha-value> | (en-US) none ] (en-US) ] (en-US)? (en-US) )

<lch()> =
lch( [ (en-US) <percentage> (en-US) | (en-US) <number> (en-US) | (en-US) none ] (en-US) [ (en-US) <percentage> (en-US) | (en-US) <number> (en-US) | (en-US) none ] (en-US) [ (en-US) <hue> | (en-US) none ] (en-US) [ (en-US) / [ (en-US) <alpha-value> | (en-US) none ] (en-US) ] (en-US)? (en-US) )

<oklab()> =
oklab( [ (en-US) <percentage> (en-US) | (en-US) <number> (en-US) | (en-US) none ] (en-US) [ (en-US) <percentage> (en-US) | (en-US) <number> (en-US) | (en-US) none ] (en-US) [ (en-US) <percentage> (en-US) | (en-US) <number> (en-US) | (en-US) none ] (en-US) [ (en-US) / [ (en-US) <alpha-value> | (en-US) none ] (en-US) ] (en-US)? (en-US) )

<oklch()> =
oklch( [ (en-US) <percentage> (en-US) | (en-US) <number> (en-US) | (en-US) none ] (en-US) [ (en-US) <percentage> (en-US) | (en-US) <number> (en-US) | (en-US) none ] (en-US) [ (en-US) <hue> | (en-US) none ] (en-US) [ (en-US) / [ (en-US) <alpha-value> | (en-US) none ] (en-US) ] (en-US)? (en-US) )

<color()> =
color( <colorspace-params> [ (en-US) / [ (en-US) <alpha-value> | (en-US) none ] (en-US) ] (en-US)? (en-US) )

<alpha-value> =
<number> (en-US) | (en-US)
<percentage> (en-US)

<hue> =
<number> (en-US) | (en-US)
<angle> (en-US) | (en-US)
none

<colorspace-params> =
<predefined-rgb-params> | (en-US)
<xyz-params>

<predefined-rgb-params> =
<predefined-rgb> [ (en-US) <number> (en-US) | (en-US) <percentage> (en-US) | (en-US) none ] (en-US){3} (en-US)

<xyz-params> =
<xyz-space> [ (en-US) <number> (en-US) | (en-US) none ] (en-US){3} (en-US)

<predefined-rgb> =
srgb | (en-US)
srgb-linear | (en-US)
display-p3 | (en-US)
a98-rgb | (en-US)
prophoto-rgb | (en-US)
rec2020

<xyz-space> =
xyz | (en-US)
xyz-d50 | (en-US)
xyz-d65

範例

完整的border-color簡寫使用

HTML

<div id="justone">
  <p><code>border-color: red;</code> is equivalent to</p>
  <ul><li><code>border-top-color: red;</code></li>
    <li><code>border-right-color: red;</code></li>
    <li><code>border-bottom-color: red;</code></li>
    <li><code>border-left-color: red;</code></li>
  </ul>
</div>
<div id="horzvert">
  <p><code>border-color: gold red;</code> is equivalent to</p>
  <ul><li><code>border-top-color: gold;</code></li>
    <li><code>border-right-color: red;</code></li>
    <li><code>border-bottom-color: gold;</code></li>
    <li><code>border-left-color: red;</code></li>
  </ul>
</div>
<div id="topvertbott">
  <p><code>border-color: red cyan gold;</code> is equivalent to</p>
  <ul><li><code>border-top-color: red;</code></li>
    <li><code>border-right-color: cyan;</code></li>
    <li><code>border-bottom-color: gold;</code></li>
    <li><code>border-left-color: cyan;</code></li>
  </ul>
</div>
<div id="trbl">
  <p><code>border-color: red cyan black gold;</code> is equivalent to</p>
  <ul><li><code>border-top-color: red;</code></li>
    <li><code>border-right-color: cyan;</code></li>
    <li><code>border-bottom-color: black;</code></li>
    <li><code>border-left-color: gold;</code></li>
  </ul>
</div>

CSS

#justone {
  border-color: red;
}

#horzvert {
  border-color: gold red;
}

#topvertbott {
  border-color: red cyan gold;
}

#trbl {
  border-color: red cyan black gold;
}

/* 設定每個div的邊框與樣式 */
/* Set width and style for all divs */
div {
  border: solid 0.3em;
  width: auto;
  margin: 0.5em;
  padding: 0.5em;
}

ul {
  margin: 0;
  list-style: none;
}

成果

規範

Specification
CSS Logical Properties and Values Level 1
# logical-shorthand-keyword
CSS Backgrounds and Borders Module Level 4
# border-color

瀏覽器相容性

BCD tables only load in the browser

參見