clip-path

ジャンプ先:
  1. 構文
  2. 例
  3. 仕様書
  4. ブラウザーの対応
  5. 関連情報

CSS の clip-pathプロパティは、要素のどの部分を表示するかを定義するクリッピング領域を作ります。具体的には、領域の内部の部分は表示され、外側の部分は非表示になります。

構文

/* キーワード値 */
clip-path: none;

/* <clip-source> 値 */ 
clip-path: url(resources.svg#c1);

/* <geometry-box> 値 */
clip-path: margin-box;
clip-path: border-box;
clip-path: padding-box;
clip-path: content-box;
clip-path: fill-box;
clip-path: stroke-box;
clip-path: view-box;

/* ジオメオリ値 */
clip-path: inset(100px 50px);
clip-path: circle(50px at 0 100px);
clip-path: polygon(50% 0%, 100% 50%, 50% 100%, 0% 50%);

/* ボックス及びジオメトリ値の組み合わせ */
clip-path: padding-box circle(50px at 0 100px);

/* グローバル値 */
clip-path: inherit;
clip-path: initial;
clip-path: unset;

clip-path プロパティは、以下に挙げた値のうちの一つ又は組み合わせで指定します。

値

<clip-source>
クリッピングパス要素を参照する <url> です。
<basic-shape>
<geometry-box> 値で寸法と位置が定義されるシェイプです。ジオメトリボックスが指定されない場合、参照ボックスとして border-box が使用されます。
<geometry-box>
<basic-shape> と共に指定された場合、この値は基本シェイプの参照ボックスを定義します。単独で指定された場合、指定のボックスの辺を、角の形 (border-radius など) を含めてクリッピングパスにします。ジオメトリボックスは以下の値のうちの一つが指定できます。
margin-box
マージンボックスを参照ボックスとして使用します。
border-box
境界ボックスを参照ボックスとして使用します。
padding-box
パディングボックスを参照ボックスとして使用します。
content-box
コンテンボックスを参照ボックスとして使用します。
fill-box
オブジェクトの境界ボックスを参照ボックスとして使用します。
stroke-box
ストロークの境界ボックスを参照ボックスとして使用します。
view-box
最も近い SVG のビューポートを参照ボックスとして使用します。 SVG のビューポートを作成する要素に viewBox 属性が指定されている場合、参照ボックスは viewBox 属性で指定された座標系の原点に位置し、参照ボックスの寸法は viewBox 属性の width 及び height 値に設定されます。
none
クリッピングパスは作成されません。

形式文法

<clip-source> | [ <basic-shape> || <geometry-box> ] | none
where 
<clip-source> = <url>
<basic-shape> = <inset()> | <circle()> | <ellipse()> | <polygon()>
<geometry-box> = <shape-box> | fill-box | stroke-box | view-box
where 
<inset()> = inset( <length-percentage>{1,4} [ round <border-radius> ]? )
<circle()> = circle( [ <shape-radius> ]? [ at <position> ]? )
<ellipse()> = ellipse( [ <shape-radius>{2} ]? [ at <position> ]? )
<polygon()> = polygon( <fill-rule>? , [ <length-percentage> <length-percentage> ]# )
<shape-box> = <box> | margin-box
where 
<length-percentage> = <length> | <percentage>
<shape-radius> = <length-percentage> | closest-side | farthest-side
<position> = [ [ left | center | right ] || [ top | center | bottom ] | [ left | center | right | <length-percentage> ] [ top | center | bottom | <length-percentage> ]? | [ [ left | right ] <length-percentage> ] && [ [ top | bottom ] <length-percentage> ] ]
<fill-rule> = nonzero | evenodd
<box> = border-box | padding-box | content-box

例

完全な例

HTML

<img id="clipped" src="https://mdn.mozillademos.org/files/12668/MDN.svg"
    alt="MDN logo">
<svg height="0" width="0">
  <defs>
    <clipPath id="cross">
      <rect y="110" x="137" width="90" height="90"/>
      <rect x="0" y="110" width="90" height="90"/>
      <rect x="137" y="0" width="90" height="90"/>
      <rect x="0" y="0" width="90" height="90"/>
    </clipPath>
  </defs>
</svg>

<select id="clipPath">
  <option value="none">none</option>
  <option value="circle(100px at 110px 100px)">circle</option>
  <option value="url(#cross)" selected>cross</option>
  <option value="inset(20px round 20px)">inset</option>
</select>

CSS

#clipped {
  margin-bottom: 20px;
  clip-path: url(#cross);
}

結果

仕様書

仕様書 状態 備考
CSS Masking Module Level 1
clip-path の定義		 勧告候補 適用範囲を HTML 要素に拡張。 clip-path プロパティが非推奨の clip プロパティを置き換えた。
Scalable Vector Graphics (SVG) 1.1 (Second Edition)
clip-path の定義		 勧告 初回定義 (SVG 要素のみに適用)。

初期値none
適用対象all elements; In SVG, it applies to container elements excluding the defs element and all graphics elements
継承不可
パーセンテージrefer to reference box when specified, otherwise border-box
メディアvisual
計算値as specified, but with url values made absolute
アニメーションの種類yes, as specified for basic-shape, otherwise no
正規順序形式文法で定義される一意のあいまいでない順序

ブラウザーの対応

機能ChromeEdgeFirefoxInternet ExplorerOperaSafari
基本対応

55

24 -webkit-

なし3.5 なし42 なし
On SVG elements5515152 あり242 なし
<basic-shape>55 なし

54

47 —?3

 なし42 なし
inset()55 なし

54

473

 なし42 なし
Animations55 なし49 なし42 なし
fill-box and stroke-box なし なし514 なし なし なし
機能Android webviewChrome for AndroidEdge mobileFirefox for AndroidOpera AndroidiOS SafariSamsung Internet
基本対応55

55

あり -webkit-

なし442 なし

6.0

あり -webkit-

On SVG elements55551215242 なし6.0
<basic-shape>5555 なし

54

47 —?3

42 なし6.0
inset()5555 なし

54

473

42 なし6.0
Animations5555 なし4942 なし6.0
fill-box and stroke-box なし なし なし514 ? なし なし

1. Edge only supports clip paths defined by url().

2. Internet Explorer only supports clip paths defined by url().

3. From version 47: this feature is behind the layout.css.clip-path-shapes.enabled preference (needs to be set to true). To change preferences in Firefox, visit about:config.

4. This value was supported before Firefox 51, but as an alias to border-box.

関連情報

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

タグ: 
このページの貢献者: mfuji09, uknmr
最終更新者: mfuji09,