Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten. Erfahre mehr über dieses Experiment.

View in English Always switch to English

shape-outside

Baseline Widely available *

This feature is well established and works across many devices and browser versions. It’s been available across browsers since ⁨Januar 2020⁩.

* Some parts of this feature may have varying levels of support.

Die shape-outside CSS Eigenschaft definiert eine Form – die möglicherweise nicht rechteckig ist –, um die sich angrenzender Inline-Inhalt wickeln soll. Standardmäßig wickelt sich Inline-Inhalt um seinen Randbereich; shape-outside bietet eine Möglichkeit, dieses Wickeln anzupassen und ermöglicht es, Text um komplexe Objekte anstatt rechteckiger Boxen zu wickeln.

Probieren Sie es aus

shape-outside: circle(50%);
shape-outside: ellipse(130px 140px at 20% 20%);
shape-outside: url("/shared-assets/images/examples/round-balloon.png");
shape-outside: polygon(50% 0, 100% 50%, 50% 100%, 0 50%);
<section class="default-example" id="default-example">
  <div class="example-container">
    <img
      class="transition-all"
      id="example-element"
      src="/shared-assets/images/examples/round-balloon.png"
      width="150" />
    We had agreed, my companion and I, that I should call for him at his house,
    after dinner, not later than eleven o’clock. This athletic young Frenchman
    belongs to a small set of Parisian sportsmen, who have taken up “ballooning”
    as a pastime. After having exhausted all the sensations that are to be found
    in ordinary sports, even those of “automobiling” at a breakneck speed, the
    members of the “Aéro Club” now seek in the air, where they indulge in all
    kinds of daring feats, the nerve-racking excitement that they have ceased to
    find on earth.
  </div>
</section>
.example-container {
  text-align: left;
  padding: 20px;
}

#example-element {
  float: left;
  width: 150px;
  margin: 20px;
}

Syntax

css
/* Keyword values */
shape-outside: none;
shape-outside: margin-box;
shape-outside: content-box;
shape-outside: border-box;
shape-outside: padding-box;

/* Function values */
shape-outside: circle();
shape-outside: ellipse();
shape-outside: inset(10px 10px 10px 10px);
shape-outside: polygon(10px 10px, 20px 20px, 30px 30px);

/* Shape box with basic shape */
shape-outside: circle() border-box;
shape-outside: margin-box ellipse();

/* <url> value */
shape-outside: url("image.png");

/* <gradient> value */
shape-outside: linear-gradient(45deg, white 150px, red 150px);

/* Global values */
shape-outside: inherit;
shape-outside: initial;
shape-outside: revert;
shape-outside: revert-layer;
shape-outside: unset;

Die shape-outside Eigenschaft wird unter Verwendung der unten aufgelisteten Werte angegeben, die den Umflussbereich für float-Elemente definieren. Der Umflussbereich bestimmt die Form, um die sich der Inline-Inhalt (float-Elemente) wickelt.

Werte

none

Der Umflussbereich ist nicht betroffen. Inline-Inhalt wickelt sich wie üblich um den Randbereich des Elements.

<shape-box>

Der Umflussbereich wird gemäß der Form der Kanten eines Float-Elements berechnet (wie im CSS-Box-Modell definiert). Dies kann margin-box, border-box, padding-box oder content-box sein. Die Form beinhaltet jede Krümmung, die durch die border-radius Eigenschaft erzeugt wird (Verhalten ähnlich wie bei background-clip).

margin-box

Definiert die Form, die durch den äußeren Rand umschlossen wird. Die Eckenradien dieser Form werden durch die entsprechenden border-radius und margin Werte bestimmt. Wenn das Verhältnis von border-radius / margin 1 oder größer ist, dann ist der Eckenradius der Randbox border-radius + margin. Wenn das Verhältnis kleiner als 1 ist, dann ist der Eckenradius der Randbox border-radius + (margin * (1 + (ratio - 1) ^ 3)).

border-box

Definiert die Form, die durch die äußere Kante des Randes umschlossen wird. Die Form folgt den normalen Regeln zur Randkrümmung für die Außenseite des Randes.

padding-box

Definiert die Form, die durch die äußere Kante des Abstands umschlossen wird. Die Form folgt den normalen Regeln zur Randkrümmung für die Innenseite des Randes.

content-box

Definiert die Form, die durch die äußere Kante des Inhalts umschlossen wird. Jeder Eckenradius dieser Box ist entweder 0 oder border-radius - border-width - padding, je nachdem, welcher Wert größer ist.

<basic-shape>

Der Umflussbereich wird basierend auf der Form berechnet, die durch eine inset(), circle(), ellipse() oder polygon() Funktion erstellt wird; andere <basic-shape> Funktionen sind ungültig. Wenn ein <shape-box> ebenfalls angegeben wird, definiert es die Referenzbox für die <basic-shape> Funktion. Andernfalls ist die Standard-Referenzbox margin-box.

<image>

Der Umflussbereich wird extrahiert und basierend auf dem Alphakanal des angegebenen <image> berechnet, wie durch shape-image-threshold definiert.

Hinweis: Falls das Bild ungültig ist, ist der Effekt derselbe, als ob das Schlüsselwort none angegeben worden wäre. Zusätzlich muss das Bild mit CORS Headern bereitgestellt werden, die eine Nutzung erlauben.

Formale Definition

Anfangswertnone
Anwendbar aufFlusselemente
VererbtNein
Berechneter Wertwie definiert für <basic-shape> (gefolgt von shape-box, falls angegeben), dem <image>, dessen URI absolut gemacht wurde, ansonsten wie angegeben.
Animationstypja, wie angegeben für <basic-shape>, ansonsten nein

Formale Syntax

shape-outside = 
none |
[ <basic-shape> || <shape-box> ] |
<image>

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

<image> =
<url> |
<image()> |
<image-set()> |
<cross-fade()> |
<element()> |
<gradient>

<visual-box> =
content-box |
padding-box |
border-box

<image()> =
image( <image-tags>? [ <image-src>? , <color>? ]! )

<image-set()> =
image-set( <image-set-option># )

<cross-fade()> =
cross-fade( <cf-image># )

<element()> =
element( <id-selector> )

<image-tags> =
ltr |
rtl

<image-src> =
<url> |
<string>

<image-set-option> =
[ <image> | <string> ] [ <resolution> || type( <string> ) ]?

<cf-image> =
[ <image> | <color> ] &&
<percentage [0,100]>?

<id-selector> =
<hash-token>

Beispiele

Text trichtern

HTML

html
<div class="main">
  <div class="left"></div>
  <div class="right"></div>
  <p>
    Sometimes a web page's text content appears to be funneling your attention
    towards a spot on the page to drive you to follow a particular link.
    Sometimes you don't notice.
  </p>
</div>

CSS

css
.main {
  width: 530px;
}

.left,
.right {
  background-color: lightgray;
  height: 12ex;
  width: 40%;
}

.left {
  clip-path: polygon(0 0, 100% 100%, 0 100%);
  float: left;
  shape-outside: polygon(0 0, 100% 100%, 0 100%);
}

.right {
  clip-path: polygon(100% 0, 100% 100%, 0 100%);
  float: right;
  shape-outside: polygon(100% 0, 100% 100%, 0 100%);
}

p {
  text-align: center;
}

Ergebnis

Spezifikationen

Specification
CSS Shapes Module Level 1
# shape-outside-property

Browser-Kompatibilität

Siehe auch