shape()-CSS-Funktion
Baseline
2026
Neu verfügbar
Seit February 2026 funktioniert diese Funktion auf aktuellen Geräten und in aktuellen Browserversionen. Auf älteren Geräten oder in älteren Browsern funktioniert sie möglicherweise nicht.
Die shape()-CSS-Funktion wird verwendet, um eine Form für die Eigenschaften border-shape, clip-path und offset-path zu definieren. Sie kombiniert einen anfänglichen Startpunkt mit einer Reihe von Formbefehlen, die den Pfad der Form definieren. Die Funktion shape() ist ein Mitglied des Datentyps <basic-shape>.
Syntax
/* <fill-rule> */
clip-path: shape(nonzero from 0 0, line to 10px 10px);
/* <move-command>, <line-command>, and close */
offset-path: shape(from 10px 10px, move by 10px 5px, line by 20px 40%, close);
/* <hvline-command> */
offset-path: shape(from 10px 10px, hline by 50px, vline to 5rem);
/* <curve-command> */
offset-path: shape(
from 10px 10px,
curve to 80px 80px with 160px 1px / 20% 16px
);
/* <smooth-command> */
offset-path: shape(from 10px 10px, smooth to 100px 50pt);
/* <arc-command> */
offset-path: shape(
from 5% 0.5rem,
arc to 80px 1pt of 10% ccw large rotate 25deg
);
/* Using a CSS math function */
offset-path: shape(
from 5px -5%,
hline to 50px,
vline by calc(0% + 160px),
hline by 70.5px,
close,
vline by 60px
);
clip-path: shape(
evenodd from 10px 10px,
curve to 60px 20% with 40px 0,
smooth to 90px 0,
curve by -20px 60% with 10% 40px / 20% 20px,
smooth by -40% -10px with -10px 70px,
close
);
Parameter
<fill-rule>Optional-
Gibt an, wie sich überlappende Bereiche einer Form gefüllt werden sollen. Die möglichen Werte umfassen:
-
nonzero: Ein Punkt wird als innerhalb der Form betrachtet, wenn ein Strahl, der vom Punkt ausgeht, mehr Links-nach-Rechts- als Rechts-nach-Links-Pfadsegmente kreuzt, was zu einer ungeraden Anzahl führt. Dies ist der Standardwert, wenn<fill-rule>weggelassen wird. -
evenodd: Ein Punkt wird als innerhalb der Form betrachtet, wenn ein Strahl, der vom Punkt ausgeht, eine ungerade Anzahl von Pfadsegmenten kreuzt. Das bedeutet, dass für jedes Mal, wenn der Strahl die Form betritt, er nicht gleich oft wieder herausgetreten ist, was eine ungerade Anzahl von Eintritten ohne entsprechende Austritte anzeigt.
Warnung:
<fill-rule>wird nicht imoffset-pathunterstützt und macht die Eigenschaft ungültig, wenn es verwendet wird. -
from <coordinate-pair>-
Definiert den Startpunkt des ersten
<shape-command>als ein Koordinatenpaar, das von der oberen linken Ecke der Referenzbox gemessen wird. Die Koordinaten werden als durch Leerzeichen getrennte<x> <y><length-percentage>-Werte angegeben, die jeweils den linken und den oberen Versatz darstellen. Prozentwerte beziehen sich auf die Breite und Höhe der Referenzbox des Elements. Fügen Sie nach diesem Parameter ein Komma hinzu. <shape-command>-
Gibt eine Liste von einem oder mehreren durch Komma getrennten Befehlen an, die die Form definieren, unter Verwendung einer Syntax ähnlich zu SVG-Pfadbefehlen. Befehle umfassen
<move-command>,<line-command>,<hv-line-command>,<curve-command>,<smooth-command>,<arc-command>undclose. Der Startpunkt jedes Befehls ist der Endpunkt des vorherigen Befehls, wobei der erste Punkt der Form durch denfrom <coordinate-pair>Parameter definiert wird.
Formbefehle
Die Syntax der meisten Formbefehle ist ein Schlüsselwort, das eine Anweisung wie move oder line liefert, gefolgt von dem Schlüsselwort by oder to sowie einem Satz von Koordinaten.
by: Gibt an, dass das<coordinate-pair>relativ zum Startpunkt des Befehls ist (ein "relativer" Wert).to: Gibt an, dass das<coordinate-pair>relativ zur oberen linken Ecke der Referenzbox ist (ein "absoluter" Wert).
Hinweis:
Wenn eine Koordinate in einem <coordinate-pair> als Prozentsatz angegeben ist, wird der Wert relativ zur jeweiligen Breite oder Höhe der Referenzbox berechnet.
Die folgenden <shape-command>s können angegeben werden:
<move-command>-
Angegeben als
move [by | to] <coordinate-pair>. Dieser Befehl fügt einen MoveTo-Befehl in die Liste der Formbefehle hinzu. Es wird nichts gezeichnet; stattdessen wird die Startposition für den nächsten Befehl angegeben. Das Schlüsselwortbyodertogibt an, ob der<coordinate-pair>-Punkt relativ oder absolut ist. Wenn der<move-command>demclose-Befehl folgt, identifiziert er den Startpunkt der nächsten Form oder des nächsten Unterpfads. <line-command>-
Angegeben als
line [by | to] <coordinate-pair>. Dieser Befehl fügt einen LineTo-Befehl in die Liste der Formbefehle hinzu. Es wird eine gerade Linie vom Startpunkt des Befehls zu seinem Endpunkt gezeichnet. Das Schlüsselwortbyodertogibt an, ob der Endpunkt, der durch<coordinate-pair>angegeben wird, relativ oder absolut ist. <hv-line-command>-
Angegeben als
[hline | vline] [by | to] <length-percentage>. Dieser Befehl fügt eine horizontale (hline) oder vertikale (vline) LineTo-Befehl in die Liste der Formbefehle ein. Mithlinewird eine horizontale Linie vom Startpunkt des Befehlstooderbyzur durch<length-percentage>definiertenx-Position gezeichnet. Mitvlinewird eine vertikale Linie vom Startpunkt des Befehlstooderbyzur durch<length-percentage>definierteny-Position gezeichnet. Das Schlüsselwortbyodertobestimmt den relativen oder absoluten Endpunkt, jeweils. Dieser Befehl ist äquivalent zu<line-command>mit einem Koordinatenwert, der durch die einzelne<length-percentage>gesetzt ist, und dem anderen Koordinatenwert, der vom Startbefehl unverändert bleibt. <curve-command>-
Angegeben als
curve [by | to] <end-point> with <control-point> [/ <control-point>]. Dieser Befehl fügt einen Bézier-Kurvenbefehl in die Liste der Formbefehle ein. Das Schlüsselwortbyodertobestimmt, ob der Endpunkt der Kurve, der durch den<end-point>angegeben wird, relativ oder absolut ist.Das
with-Schlüsselwort gibt die Kontrollpunkte der Bézier-Kurve wie folgt an.- Wenn nur ein einziger
<control-point>angegeben ist, zeichnet der Befehl eine quadratische Bézier-Kurve, die durch drei Punkte (den Startpunkt, den Kontrollpunkt und den Endpunkt) definiert wird. - Wenn zwei
<control-point>-Werte angegeben sind, zeichnet der Befehl eine kubische Bézier-Kurve, die durch vier Punkte (den Startpunkt, zwei Kontrollpunkte und den Endpunkt) definiert ist.
Gültige Werte für
<end-point>umfassen:<position>Schlüsselwörter oder ein<coordinate-value-pair>-
Kann verwendet werden, wenn der Kurvenendpunkt absolut ist (angegeben mit
to). <coordinate-value-pair>-
Kann verwendet werden, wenn der Kurvenendpunkt relativ ist (angegeben mit
by).
Gültige Werte für
<control-point>umfassen:<position>-
Gibt ein Position-Schlüsselwort an. Dieser Wert ist nur gültig, wenn der Kurvenendpunkt absolut ist (angegeben mit
to). <coordinate-value-pair>-
Gibt ein Paar von
<length-percentage>-Werten an, die Koordinaten definieren. <relative-control-point>-
Definiert ein
<coordinate-value-pair>gefolgt vomfrom-Schlüsselwort und einem der folgenden Schlüsselwörter:start-
Gibt an, dass der Kontrollpunkt relativ zum Startpunkt des aktuellen Befehls ist.
end-
Gibt an, dass der Kontrollpunkt relativ zum Endpunkt des aktuellen Befehls ist.
origin-
Gibt an, dass der Kontrollpunkt relativ zum oberen linken (Ursprungs-)Punkt des Containers ist, in dem die Form gezeichnet wird.
Hinweis: Wenn die
<relative-control-point>-Schlüsselwörter nicht angegeben sind, wodurch der<control-point>zu einem regulären<coordinate-value-pair>wird, sind die Koordinaten relativ zum Start der Kurve. Mit anderen Worten,startist die Standardeinstellung.
- Wenn nur ein einziger
<smooth-command>-
Angegeben als
smooth [by | to] <end-point> [with <control-point>]. Dieser Befehl fügt einen glatten Bézier-Kurvenbefehl in die Liste der Formbefehle ein. Das Schlüsselwortbyodertobestimmt, ob der Endpunkt der Kurve, der durch den<end-point>angegeben ist, relativ oder absolut ist.Das
with-Schlüsselwort gibt einen optionalen Kontrollpunkt für die Bézier-Kurve an:- Wenn
with <control-point>weggelassen wird, zeichnet der Befehl eine glatte quadratische Bézier-Kurve, die den vorherigen Kontrollpunkt und den aktuellen Endpunkt zur Definition der Kurve verwendet. - Wenn das optionale
with-Schlüsselwort enthalten ist, gibt es einen Kontrollpunkt der Kurve über<control-point>an, und zeichnet eine glatte kubische Bézier-Kurve, die durch den vorherigen Kontrollpunkt, den aktuellen Kontrollpunkt und den aktuellen Endpunkt definiert ist.
Glatte Kurven sorgen für einen kontinuierlichen Übergang von der Form, während quadratische Kurven dies nicht tun. Glatte quadratische Kurven halten einen nahtlosen Übergang mit einem einzelnen Kontrollpunkt aufrecht, während glatte kubische Kurven einen raffinierteren Übergang mit zwei Kontrollpunkten ermöglichen.
Gültige Werte für die
<end-point>- und<control-point>-Komponenten sind dieselben wie für<curve-command>. - Wenn
<arc-command>-
Angegeben als
arc [by | to] <coordinate-pair> of <length-percentage> [<length-percentage>] [<arc-sweep> | <arc-size> | rotate <angle>]. Dieser Befehl fügt einen elliptischen Bogenkurvenbefehl in die Liste der Formbefehle ein. Es wird ein elliptischer Bogen zwischen einem Startpunkt und einem Endpunkt gezeichnet. Das Schlüsselwortbyodertobestimmt, ob der Endpunkt der Kurve, der durch das erste<coordinate-pair>angegeben ist, relativ oder absolut ist.Der elliptische Bogenkurvenbefehl definiert zwei mögliche Ellipsen, die sowohl den Start- als auch den Endpunkt schneiden und jeweils im Uhrzeigersinn oder gegen den Uhrzeigersinn verfolgt werden können, was zu vier möglichen Bögen führt, abhängig von der Bogengröße, Richtung und Winkel. Das
of-Schlüsselwort gibt die Größe der Ellipse an, aus der der Bogen entnommen wird: Das erste<length-percentage>gibt den horizontalen Radius der Ellipse an, und das zweite<length-percentage>den vertikalen Radius.Folgende Parameter geben an, welcher der vier Bögen verwendet wird:
<arc-sweep>: Gibt an, ob der gewünschte Bogen der ist, der im Uhrzeigersinn (cw) oder gegen den Uhrzeigersinn (ccw) um die Ellipse verfolgt wird. Wenn weggelassen, ist dies standardmäßigccw.<arc-size>: Gibt an, ob der gewünschte Bogen der größere (large) oder kleinere (small) der beiden Bögen ist. Wenn weggelassen, ist dies standardmäßigsmall.<angle>: Gibt den Winkel in Grad an, um den die Ellipse relativ zur x-Achse gedreht werden soll. Ein positiver Winkel dreht die Ellipse im Uhrzeigersinn, und ein negativer Winkel gegen den Uhrzeigersinn. Wenn weggelassen, ist dies standardmäßig0deg.
Besondere Situationen werden wie folgt behandelt:
- Wenn nur ein
<length-percentage>angegeben ist, wird derselbe Wert sowohl für den horizontalen als auch den vertikalen Radius verwendet, wodurch effektiv ein Kreis entsteht. In diesem Fall haben<arc-size>und<angle>keine Auswirkungen. - Wenn einer der Radien null ist, ist der Befehl äquivalent zu einem
<line-command>zum Endpunkt. - Wenn einer der Radien negativ ist, wird stattdessen sein absoluter Wert verwendet.
- Wenn die horizontalen und vertikalen Radien keine Ellipse groß genug beschreiben, um sowohl den Startpunkt als auch den Endpunkt zu schneiden (nach der Rotation um den angegebenen
<angle>), werden die Radien gleichmäßig vergrößert, bis die Ellipse groß genug ist, um beide Punkte zu schneiden. - Wenn der Start- und der Endpunkt des Bogens genau auf gegenüberliegenden Seiten der Ellipse liegen, gibt es nur eine mögliche Ellipse und zwei mögliche Bögen. In diesem Fall gibt
<arc-sweep>den zu wählenden Bogen an, und<arc-size>hat keine Auswirkungen.
close-
Fügt einen ClosePath-Befehl in die Liste der Formbefehle ein, der eine gerade Linie von der aktuellen Position (Ende des letzten Befehls) zum ersten Punkt im durch den
from <coordinate-pair>-Parameter definierten Pfad zeichnet. Um die Form zu schließen, ohne eine Linie zu zeichnen, fügen Sie einen<move-command>mit den ursprünglichen Koordinaten vor demclose-Befehl ein. Wenn derclose-Befehl unmittelbar von einem<move-command>gefolgt wird, definiert er den Startpunkt der nächsten Form oder des nächsten Unterpfads.
Beschreibung
Die shape()-Funktion erlaubt es Ihnen, komplexe Formen zu definieren. Sie ist in vielerlei Hinsicht der path()-Formfunktion ähnlich:
- Der
<fill-rule>-Parameter in dershape()-Funktion funktioniert genau wie derselbe Parameter in derpath()-Funktion. - Die
shape()-Funktion erfordert die Angabe eines oder mehrerer<shape-command>s, wobei jeder Befehl einen zugrundeliegenden Pfadbefehl verwendet, wie MoveTo, LineTo und ClosePath.
Jedoch bietet shape() mehrere Vorteile gegenüber der Verwendung von path():
shape()verwendet standardmäßige CSS-Syntax, was es einfacher macht, Formen direkt in Ihrem Stylesheet zu erstellen und zu ändern. Im Vergleich dazu verwendetpath()die SVG-Pfad-Syntax, die für diejenigen, die mit SVG nicht vertraut sind, weniger intuitiv ist.shape()unterstützt eine Vielzahl von CSS-Einheiten, einschließlich Prozentwerte,remundem.path()hingegen definiert Formen als eine einzelne Zeichenfolge und beschränkt die Einheiten aufpx.shape()erlaubt auch die Verwendung von CSS-Mathematikfunktionen wiecalc(),max()undabs(), was mehr Vielseitigkeit bei der Definition von Formen bietet.
Formale Syntax
<shape()> =
shape( <'fill-rule'>? from <position> , <shape-command># )
<fill-rule> =
nonzero |
evenodd
<position> =
<position-one> |
<position-two> |
<position-four>
<shape-command> =
<move-command> |
<line-command> |
close |
<horizontal-line-command> |
<vertical-line-command> |
<curve-command> |
<smooth-command> |
<arc-command>
<position-one> =
left |
center |
right |
top |
bottom |
x-start |
x-end |
y-start |
y-end |
block-start |
block-end |
inline-start |
inline-end |
<length-percentage>
<position-two> =
[ left | center | right | x-start | x-end ] && [ top | center | bottom | y-start | y-end ] |
[ left | center | right | x-start | x-end | <length-percentage> ] [ top | center | bottom | y-start | y-end | <length-percentage> ] |
[ block-start | center | block-end ] && [ inline-start | center | inline-end ] |
[ start | center | end ]{2}
<position-four> =
[ [ left | right | x-start | x-end ] <length-percentage> ] && [ [ top | bottom | y-start | y-end ] <length-percentage> ] |
[ [ block-start | block-end ] <length-percentage> ] && [ [ inline-start | inline-end ] <length-percentage> ] |
[ [ start | end ] <length-percentage> ]{2}
<move-command> =
move <command-end-point>
<line-command> =
line <command-end-point>
<horizontal-line-command> =
hline [ to [ <length-percentage> | left | center | right | x-start | x-end ] | by <length-percentage> ]
<vertical-line-command> =
vline [ to [ <length-percentage> | top | center | bottom | y-start | y-end ] | by <length-percentage> ]
<curve-command> =
curve [ [ to <position> with <control-point> [ / <control-point> ]? ] | [ by <coordinate-pair> with <relative-control-point> [ / <relative-control-point> ]? ] ]
<smooth-command> =
smooth [ [ to <position> [ with <control-point> ]? ] | [ by <coordinate-pair> [ with <relative-control-point> ]? ] ]
<arc-command> =
arc <command-end-point> [ [ of <length-percentage>{1,2} ] && <arc-sweep>? && <arc-size>? && [ rotate <angle> ]? ]
<length-percentage> =
<length> |
<percentage>
<command-end-point> =
to <position> |
by <coordinate-pair>
<control-point> =
<position> |
<relative-control-point>
<coordinate-pair> =
<length-percentage>{2}
<relative-control-point> =
<coordinate-pair> [ from [ start | end | origin ] ]?
<arc-sweep> =
cw |
ccw
<arc-size> =
large |
small
Beispiele
>Verwendung von shape(), um einen Pfad zu definieren
Dieses Beispiel zeigt, wie die shape()-Funktion in der offset-path-Eigenschaft verwendet werden kann, um die Form des Pfades zu definieren, dem ein Element folgen kann.
Die erste Form, shape1, folgt einem kubischen Bézierkurvenpfad, der durch den curve to-Befehl definiert ist. Danach zeichnet der close-Befehl eine gerade Linie vom Endpunkt der Kurve zurück zum Ausgangspunkt, der im from-Befehl definiert ist. Schließlich bewegt sich shape1 an seine neue Position bei 0px 150px und folgt dann einer horizontalen Linie.
Die zweite Form, shape2, folgt zunächst einer horizontalen Linie, dann bewegt sie sich zurück zu ihrer Ausgangsposition bei 50px 90px. Dann folgt sie einer vertikalen Linie, bevor sie den Pfad zurück zum Ausgangspunkt schließt.
Beide Formen beginnen mit ihren ursprünglichen Farben und gehen allmählich in hotpink über bis zum Ende der move-Animation, wobei sie zu ihrer ursprünglichen Farbe zurückkehren, wenn die Animation neu startet. Diese zyklische Farbänderung gibt Ihnen einen visuellen Hinweis auf den Verlauf und Neustart der Animation.
.shape {
width: 50px;
height: 50px;
background: #2bc4a2;
position: absolute;
text-align: center;
line-height: 50px;
animation: move 6s infinite linear;
}
.shape1 {
offset-path: shape(
from 30% 60px,
curve to 180px 180px with 90px 190px,
close,
move by 0px 150px,
hline by 40%
);
}
.shape2 {
offset-path: shape(
from 50px 90px,
hline to 8em,
move to 50px 90px,
vline by 20%,
close
);
}
@keyframes move {
0% {
offset-distance: 0%;
}
100% {
offset-distance: 100%;
background-color: hotpink;
}
}
Ergebnis
Verwendung von shape(), um den sichtbaren Teil eines Elements zu definieren
Dieses Beispiel zeigt, wie die shape()-Funktion in der clip-path-Eigenschaft verwendet werden kann, um unterschiedliche Formen für die Beschnittregion zu erstellen. Die erste Form (shape1) verwendet ein Dreieck, das durch gerade Linien definiert ist. Die zweite Form (shape2) beinhaltet Kurven und glatte Übergänge; sie zeigt auch die Verwendung des <move-command> nach dem close-Befehl, der eine rechteckige Form zur Beschnittregion hinzufügt.
.shape {
width: 100%;
height: 100%;
background: #2bc4a2;
position: absolute;
text-align: center;
line-height: 50px;
}
/* Triangular clipping region */
.shape1 {
clip-path: shape(from 0% 0%, line to 100% 0%, line to 50% 100%, close);
}
/* A Heart clipping region using curve and arc transitions
and a box using hline and vline transitions */
.shape2 {
clip-path: shape(
from 20px 70px,
arc to 100px 70px of 1% cw,
arc to 180px 70px of 1% cw,
curve to 100px 190px with 180px 130px,
curve to 20px 70px with 20px 130px,
close,
move to 150px 150px,
hline by 40px,
vline by 40px,
hline by -40px,
close
);
}
Ergebnis
Verwendung von shape(), um Kurven mit relativen Kontrollpunkten zu zeichnen
Wie in den vorherigen Beispielen wird auch hier clip-path verwendet, um verschiedene Formen für die Beschnittregionen der Elemente zu erstellen. Die Formen werden unter Verwendung einer Kombination von <curve-command> und <smooth-command> spezifiziert, und die Kontrollpunkte werden unter Verwendung von <relative-control-point> Werten angegeben.
Die erste Form (shape1) zeichnet zwei kubische Bézier-Kurven.
- Die erste Kurve beginnt in der Mitte der linken Kante der Box und wird zu einem Punkt
200pxentlang der x-Achse gezeichnet — der Mitte der rechten Kante der Box. Sie verwendet einen Kontrollpunkt relativ zur Start der Kurve und einen Kontrollpunkt relativ zum Ursprung (oben links der Box). - Die zweite Kurve beginnt in der rechten Mitte der Box und wird
-200pxentlang der x-Achse gezeichnet — der Mitte der linken Kante der Box. Sie verwendet einen Kontrollpunkt relativ zum Ursprung und einen Kontrollpunkt relativ zur Start der Kurve.
#shape1 {
width: 200px;
height: 200px;
background: green;
clip-path: shape(
from center left,
curve by 200px 0 with 50% -50% from start / 50% 0 from origin,
curve by -200px 0 with 50% 100% from origin / -50% 50% from start,
close
);
}
Die zweite Form (shape2) zeichnet eine quadratische Bézier-Kurve und eine kubische Bézier-Kurve.
- Die erste Kurve beginnt in der Mitte der linken Kante der Box und wird zu einem absoluten Punkt
200pxvom Ursprung entlang der x-Achse und100pxvom Ursprung entlang der y-Achse gezeichnet. Sie verwendet einen Kontrollpunkt relativ zur Start der Kurve. - Die zweite Kurve beginnt am Endpunkt der vorherigen Kurve und wird zur Mitte links der Box gezeichnet. Sie verwendet einen Kontrollpunkt relativ zur Start der Kurve und einen Kontrollpunkt relativ zum Ende.
#shape2 {
width: 200px;
height: 200px;
background: purple;
clip-path: shape(
from center left,
curve to 200px 100px with 50% -80% from start,
curve to center left with 0% 70% from start / 20% 0% from end,
close
);
}
Die dritte Form (shape3) zeichnet eine quadratische Bézier-Kurve und eine kubische Bézier-Kurve unter Verwendung eines smooth-Befehls.
- Die erste Kurve beginnt in der Mitte der linken Kante der Box und wird zu einem Punkt
200pxentlang der x-Achse gezeichnet. Sie verwendet einen Kontrollpunkt relativ zur Start der Kurve. - Die zweite Kurve beginnt am Endpunkt der vorherigen Kurve und wird zur Mitte der Box gezeichnet. Sie verwendet einen Kontrollpunkt relativ zur Start der Kurve (der letzte Kontrollpunkt der vorherigen Kurve) und einen Kontrollpunkt relativ zum Ursprung.
#shape3 {
width: 200px;
height: 200px;
background: orangered;
clip-path: shape(
from center left,
curve by 200px 0px with 50% -80% from start,
smooth to center with 50% 100% from origin,
close
);
}
Ergebnis
Spezifikationen
| Spezifikation |
|---|
| CSS Shapes Module Level 2> # shape-function> |
Browser-Kompatibilität
Siehe auch
border-shapeclip-pathoffset-path- CSS-Formen Modul
- Überblick über Formen Leitfaden
- Grundformen Leitfaden