---
title: border-image-outset
slug: Web/CSS/border-image-outset
tags:
  - CSS
  - CSS プロパティ
  - CSS 背景と境界
  - Reference
  - border-image
translation_of: Web/CSS/border-image-outset
---
<div>{{CSSRef}}</div>

<p><strong><code>border-image-outset</code></strong> は <a href="/ja/docs/Web/CSS">CSS</a> のプロパティで、要素の<a href="/ja/docs/Web/CSS/border-image">境界画像</a>が境界ボックスからはみ出す幅を設定します。</p>

<p>境界画像のうち、 <code>border-image-outset</code> によって要素の境界ボックスの外に表示された部分は、はみ出した際にスクロールバーを表示させたり、マウスイベントをキャプチャしたりすることはありません。</p>

<div>{{EmbedInteractiveExample("pages/css/border-image-outset.html")}}</div>

<p class="hidden">このデモのソースファイルは GitHub リポジトリに格納されています。デモプロジェクトに協力したい場合は、 <a href="https://github.com/mdn/interactive-examples">https://github.com/mdn/interactive-examples</a> をクローンしてプルリクエストを送信してください。</p>

<h2 id="Syntax" name="Syntax">構文</h2>

<pre class="brush:css no-line-numbers">/* &lt;length&gt; 値 */
border-image-outset: 1rem;

/* &lt;number&gt; 値 */
border-image-outset: 1.5;

/* 上下 | 左右 */
border-image-outset: 1 1.2;

/* 上 | 左右 | 下 */
border-image-outset: 30px 2 45px;

/* 上 | 右 | 下 | 左 */
border-image-outset: 7px 12px 14px 5px;

/* グローバル値 */
border-image-outset: inherit;
border-image-outset: initial;
border-image-outset: unset;
</pre>

<p><code>border-image-outset</code> プロパティは、1つから4つの値を使用して指定することができます。それぞれの値は {{cssxref("&lt;length&gt;")}} 又は {{cssxref("&lt;number&gt;")}} です。負の値は無効であり、指定すると <code>border-image-outset</code> の宣言が無効になります。</p>

<ol>
 <li>値が<strong>1つ</strong>指定された場合は、<strong>全4辺</strong>に適用されます。</li>
 <li>値が<strong>2つ</strong>指定された場合は、1つ目が<strong>上下</strong>に、2つ目が<strong>左右</strong>に適用されます。</li>
 <li>値が<strong>3つ</strong>指定された場合は、1つ目が<strong>上</strong>に、2つ目が<strong>左右</strong>に、3つ目が<strong>下</strong>に適用されます。</li>
 <li>値が<strong>4つ</strong>指定された場合は、<strong>上</strong>、<strong>右</strong>、<strong>下</strong>、<strong>左</strong>の順 (時計回り) で適用されます。</li>
</ol>

<h3 id="Values" name="Values">値</h3>

<dl>
 <dt>{{cssxref("&lt;length&gt;")}}</dt>
 <dd><code>border-image</code> がはみ出す寸法を長さ — 数値と単位で指定します。</dd>
 <dt>{{cssxref("&lt;number&gt;")}}</dt>
 <dd><code>border-image</code> がはみ出す寸法を、要素の対応する {{cssxref("border-width")}} の倍数で指定します。例えば、要素が <code>border-width: 1em 2px 0 1.5rem</code> で、 <code>border-image-outset: 2</code> であると、最終的な <code>border-image-outset</code> は <code>2em 4px 0 3rem</code> として計算されます。</dd>
</dl>

<h3 id="Formal_syntax" name="Formal_syntax">形式文法</h3>

{{csssyntax}}

<h2 id="Example" name="Example">例</h2>

<h3 id="HTML">HTML</h3>

<pre class="brush: html">&lt;div id="outset"&gt;This element has an outset border image!&lt;/div&gt;
</pre>

<h3 id="CSS">CSS</h3>

<pre class="brush: css">#outset {
  width: 10rem;
  background: #cef;
  border: 1.4rem solid;
  border-image: radial-gradient(#ff2, #55f) 40;
  border-image-outset: 1.5;  /* 1.5 × 1.4rem = 2.1rem */
  margin: 2.1rem;
}</pre>

<h3 id="Result" name="Result">結果</h3>

<p>{{EmbedLiveSample("Example", "auto", 200)}}</p>

<h2 id="Specifications" name="Specifications">仕様書</h2>

<table class="standard-table">
 <thead>
  <tr>
   <th scope="col">仕様書</th>
   <th scope="col">状態</th>
   <th scope="col">備考</th>
  </tr>
 </thead>
 <tbody>
  <tr>
   <td>{{SpecName('CSS3 Backgrounds', '#the-border-image-outset', 'border-image-outset')}}</td>
   <td>{{Spec2('CSS3 Backgrounds')}}</td>
   <td>初回定義</td>
  </tr>
 </tbody>
</table>

<div>{{cssinfo}}</div>

<h2 id="Browser_compatibility" name="Browser_compatibility">ブラウザーの互換性</h2>

<p>{{Compat("css.properties.border-image-outset")}}</p>