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

View in English Always switch to English

CSS-Eigenschaft overflow

Baseline
Weitgehend verfügbar

Diese Funktion ist gut etabliert und funktioniert auf vielen Geräten und in vielen Browserversionen. Sie ist seit Juli 2015 browserübergreifend verfügbar.

Die CSS-Kurzschreibweise overflow legt fest, wie sich ein Element verhalten soll, wenn sein Inhalt in horizontaler und/oder vertikaler Richtung nicht in seine Padding-Box passt und überläuft.

Probieren Sie es aus

overflow: visible;
overflow: hidden;
overflow: clip;
overflow: scroll;
overflow: auto;
<section class="default-example" id="default-example">
  <p id="example-element">
    Michaelmas term lately over, and the Lord Chancellor sitting in Lincoln's
    Inn Hall. Implacable November weather. As much mud in the streets as if the
    waters had but newly retired from the face of the earth.
  </p>
</section>
#example-element {
  width: 15em;
  height: 9em;
  border: medium dotted;
  padding: 0.75em;
  text-align: left;
}

Zugehörige Eigenschaften

Diese Eigenschaft ist eine Kurzschreibweise für die folgenden CSS-Eigenschaften:

Syntax

css
/* Keyword values */
overflow: visible;
overflow: hidden;
overflow: clip;
overflow: scroll;
overflow: auto;

/* Two-value syntax: horizontal | vertical */
overflow: hidden visible;

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

Werte

Diese Eigenschaft wird mit einem oder zwei durch Leerzeichen getrennten <overflow>-Schlüsselwortwerten angegeben:

visible

Überlaufender Inhalt wird nicht abgeschnitten und kann außerhalb der Padding-Box des Elements sichtbar sein. Die Elementbox ist kein Scroll-Container. Dies ist der Standardwert.

hidden

Überlaufender Inhalt wird an der Padding-Box des Elements abgeschnitten und ist außerhalb davon nicht sichtbar. Wenn Inhalt überläuft, ist die Elementbox ein Scroll-Container ohne Scrollbalken. Scrollen ist dennoch auf andere Weise möglich, beispielsweise durch Navigieren mit der Tabulatortaste zu verborgenen fokussierbaren Elementen, über Eigenschaften wie scrollLeft und über Methoden wie scrollTo().

clip

Überlaufender Inhalt wird an der durch die Eigenschaft overflow-clip-margin definierten Abschneidekante für überlaufenden Inhalt abgeschnitten. Die Elementbox ist kein Scroll-Container, abgeschnittener Inhalt ist nicht sichtbar und programmgesteuertes Scrollen wird nicht unterstützt.

scroll

Überlaufender Inhalt wird an der Padding-Box des Elements abgeschnitten. Die Elementbox ist unabhängig davon, ob Inhalt überläuft, immer ein Scroll-Container mit Scrollbalken.

auto

Überlaufender Inhalt wird an der Padding-Box des Elements abgeschnitten. Wenn Inhalt überläuft, ist die Elementbox ein Scroll-Container mit Scrollbalken.

Nicht standardisierte Werte

Einige Browser unterstützen auch nicht standardisierte Werte:

overlay

Ein veralteter Alias für auto, der aus Gründen der Webkompatibilität in der Spezifikation definiert ist. Er wurde ursprünglich als nicht standardisierter Wert implementiert, damit Scrollbalken über dem Inhalt dargestellt werden, statt Platz einzunehmen. Von seiner Verwendung in neuem Code wird abgeraten.

Beschreibung

Elemente auf Blockebene wachsen standardmäßig so, dass ihr Inhalt hineinpasst. Wenn die Größe eines Containers begrenzt ist, kann sein Inhalt überlaufen. Die Eigenschaft overflow bestimmt, wie ein Container mit Inhalt umgeht, der über seine Ränder hinausreicht.

Die Eigenschaft overflow ist eine Kurzschreibweise für die horizontale Eigenschaft overflow-x und die vertikale Eigenschaft overflow-y. Wird nur ein Schlüsselwort angegeben, erhalten overflow-x und overflow-y denselben Wert. Werden zwei Schlüsselwörter angegeben, gilt der erste Wert für overflow-x in horizontaler Richtung und der zweite für overflow-y in vertikaler Richtung.

Zu den Möglichkeiten für den Umgang mit überlaufendem Inhalt gehören, ihn auszublenden, Scrollbalken zum Anzeigen des Inhalts bereitzustellen oder ihn außerhalb der Elementbox im umgebenden Bereich darzustellen. Diese Möglichkeiten lassen sich auch kombinieren.

Alle Werte außer visible und clip erzeugen einen neuen Blockformatierungskontext. Dieser ist für Scroll-Container erforderlich: Würde ein Float ein scrollendes Element überlagern, müsste dessen Inhalt nach jedem Scrollschritt erneut umbrochen werden, was das Scrollen verlangsamen würde.

Wann Inhalt überläuft

Inhalt läuft über, wenn der Inhalt eines Elements auf Blockebene den verfügbaren, begrenzten Platz überschreitet. Dieser Platz kann für vertikalen Überlauf durch eine Höhe (height oder max-height), für horizontalen Überlauf durch eine Breite (width oder max-width), für Überlauf in Blockrichtung durch eine Blockgröße (block-size oder max-block-size) oder für Überlauf in Inline-Richtung durch eine Inline-Größe (inline-size, max-inline-size oder white-space mit dem Wert nowrap) begrenzt sein.

Das folgende CSS begrenzt die Größe des Containers mit Eigenschaftswerten des Box-Modells. Außerdem wird eine auf die content-box begrenzte Hintergrundfarbe hinzugefügt. Sie verdeutlicht in den folgenden Erläuterungen, wie überlaufender Inhalt über die Content-Box hinausragt.

css
div {
  height: 10em;
  width: 15em;
  border: 3px solid;
  padding: 10px;

  background-color: #ededed;
  background-clip: content-box;
}

Die Werte von overflow verstehen

Die verschiedenen Werte von overflow legen fest, ob ein Element Scrollbalken hat, ob Benutzer oder Programme darin scrollen können und ob es ein Scroll-Container ist, der einen neuen Blockformatierungskontext erzeugt. Dies gilt, wenn der Inhalt des Elements überläuft – bei scroll auch dann, wenn er nicht überläuft.

Der Wert visible

Der Standardwert ist visible. Wenn Inhalt die Abmessungen eines Containers überschreitet, bleibt er standardmäßig nicht auf den Container begrenzt. Ein Element mit dem Standardwert visible oder einem ausdrücklich gesetzten Wert visible hat keine Scrollbalken, kann weder durch Benutzer noch programmgesteuert gescrollt werden und ist kein Scroll-Container. Dieser Wert erzeugt keinen neuen Blockformatierungskontext.

css
div {
  overflow: visible;
}

Bei visible wird nichts abgeschnitten. Überlaufender Inhalt ist daher außerhalb der Padding-Box des Elements sichtbar und kann angrenzenden Inhalt überlagern.

Der Wert scroll

Bei scroll wird Inhalt an der Padding-Box des Elements abgeschnitten und kann durch Scrollen sichtbar gemacht werden. User Agents zeigen Scrollbalken in beide Richtungen an, unabhängig davon, ob Inhalt überläuft. Dadurch wird verhindert, dass Scrollbalken bei Inhaltsänderungen erscheinen und verschwinden. Drucker können überlaufenden Inhalt dennoch drucken.

Das Element ist immer ein Scroll-Container – auch wenn kein Inhalt überläuft – und kann sowohl durch Benutzer als auch programmgesteuert gescrollt werden.

css
div {
  overflow: scroll;
}

Im ersten Beispiel wird ein Scroll-Container erzeugt, obwohl der Inhalt nicht überläuft. Im zweiten Beispiel wird der Inhalt an der Padding-Box abgeschnitten. Über einen Scrollbalken kann der überlaufende Inhalt angezeigt werden.

Der Wert auto

Bei auto hängt es davon ab, ob Inhalt überläuft, ob das Element Scrollbalken hat und ein Scroll-Container ist. Wenn Inhalt überläuft, verhält es sich wie scroll: Der Inhalt wird an der Padding-Box des Elements abgeschnitten und kann mithilfe von Scrollbalken sichtbar gemacht werden. Anders als bei scroll zeigen User Agents Scrollbalken nur dann an, wenn Inhalt überläuft. Passt der Inhalt in die Padding-Box des Elements, sieht es genauso aus wie mit visible, erzeugt aber dennoch einen neuen Formatierungskontext. Die Elementbox ist nur dann ein Scroll-Container, wenn Inhalt überläuft.

css
div {
  overflow: auto;
}

Werden zwei Werte angegeben und ist einer davon visible, verhält sich die Überlaufrichtung mit visible wie bei auto, sofern der andere Wert weder visible noch clip ist.

Der Wert hidden

Bei hidden wird überlaufender Inhalt an der Padding-Box des Elements abgeschnitten. Es gibt keine Scrollbalken und der abgeschnittene Inhalt ist nicht sichtbar – er ist also „verborgen“.

Wenn Inhalt überläuft, ist das Element ein Scroll-Container. Zwar gibt es keine Scrollbalken und Benutzer können den Inhalt außerhalb des sichtbaren Bereichs nicht durch Ziehen auf einem Touchscreen oder mit dem Mausrad anzeigen, der verborgene überlaufende Inhalt kann jedoch auf andere Weise durch Scrollen sichtbar gemacht werden.

Enthält der Inhalt fokussierbare Elemente, wird beim Navigieren mit der Tabulatortaste das jeweils fokussierte Element sichtbar gemacht. Auch programmgesteuertes Scrollen ist möglich. Wird die Eigenschaft scrollLeft oder scrollTop auf einen Wert gesetzt, wird um den entsprechenden Abstand vom linken beziehungsweise oberen Rand gescrollt. Sie können auch die Methode scrollTo() verwenden.

css
div {
  overflow: hidden;
}

Im ersten Beispiel läuft kein Inhalt über und das Element ist kein Scroll-Container. Im zweiten Beispiel läuft Inhalt über und wird an der Padding-Box abgeschnitten. Obwohl kein Scrollbalken vorhanden ist, kann der überlaufende Inhalt sichtbar gemacht werden, beispielsweise indem Sie mit der Tabulatortaste zum <input> im verborgenen Inhalt navigieren. Das zweite Beispiel ist ein Scroll-Container.

Der Wert clip

Bei clip wird überlaufender Inhalt standardmäßig verborgen. Es gibt keine Scrollbalken und programmgesteuertes Scrollen ist nicht möglich. Das Element ist kein Scroll-Container und es wird kein neuer Formatierungskontext erzeugt. Wenn der abgeschnittene Inhalt interaktive Elemente enthält, können verborgene fokussierbare Elemente weiterhin den Tastaturfokus erhalten. Sie werden jedoch nicht durch Scrollen sichtbar gemacht und sind daher für Benutzer, die eine Tastatur verwenden, nicht zugänglich.

Bei clip wird überlaufender Inhalt an der Abschneidekante für überlaufenden Inhalt des Elements abgeschnitten. Diese wird mit der Eigenschaft overflow-clip-margin festgelegt. Der abgeschnittene Inhalt kann um den <length>-Wert von overflow-clip-margin über die Padding-Box des Elements hinausragen. Der Standardwert ist 0px.

css
div {
  overflow: clip;
}

Im zweiten Beispiel wird der überlaufende Inhalt abgeschnitten. Wenn Sie mit der Tabulatortaste zum <input> im verborgenen Inhalt navigieren, erhält das Element den Fokus, wird aber nicht durch Scrollen sichtbar gemacht. Dieser Inhalt ist daher für Benutzer, die eine Tastatur verwenden, nicht zugänglich.

Werden zwei Werte angegeben und ist einer davon clip, verhält sich die Überlaufrichtung mit clip wie bei hidden, sofern der andere Wert weder visible noch clip ist.

Bei scrollgesteuerten Animationen

Wenn Sie mit der Funktion scroll() scrollgesteuerte Animationen erstellen, sollten Sie clip statt hidden verwenden, sofern sich im abgeschnittenen Bereich kein interaktiver Inhalt befindet und Sie nicht ausdrücklich einen Scroll-Container erzeugen möchten.

Sowohl hidden als auch clip schneiden überlaufenden Inhalt ab. overflow: clip erzeugt jedoch keinen Scroll-Container. Deshalb werden Elemente mit clip übersprungen, wenn der User Agent im DOM-Baum nach oben nach dem nächstgelegenen übergeordneten Scroll-Container sucht.

Da overflow: hidden bei überlaufendem Inhalt einen Scroll-Container erzeugt, könnten Sie unbeabsichtigt ein übergeordnetes Scrollelement erzeugen, das nicht scrollt. Verwenden Sie clip aber nur, wenn Sie sicher sind, dass dadurch kein interaktiver Inhalt abgeschnitten wird.

Überlauf bei ersetzten Elementen

Das Festlegen von overflow für Bilder und andere ersetzte Elemente funktioniert in Browsern, die CSS Overflow Module Level 4 unterstützen, wie erwartet. In früheren Versionen der Spezifikation wurden ersetzte Elemente immer an den Grenzen des umschließenden Containers abgeschnitten.

Informationen zur aktuellen Browser-Unterstützung finden Sie in der Tabelle zur Browser-Kompatibilität.

Barrierefreiheit

In einigen Browsern können scrollbare Inhaltsbereiche nicht über die Tastatur fokussiert werden. Benutzer, die ausschließlich eine Tastatur verwenden, können darin daher nicht scrollen. Damit alle diese Benutzer im Container scrollen können, ermöglichen Sie dem Element, den Fokus zu erhalten, indem Sie für den Container tabindex="0" festlegen. Damit Benutzer von Screenreadern beim Fokussieren des Containers den nötigen Kontext erhalten, legen Sie eine passende WAI-ARIA-Rolle fest, etwa role="region", und vergeben Sie mit dem Attribut aria-label oder aria-labelledby einen zugänglichen Namen.

Formale Definition

Anfangswertvisible
Anwendbar aufBlock-containers, flex containers, and grid containers
VererbtNein
Berechneter Wertwie die jeweiligen Kurzschreibweisen:
  • overflow-x: as specified, except with visible/clip computing to auto/hidden respectively if one of overflow-x or overflow-y is neither visible nor clip
  • overflow-y: as specified, except with visible/clip computing to auto/hidden respectively if one of overflow-x or overflow-y is neither visible nor clip
Animationstypdiskret

Formale Syntax

overflow = 
<'overflow-block'>{1,2}

<overflow-block> =
visible |
hidden |
clip |
scroll |
auto

Beispiele

Ergebnisse verschiedener overflow-Schlüsselwörter veranschaulichen

HTML

html
<div>
  <code>visible</code>
  <p class="visible">
    Maya Angelou: "I've learned that people will forget what you said, people
    will forget what you did, but people will never forget how you made them
    feel."
  </p>
</div>

<div>
  <code>hidden</code>
  <p class="hidden">
    Maya Angelou: "I've learned that people will forget what you said, people
    will forget what you did, but people will never forget how you made them
    feel."
  </p>
</div>

<div>
  <code>clip</code>
  <p class="clip">
    Maya Angelou: "I've learned that people will forget what you said, people
    will forget what you did, but people will never forget how you made them
    feel."
  </p>
</div>

<div>
  <code>scroll</code>
  <p class="scroll">
    Maya Angelou: "I've learned that people will forget what you said, people
    will forget what you did, but people will never forget how you made them
    feel."
  </p>
</div>

<div>
  <code>auto</code>
  <p class="auto">
    Maya Angelou: "I've learned that people will forget what you said, people
    will forget what you did, but people will never forget how you made them
    feel."
  </p>
</div>

CSS

css
p.visible {
  overflow: visible;
}

p.hidden {
  overflow: hidden;
}

p.clip {
  overflow: clip;
  overflow-clip-margin: 1em;
}

p.scroll {
  overflow: scroll;
}

p.auto {
  overflow: auto;
}

Ergebnis

Spezifikationen

Spezifikation
CSS Overflow Module Level 3
# propdef-overflow
Scalable Vector Graphics (SVG) 2
# OverflowAndClipProperties

Browser-Kompatibilität

Siehe auch