clip-path

Базовая линия Широко доступная

Эта функция хорошо зарекомендовала себя и работает на многих устройствах и версиях браузеров. Она доступна в браузерах с января 2021 года.

Свойство clip-path CSS создаёт область обрезки, которая определяет, какая часть элемента должна отображаться. Части, находящиеся внутри области, отображаются, а части, находящиеся вне её, скрываются.

Попробовать

Синтаксис

/* Keyword values */
clip-path: none;

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

/* <geometry-box> values */
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> values */
clip-path: inset(100px 50px);
clip-path: circle(50px at 0 100px);
clip-path: ellipse(50px 60px at 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: rect(5px 5px 160px 145px round 20%);
clip-path: xywh(0 5px 100% 75% round 15% 0);

/* Box and shape values combined */
clip-path: padding-box circle(50px at 0 100px);

/* Global values */
clip-path: inherit;
clip-path: initial;
clip-path: revert;
clip-path: revert-layer;
clip-path: unset;

Свойство clip-path задаётся как одно или комбинацией значений, перечисленных ниже.

Значения

<clip-source>

Ссылка <url> на элемент SVG <clipPath>.

<basic-shape>

Фигура, размер и положение которой определяются значением <geometry-box>. Если геометрическая область не указана, будет использована border-box. Один из:

inset(): Определяет вложенный прямоугольник.
circle(): Определяет круг с использованием радиуса и положения.
ellipse(): Определяет эллипс с использованием двух радиусов и положения.
polygon(): Определяет многоугольник, используя правило заполнения SVG и набор вершин.
path(): Определяет фигуру, используя необязательное правило заполнения SVG и определение пути SVG.
rect(): Определяет прямоугольник, используя указанные расстояния от краёв области отсчёта.
shape(): Определяет фигуру, используя необязательное правило заполнения SVG и команды фигур для линий, кривых и дуг.
xywh(): Определяет прямоугольник, используя указанные расстояния от верхнего и левого краёв области отсчёта и указанную ширину и высоту прямоугольника.

<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.

none

Путь обрезки не создаётся.

Примечание: Вычисленное значение, отличное от none, приводит к созданию нового контекста стекирования так же, как CSS-свойство opacity для значений, отличных от 1.

Формальное определение

Начальное значение	`none`
Применяется к	всем элементам; в SVG он применяется к контейнерным элементам, за исключением элемента `<defs>` и всех графических элементов
Наследуется	нет
Проценты	ссылаются на область отсчёта, если указаны, иначе — область границы
Вычисленное значение	как указано, но значения `<url>` сделаны абсолютными
Тип анимации	да, как указано для `<basic-shape>`, иначе — нет

Формальный синтаксис

clip-path = 
  <clip-source>                        |
  [ <basic-shape> || <geometry-box> ]  |
  none                                 

<clip-source> = 
  <url>  

<geometry-box> = 
  <shape-box>  |
  fill-box     |
  stroke-box   |
  view-box     

<url> = 
  <url()>  |
  <src()>  

<shape-box> = 
  <visual-box>  |
  margin-box    

<url()> = 
  url( <string> <url-modifier>* )  |
  <url-token>                      

<src()> = 
  src( <string> <url-modifier>* )  

<visual-box> = 
  content-box  |
  padding-box  |
  border-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: 0.5em;
  padding: 0.5em;
  background-color: #fff;
  overflow: hidden;
  text-align: center;
  flex: 1;
}

.note {
  background: #fff3d4;
  padding: 1em;
  margin: 0.5em 0.5em 0;
  font: 0.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 0.6em sans-serif;
}

.view-box {
  box-shadow:
    1rem 1rem 0 #efefef inset,
    -1rem -1rem 0 #efefef inset;
}

.container.view-box::after {
  content: "view-box";
  position: absolute;
  left: 1.1rem;
  top: 1.1rem;
  font: italic 0.6em sans-serif;
}

.cell span {
  display: block;
  margin-bottom: 0.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="rect(10px 10px 180px 220px round 20px)">rect</option>
  <option value="xywh(0 20% 90% 67% round 0 0 5% 5px)">xywh</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);
}

Результат

Спецификации

Спецификация
CSS Masking Module Level 1 # the-clip-path
CSS Shapes Module Level 1 # supported-basic-shapes

Совместимость с браузерами

	Рабочий стол					Мобильный
	Chrome	Edge	Firefox	Opera	Safari	Chrome Android	Firefox для Android	Opera Android	Safari на iOS	Samsung Internet	WebView Android
`clip-path`	5523	79 12 Поддерживает только трафареты обрезки, определённые через `url()`.	3.5	4215	9.17	5525	4	4214	9.37	6.01.5	554.4
`basic_shape`	23	79	54	15	7	25	54	14	7	1.5	4.4
`fill-box`	119	119	51 Это значение поддерживалось до Firefox 51, но как псевдоним для `border-box`.	105	13.1	119	51 Это значение поддерживалось до Firefox 51, но как псевдоним для `border-box`.	79	13.4	25.0	119
`html_elements`	23	79	3.5	15	7	25	4	14	7	1.5	4.4
`is_animatable`	55	79	49	42	Нет	55	49	42	Нет	6.0	55
`path`	88	88	71	74	13.110	88	79	63	1310	15.0	88
`stroke-box`	119	119	51 Это значение поддерживалось до Firefox 51, но как псевдоним для `border-box`.	105	13.1	119	51 Это значение поддерживалось до Firefox 51, но как псевдоним для `border-box`.	79	13.4	25.0	119
`svg_elements`	23	12	52	15	7	25	52	14	7	1.5	4.4
`view-box`	119	119	≤72	105	≤13.1	119	79	79	≤13.4	25.0	119

См. также

Фигуры при обрезке и маскировании — и как их использовать
Свойства CSS: mask, filter
Применение эффектов SVG к содержимому HTML
Атрибуты SVG:
- clip-path
- clip-rule

© 2005–2024 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.
https://developer.mozilla.org/en-US/docs/Web/CSS/clip-path