clip-path
clip-path は CSS のプロパティで、要素のどの部分を表示するかを設定するクリッピング領域を作ります。具体的には、領域の内部の部分は表示され、外側の部分は非表示になります。
試してみましょう
構文
/* キーワード値 */
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;
/* <basic-shape> 値 */
clip-path: inset(100px 50px);
clip-path: circle(50px at 0 100px);
clip-path: ellipse(50px 60px at 0 10% 20%);
clip-path: polygon(50% 0%, 100% 50%, 50% 100%, 0% 50%);
clip-path: path('M0.5,1 C0.5,1,0,0.7,0,0.3 A0.25,0.25,1,1,1,0.5,0.3 A0.25,0.25,1,1,1,1,0.3 C1,0.7,0.5,1,0.5,1 Z');
/* ボックスおよびシェイプ値の組み合わせ */
clip-path: padding-box circle(50px at 0 100px);
/* グローバル値 */
clip-path: inherit;
clip-path: initial;
clip-path: revert;
clip-path: unset;
clip-path プロパティは、以下に挙げた値のうちの一つまたは組み合わせで指定します。
値
<clip-source>-
url()で、SVG の<clipPath>要素を参照します。 <basic-shape>-
<geometry-box>値で寸法と位置が定義されるシェイプです。ジオメトリボックスが指定されない場合、参照ボックスとしてborder-boxが使用されます。以下のいずれかです。inset()-
内部の長方形を定義します。
circle()-
半径と中心位置を使用して円を定義します。
ellipse()-
2つの半径と位置を指定して楕円を定義します。
polygon()-
SVG の塗りつぶし規則と頂点のセットを用いて多角形を定義します。
path()(en-US)-
SVG の塗りつぶし規則と SVG のパス定義を用いて形状を定義します。
<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-
クリッピングパスは作成されません。
Note: 計算値が none 以外の場合は、新しい重ね合わせコンテキストを生成します。これは、 opacity が 1 以外の値の場合と同様です。
公式定義
形式文法
<clip-source> | [ <basic-shape> || <geometry-box> ] | noneここで
<clip-source> = <url>
<basic-shape> = <inset()> | <circle()> | <ellipse()> | <polygon()> | <path()>
<geometry-box> = <shape-box> | fill-box | stroke-box | view-boxここで
<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> ]# )
<path()> = path( [ <fill-rule>, ]? <string> )
<shape-box> = <box> | margin-boxここで
<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 と SVG の比較
html,body {
height: 100%;
box-sizing: border-box;
background: #EEE;
}
.grid {
width: 100%;
height: 100%;
display: flex;
font: 1em monospace;
}
.row {
display: flex;
flex: 1 auto;
flex-direction: row;
flex-wrap: wrap;
}
.col {
flex: 1 auto;
}
.cell {
margin: .5em;
padding: .5em;
background-color: #FFF;
overflow: hidden;
text-align: center;
flex: 1;
}
.note {
background: #fff3d4;
padding: 1em;
margin: .5em .5em 0;
font: .8em sans-serif;
text-align: left;
white-space: nowrap;
}
.note + .row .cell {
margin-top: 0;
}
.container {
display: inline-block;
border: 1px dotted grey;
position:relative;
}
.container:before {
content: 'margin';
position: absolute;
top: 2px;
left: 2px;
font: italic .6em sans-serif;
}
.viewbox {
box-shadow: 1rem 1rem 0 #EFEFEF inset, -1rem -1rem 0 #EFEFEF inset;
}
.container.viewbox:after {
content: 'viewbox';
position: absolute;
left: 1.1rem;
top: 1.1rem;
font: italic .6em sans-serif;
}
.cell span {
display: block;
margin-bottom: .5em;
}
p {
font-family: sans-serif;
background: #000;
color: pink;
margin: 2em;
padding: 3em 1em;
border: 1em solid pink;
width: 6em;
}
.none { clip-path: none; }
.svg { clip-path: url(#myPath); }
.svg2 { clip-path: path('M15,45 A30,30,0,0,1,75,45 A30,30,0,0,1,135,45 Q135,90,75,130 Q15,90,15,45 Z');}
.shape1 { clip-path: circle(25%); }
.shape2 { clip-path: circle(25% at 25% 25%); }
.shape3 { clip-path: fill-box circle(25% at 25% 25%); }
.shape4 { clip-path: stroke-box circle(25% at 25% 25%); }
.shape5 { clip-path: view-box circle(25% at 25% 25%); }
.shape6 { clip-path: margin-box circle(25% at 25% 25%); }
.shape7 { clip-path: border-box circle(25% at 25% 25%); }
.shape8 { clip-path: padding-box circle(25% at 25% 25%); }
.shape9 { clip-path: content-box circle(25% at 25% 25%); }
.defs {
width: 0;
height: 0;
margin: 0;
}
pre { margin-bottom: 0; }
svg {
margin: 1em;
font-family: sans-serif;
width: 192px;
height: 192px;
}
svg rect {
stroke: pink;
stroke-width: 16px;
}
svg text {
fill: pink;
text-anchor: middle;
}
svg text.em {
font-style: italic;
}
完全な例
HTML
<img id="clipped" src="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>
<option value="path('M 0 200 L 0,110 A 110,90 0,0,1 240,100 L 200 340 z')">path</option>
</select>
CSS
#clipped {
margin-bottom: 20px;
clip-path: url(#cross);
}
結果
仕様書
| Specification |
|---|
| CSS Masking Module Level 1 # the-clip-path |
| CSS Shapes Module Level 2 # supported-basic-shapes |
ブラウザーの互換性
BCD tables only load in the browser