border-image-outset

Baseline 已廣泛支援

此特性已相當成熟,可在許多裝置和瀏覽器版本上使用。自 ⁨2015 年 7 月⁩以來,各瀏覽器均已提供此特性。

border-image-outset CSS 屬性設定元素邊框圖片從其邊框盒向外延伸的距離。

透過 border-image-outset 在元素邊框盒外部渲染的邊框圖片部分不會觸發溢位捲軸,也不會捕獲滑鼠事件。

試一試

border-image-outset: 0;
border-image-outset: 15px;
border-image-outset: 30px;
border-image-outset: 40px;
<section id="default-example">
  <div id="example-element">This is a box with a border around it.</div>
</section>
#example-element {
  width: 80%;
  height: 80%;
  display: flex;
  align-items: center;
  justify-content: center;
  padding: 50px;
  background: #fff3d4;
  color: black;
  border: 30px solid;
  border-image: url("/shared-assets/images/examples/border-diamonds.png") 30
    round;
  font-size: 1.2em;
}

語法

css
/* <length> value */
border-image-outset: 1rem;

/* <number> value */
border-image-outset: 1.5;

/* top and bottom | left and right */
border-image-outset: 1 1.2;

/* top | left and right | bottom */
border-image-outset: 30px 2 45px;

/* top | right | bottom | left */
border-image-outset: 7px 12px 14px 5px;

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

border-image-outset 屬性可以指定一個、兩個、三個或四個值。每個值都是一個 <length><number>。負值無效,會導致 border-image-outset 宣告被忽略。

  1. 如果指定了一個值,則應用於所有四個邊
  2. 如果指定了兩個值,則第一個應用於頂部和底部,第二個應用於左側和右側
  3. 如果指定了三個值,則第一個應用於頂部,第二個應用於左側和右側,第三個應用於底部
  4. 如果指定了四個值,它們依次(順時針)應用於頂部右側底部左側

<length>

border-image 外延尺寸——一個帶單位的數值。

<number>

border-image 外延尺寸,作為元素相應 border-width 的倍數。例如,如果一個元素的 border-width: 1em 2px 0 1.5rem,並且 border-image-outset: 2,那麼最終的 border-image-outset 將被計算為 2em 4px 0 3rem

正式定義

初始值0
應用於所有元素,但在 border-collapsecollapse 時,內部表格元素除外。該屬性也適用於 ::first-letter
繼承性
計算值按指定值,但相對長度會轉換為絕對長度。
動畫型別按計算值型別

正式語法

border-image-outset = 
[ <length [0,∞]> | <number [0,∞]> ]{1,4}

示例

外延邊框影像

HTML

html
<div id="outset">This element has an outset border image!</div>

CSS

css
#outset {
  width: 10rem;
  background: #cceeff;
  border: 1.4rem solid;
  border-image: radial-gradient(#ffff22, #5555ff) 40;
  border-image-outset: 1.5; /* 1.5 × 1.4rem = 2.1rem */
  margin: 2.1rem;
}

結果

規範

規範
CSS Backgrounds and Borders Module Level 3
# border-image-outset

瀏覽器相容性

另見