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
/* 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.
-
Ü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
scrollLeftund über Methoden wiescrollTo(). clip-
Überlaufender Inhalt wird an der durch die Eigenschaft
overflow-clip-margindefinierten 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.
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.
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.
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.
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.
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.
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
| Anfangswert | visible |
|---|---|
| Anwendbar auf | Block-containers, flex containers, and grid containers |
| Vererbt | Nein |
| Berechneter Wert | wie die jeweiligen Kurzschreibweisen:
|
| Animationstyp | diskret |
Formale Syntax
overflow =
<'overflow-block'>{1,2}
<overflow-block> =
visible |
hidden |
clip |
scroll |
auto
Beispiele
>Ergebnisse verschiedener overflow-Schlüsselwörter veranschaulichen
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
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
overflow-x,overflow-yoverflow-block,overflow-clip-margin,overflow-inlineclip,display,text-overflow,white-space- SVG-Attribut
overflow - Scroll-Fortschritts-Zeitleisten
- Modul CSS overflow
- Modul CSS scroll-driven animations
- Scrollbare Bereiche für reine Tastaturbedienung auf adrianroselli.com (2022)