CSSのborder-imageで、グラデーションの枠線を描く方法

​​2026年11月14日​CSS​Playwright

CSS の border-image を使うと、枠線をグラデーションや画像で描けます。グラデーションの枠線なら、border で太さと線の種類を決め、border-image にグラデーションと 1 を書きます。最後の 1 を書き忘れると、四隅にしか色が付きません。

補足

検証環境は Ubuntu 24.04、Node.js 22.23.4、Playwright 1.63.0、Chromium 153 です。検証用のページを Playwright で開き、スクリーンショットの画素の色を読んで確かめました。Firefox と Safari での表示は試していません。各ブラウザーの対応バージョンは、互換性データ(@mdn/browser-compat-data 8.1.8)の値です。

2つの箱を縦に並べた画面。上の「slice を書かない(100%)」の箱は、四隅の小さな正方形だけに水色からピンクのグラデーションが付き、辺には色がない。下の「slice に 1 を書く」の箱は、4つの辺がすべてグラデーションの枠線になっている
上は slice を書かない場合、下は slice に 1 を書いた場合

グラデーションの枠線は border と border-image の2行で書く

水色からピンクへ、左から右に色が変わる枠線は、次のように書きます。

css
.box {
  border: 10px solid #9aa5ab;
  border-image: linear-gradient(90deg, #00c8e8, #d85878) 1;
}

border-image は、次の5つのプロパティの一括指定です。

プロパティ 決めること 初期値
border-image-source 使う画像やグラデーション none
border-image-slice 画像をどこで9つに切り分けるか 100%
border-image-width 枠の画像を描く太さ 1(border-width の1倍)
border-image-outset 枠の画像を外側にはみ出させる量 0
border-image-repeat 辺の画像を伸ばすか並べるか stretch

上の例の 1 は、border-image-slice の値です。border に書いた色(#9aa5ab)は、border-image が描けているあいだは表示されません。MDN によると、画像が表示できないときや border-image-source が none のときは、border-style の枠線が代わりに表示されます。

1 を書かないと、角にしか色が付かない

border-image-slice は、画像を縁から内側に向かって4本の線で切り、4つの角、4つの辺、真ん中の9つに分けます(CSS Backgrounds and Borders Level 3 の border-image-slice の節)。角の部分は枠の四隅に、辺の部分は上下左右の枠に使われます。真ん中は、fill を書かないと描かれません。

初期値は 100% です。仕様では、左と右の切り取り幅を足して画像の幅以上になると、上下の辺と真ん中は空になります。100% は、まさにこの状態です。

検証環境で、slice を書かない場合と 1 を書いた場合の色を測りました。箱には box-sizing: border-box を指定し、幅 200px、高さ 100px、枠の太さ 10px、背景は白にしました。

測った場所 slice を書かない slice に 1
左上の角 #20b7d7(色あり) #00c8e8
上の辺の中央 #ffffff(背景の白) #6d90b0
左の辺の中央 #ffffff #01c8e8
右の辺の中央 #ffffff #d85979

slice を書かないと、辺は背景の白のままで、border に書いた灰色も描かれませんでした。1 を書くと、画像が縁から 1 の位置(1px)で切り分けられ、辺に使う部分ができます。

border-image: linear-gradient(90deg, #00c8e8, #d85878) 1 fill; のように fill を足すと、箱の中央も #6c8faf になり、中身の背景の上にグラデーションが重なりました。

グラデーションの向きで、どの辺が変化するかが決まる

slice に 1 を書くと、上下の枠には画像の上端と下端の細い帯が、左右の枠には左端と右端の細い帯が、それぞれ引き伸ばされて使われます。そのため、グラデーションの向きによって、色が変わって見える辺が変わります。

左から右へ(90deg)のグラデーションでは、上下の辺で色が変わり、左の辺は #01c8e8 の水色、右の辺は #d85979 のピンクの1色でした。上から下へ(180deg)にすると、上の辺は #01c7e7 の水色、下の辺は #d75979 のピンクの1色になり、左右の辺の中央は #6e90b0 の中間の色でした。

border-style を書かないと、何も描かれない

border-image だけを書いても、枠線は描かれません。検証環境で border-width: 10px と border-image だけを書き、border-style を書かなかったところ、border-top-width の値は 0px で、枠線のどこにも色が付きませんでした。

仕様の border-style の節では、border-style: none のとき枠線の太さは 0 になり、border-image-width の初期値(太さの1倍)も 0 になるとされています。MDN でも、画像が読み込めなかったときのために border-style を指定するよう勧めています。

border の一括指定にも注意が要ります。仕様の border の一括指定の節にあるとおり、border は border-image を初期値に戻します。

css
/* border-image が消える */
.box {
  border-image: linear-gradient(90deg, #00c8e8, #d85878) 1;
  border: 10px solid #9aa5ab;
}

この順に書くと、border-image-source の値は none になり、枠線は border に書いた灰色の1色でした。border を先に書き、border-image をあとに書きます。

角丸にはならないので、背景を2枚重ねる

border-image の枠線は、border-radius を指定しても角が丸くなりません。仕様の Corner Clipping の節に、border-image は border-radius の影響を受けないと書かれています。

2つの箱を縦に並べた画面。上の「border-image と border-radius: 20px」の箱は、グラデーションの枠線の角が直角のまま。下の「背景を2枚重ねる」の箱は、同じグラデーションの枠線の角が丸くなっている
上は border-image に border-radius を足した場合、下は背景を2枚重ねた場合

検証環境で border-radius: 20px を足しても、箱の左上の角(左上から 1px の位置)は #00c8e8 の水色で、角は削られていませんでした。

角丸のグラデーションの枠線にしたいときは、border-image を使わず、背景を2枚重ねます。

css
.box {
  border: 10px solid transparent;
  border-radius: 20px;
  background:
    linear-gradient(#fff, #fff) padding-box,
    linear-gradient(90deg, #00c8e8, #d85878) border-box;
}

background に並べた背景は、先に書いたものが上に重なります。上の1枚は白です。padding-box と書くと、背景を描く範囲(background-clip)が、枠線より内側だけになります。下の1枚はグラデーションで、border-box と書いて枠線の下まで描きます。枠線は透明なので、枠線の部分には下のグラデーションが見えます。検証環境では、左上の角はページの背景の灰色(#cccccc)になり、角が丸く削られました。上の辺の中央は #6d90b0 で、border-image で描いたときと同じ色でした。

この書き方では、箱の中身の背景が、上に重ねた1枚の色(ここでは白)になります。

下の辺だけに引くと、グラデーションの下線になる

border-width で下だけに太さを付けると、下の辺だけにグラデーションの線が引けます。

css
.heading {
  border-style: solid;
  border-width: 0 0 4px;
  border-image: linear-gradient(90deg, #00c8e8, #d85878) 1;
}

検証環境では、下の辺の左端が #03c6e6、中央が #6c8faf、右端が #d55a7a で、上の辺には色が付きませんでした。

枠の画像だけを太くしたり、外にずらしたりする

border-image-width と border-image-outset は、枠の画像を描く場所だけを変えます。仕様の Border Images の章の冒頭にあるとおり、箱の大きさや中身の配置は border-width と border-style だけで決まります。

border-image の中では、slice のあとに / で区切って width を、さらに / で区切って outset を書きます。

css
/* border-image-width を 30px にする */
.wide {
  border: 10px solid #9aa5ab;
  border-image: linear-gradient(90deg, #00c8e8, #d85878) 1 / 30px;
}

/* border-image-outset を 10px にする(width は初期値の 1) */
.outset {
  border: 10px solid #9aa5ab;
  border-image: linear-gradient(90deg, #00c8e8, #d85878) 1 / 1 / 10px;
}

検証環境で、border-width を 10px のまま border-image-width を 30px にしたところ、上の辺は縁から 25px の位置にも色が付き、35px の位置は背景の白でした。箱の幅(offsetWidth)は 200px、中身の幅(clientWidth)は 180px のままで、太くした分の画像は中身の側に重なりました。

border-image-outset を 10px にすると、箱の左の縁から 5px 外側にも色が付きました。箱の縁から内側に 5px の位置(もとの枠線の部分)は、背景の白になりました。仕様では、border-image-outset は枠の画像を描く範囲を箱の外側へ広げる量です。箱の大きさは変わりません。後ろに置いた段落の位置も、outset を指定しない場合と同じでした。

画像を並べるときは border-image-repeat で伸ばし方を選ぶ

画像を使うと、飾りを並べた枠線が作れます。検証では、90×90 の SVG を用意しました。30px 四方の角にピンクの正方形、辺のマスの中央に直径 20px の水色の丸を描いたものです。

css
.frame {
  border: 30px solid #9aa5ab;
  border-image: url("frame.svg") 30 round;
}

30 は、画像を縁から 30 の位置で切るという意味です。SVG の中の座標で、角の正方形の大きさに合わせています。検証では、この SVG を data: の URL にして指定しました。

元の画像と、4つの箱を縦に並べた画面。元の画像は、四隅にピンクの正方形、上下左右の辺に水色の丸が1つずつ。stretch の箱は、上下の辺に横に長く伸びた丸が1つ。repeat の箱は、上下の辺に丸が7つ並び、両端の丸が角との境目で切れて欠けている。round の箱は、少し横に広がった丸が6つ並ぶ。space の箱は、元の形の丸が6つ、すき間をあけて並ぶ
元の画像と、border-image-repeat の4つの値の違い

幅 250px の箱で、上の辺(角を除いた 190px)を横に走査し、丸が描かれた区間を測りました。

値 上の辺の丸
stretch(初期値) 1つが 128px の横長に伸びる
repeat 真ん中から並べ、両端の丸は角との境目で切れる
round 6つ。マスが伸びて、丸の幅は 22〜23px
space 6つ。丸の幅は 21〜22px で、すき間を空けて並ぶ

repeat では、真ん中の丸が 115px からの 20px にあり、そこから左右に 30px ごとに並びました。両端の丸は辺の端で切れ、角の正方形とつながって一部だけが見えます。round は、190px に入るマスの数(6.33)を整数の 6 にして、マスを少し広げて並べます。space は、6つを元の大きさのまま並べ、余った幅をすき間に分けます。round と space の丸の幅は、白に近くない画素をすべて数えたため、丸の縁の薄い色も含んだ値です。

各値の動きは、MDN の border-image-repeat と、仕様の Drawing the Border Image の節に書かれています。repeat が真ん中から並べることは、仕様の手順のほうに書かれています。飾りの切れ目が気になるときは、round か space を選びます。

対応しているブラウザー

互換性データでは、border-image は Chrome 16、Edge 12、Firefox 15、Safari 6、iOS の Safari 6、Android の Chrome 18 から使えます。グラデーションの指定は、Firefox では 29 からです。border-image-repeat の space は、Chrome 56、Edge 12、Firefox 50、Safari 9.1 からです。

​Posted by 86