Dieser Inhalt wurde automatisch aus dem Englischen übersetzt, und kann Fehler enthalten.Erfahre mehr über dieses Experiment.
\<length>
Baseline Widely available *
This feature is well established and works across many devices and browser versions. It’s been available across browsers since Juli 2015.
* Some parts of this feature may have varying levels of support.
Der<length>CSSDatentyp repräsentiert einen Distanzwert. Längen können in zahlreichen CSS-Eigenschaften verwendet werden, wie z.B.width,height,margin,padding,border-width,font-size undtext-shadow.
Hinweis:Obwohl<percentage>-Werte in einigen der gleichen Eigenschaften wie<length>-Werte verwendbar sind, sind sie keine<length>-Werte. Siehe<length-percentage>.
In diesem Artikel
Syntax
Der<length>-Datentyp besteht aus einer<number>, gefolgt von einer der unten aufgelisteten Einheiten. Wie bei allen CSS-Dimensionen gibt es keinen Abstand zwischen der Zahl und der Einheit. Das Angeben der Längeneinheit ist optional, wenn die Zahl0 ist.
Hinweis:Einige Eigenschaften erlauben negative<length>-Werte, während andere dies nicht tun.
Derangegebene Wert einer Länge (specified length) wird durch seine Menge und Einheit repräsentiert. Derberechnete Wert einer Länge (computed length) ist die angegebene Länge, aufgelöst zu einer absoluten Länge, und seine Einheit wird nicht unterschieden.
Die<length>-Einheiten können relativ oder absolut sein. Relative Längen stellen eine Messung in Bezug auf eine andere Distanz dar. Abhängig von der Einheit kann diese Distanz die Größe eines bestimmten Zeichens, dieZeilenhöhe oder die Größe desViewports sein. Stylesheets, die relative Längeneinheiten verwenden, können einfacher von einer Ausgabenumgebung auf eine andere skaliert werden.
Hinweis:Kindelemente erben nicht die relativen Werte, wie sie für ihr Elternelement angegeben sind; sie erben die berechneten Werte.
Relative Längeneinheiten
CSS relative Längeneinheiten basieren auf Schriftart-, Container- oder Viewportgrößen.
Relative Längeneinheiten basierend auf Schriftart
Schriftlängen definieren den<length>-Wert in Bezug auf die Größe eines bestimmten Zeichens oder einer Schrifteigenschaft in der aktuell in einem Element oder seinem Elternelement geltenden Schriftart.
Hinweis:Diese Einheiten, insbesondereem und das wurzelskalierenderem, werden oft verwendet, um skalierbare Layouts zu erstellen, die den vertikalen Rhythmus der Seite beibehalten, auch wenn der Benutzer die Schriftgröße ändert.
capEntspricht der "Kapphöhe" (nominale Höhe von Großbuchstaben) der
fontdes Elements.chRepräsentiert die Breite oder, genauer gesagt, dasVorwärtsmaß des Zeichens
0(Null, das Unicode-Zeichen U+0030) in derfontdes Elements.In Fällen, in denen es unmöglich oder unpraktisch ist, das Maß des0-Glyphen zu bestimmen, muss angenommen werden, dass es0.5embreit und1emhoch ist.emRepräsentiert die berechnete
font-sizedes Elements. Wenn sie auf derfont-size-Eigenschaft selbst verwendet wird, repräsentiert sie diegeerbte Schriftgröße des Elements.exEntspricht derx-Höhe der
fontdes Elements. In Schriften mit dem Buchstabenxist dies im Allgemeinen die Höhe der Kleinbuchstaben in der Schriftart;1ex ≈ 0.5emin vielen Schriften.icRepräsentiert das verwendeteVorwärtsmaß des „水“-Glyphen (CJK-Wasserideogramm, U+6C34), das in der Schriftart gefunden wird, die es rendert.
lhEntspricht dem berechneten Wert der
line-height-Eigenschaft des Elements, auf dem sie verwendet wird, umgerechnet in eine absolute Länge. Diese Einheit ermöglicht Längenberechnungen basierend auf der theoretischen Größe einer idealen leeren Zeile. Die Größe tatsächlicher Zeilenboxen kann jedoch je nach Inhalt abweichen.
Relative Längeneinheiten basierend auf der Schriftart des Root-Elements
Schriftartenverwandte relative Längeneinheiten des Root-Elements definieren den<length>-Wert in Bezug auf die Größe eines bestimmten Zeichens oder einer Schrifteigenschaft desRoot-Elements:
rcapEntspricht der "Kapphöhe" (nominale Höhe von Großbuchstaben) der
fontdes Root-Elements.rchEntspricht der Breite oder demVorwärtsmaß des Glyphen
0(Null, das Unicode-Zeichen U+0030) in derfontdes Root-Elements.remRepräsentiert die
font-sizedes Root-Elements (typischerweise<html>). Wenn sie innerhalb derfont-sizedes Root-Elements verwendet wird, repräsentiert sie ihren Anfangswert. Ein gängiger Browser-Standardwert ist16px, aber benutzerdefinierte Einstellungen können dies ändern.rexEntspricht der x-Höhe der
fontdes Root-Elements.ricEntspricht dem Wert der
ic-Einheit in der Schriftart des Root-Elements.rlhEntspricht dem Wert der
lh-Einheit in der Schriftart des Root-Elements. Diese Einheit ermöglicht Längenberechnungen basierend auf der theoretischen Größe einer idealen leeren Zeile. Die Größe tatsächlicher Zeilenboxen kann jedoch je nach Inhalt abweichen.
Relative Längeneinheiten basierend auf dem Viewport
DieView-Port-Prozentsatz-Längeneinheiten basieren auf vier verschiedenen Viewport-Größen: klein, groß, dynamisch und Standard. Die Zulassung der verschiedenen Viewport-Größen ist eine Reaktion auf Browser-Schnittstellen, die sich dynamisch erweitern und zusammenziehen sowie Inhalte darunter verbergen und anzeigen.
- Kleine Viewport-Einheiten
Wenn Sie die kleinste mögliche Viewport-Größe in Reaktion auf dynamisch expandierende Browserschnittstellen wollen, sollten Sie die kleine Viewport-Größe verwenden. Die kleine Viewport-Größe ermöglicht es, dass der von Ihnen entworfene Inhalt den gesamten Viewport füllt, wenn die Browserschnittstellen erweitert werden. Diese Größe kann jedoch auch leeren Raum hinterlassen, wenn die Browserschnittstellen zurückgezogen werden.
Zum Beispiel wird ein Element, das mit Viewport-Prozent-Einheiten basierend auf der kleinen Viewport-Größe dimensioniert wird, den Bildschirm perfekt füllen, ohne dass Inhalte verdeckt werden, wenn alle dynamischen Browserschnittstellen angezeigt werden. Wenn diese Browserschnittstellen jedoch verborgen werden, kann um das Element zusätzlich Platz sichtbar werden. Die kleinen Viewport-Prozent-Einheiten sind im Allgemeinen "sicherer" zu verwenden, könnten aber nicht das attraktivste Layout nach einer Benutzer-Interaktion mit der Seite erzeugen.
Die kleine Viewport-Größe wird durch das
sv-Präfix repräsentiert und resultiert in densv*-Viewport-Prozent-Längeneinheiten. Die Größen der kleinen Viewport-Prozent-Einheiten sind fixiert und daher stabil, es sei denn, der Viewport wird selbst geändert.- Große Viewport-Einheiten
Wenn Sie die größte mögliche Viewport-Größe in Reaktion auf dynamisch zurückziehende Browserschnittstellen wollen, sollten Sie die große Viewport-Größe verwenden. Die große Viewport-Größe ermöglicht es, dass der von Ihnen entworfene Inhalt den gesamten Viewport füllt, wenn die Browserschnittstellen zurückgezogen werden. Beachten Sie, dass Inhalte verborgen werden können, wenn die Browserschnittstellen expandieren.
Zum Beispiel verstecken Browser auf Mobiltelefonen, bei denen der Platz auf dem Bildschirm sehr begrenzt ist, oft Teile oder die gesamte Titel- und Adressleiste, nachdem der Benutzer die Seite zu scrollen beginnt. Wenn ein Element mit einer Viewport-Prozent-Einheit basierend auf der großen Viewport-Größe dimensioniert wird, füllt der Inhalt des Elements die gesamte sichtbare Seite, wenn diese Browerschnittstellen verborgen sind. Wenn diese rückziehbaren Browserschnittstellen jedoch angezeigt werden, können sie den Inhalt verbergen, der mit dengroßen Viewport-Prozent-Einheiten dimensioniert oder positioniert ist.
Die große Viewport-Einheit wird durch das
lv-Präfix repräsentiert und resultiert in denlv*-Viewport-Prozent-Einheiten. Die Größen der großen Viewport-Prozent-Einheiten sind fixiert und daher stabil, es sei denn, der Viewport wird selbst geändert.- Dynamische Viewport-Einheiten
Wenn Sie wollen, dass der Viewport automatisch in Reaktion auf dynamisch expandierende oder zurückziehende Browserschnittstellen dimensioniert wird, können Sie die dynamische Viewport-Größe verwenden. Die dynamische Viewport-Größe ermöglicht es, dass der von Ihnen entworfene Inhalt genau in den Viewport passt, unabhängig von der Anwesenheit dynamischer Browserschnittstellen.
Die dynamische Viewport-Einheit wird durch das
dv-Präfix repräsentiert und resultiert in dendv*-Viewport-Prozent-Einheiten. Die Größen der dynamischen Viewport-Prozent-Einheiten sind nicht stabil, selbst wenn der Viewport selbst unverändert bleibt.Hinweis:Während die dynamische Viewport-Größe Ihnen mehr Kontrolle und Flexibilität geben kann, kann die Verwendung von Viewport-Prozent-Einheiten basierend auf der dynamischen Viewport-Größe dazu führen, dass der Inhalt während des Scrollens auf einer Seite umdimensionalisiert wird. Dies kann zu einer Verschlechterung der Benutzeroberfläche führen und die Leistung beeinträchtigen.
- Standard-Viewport-Einheiten
Die Standard-Viewport-Größe wird durch den Browser definiert. Das Verhalten der resultierenden Viewport-Prozent-Einheit könnte der Viewport-Prozent-Einheit basierend auf der kleinen Viewport-Größe, der großen Viewport-Größe, einer Zwischengröße zwischen den beiden oder der dynamischen Viewport-Größe entsprechen.
Hinweis:Zum Beispiel könnte ein Browser die Standard-Viewport-Prozent-Einheit für die Höhe (
vh) implementieren, die der großen Viewport-Prozent-Höheneinheit (lvh) entspricht. In diesem Fall könnte dies Inhalte auf einem vollständigen Seiten-Display verdecken, während die Browserschnittstelle erweitert ist. Derzeit sind alle Standard-Viewport-Einheiten (vh,vw, etc.) ihren großen Viewport-Pendants (lvh,lvw, etc.) gleichwertig.
Viewport-Prozent-Längen definieren<length>-Werte in Prozent relativ zur Größe des initialenUmfassungsblocks, welcher wiederum auf entweder der Größe desViewports oder dem Seitenbereich basiert, d.h. dem sichtbaren Teil des Dokuments. Wenn die Höhe oder Breite des initialen Umfassungsblocks geändert wird, werden die auf ihnen basierenden Elemente entsprechend skaliert. Es gibt eine Viewport-Prozent-Längeneinheit-Variante entsprechend jeder der Viewport-Größen, wie unten beschrieben.
Hinweis:Viewport-Längen sind in@page-Deklarationsblöcken ungültig.
vhRepräsentiert einen Prozentsatz der Höhe des initialenUmfassungsblocks des Viewports.
1vhist 1% der Viewport-Höhe. Zum Beispiel, wenn die Viewport-Höhe300pxbeträgt, dann ist ein Wert von70vhauf einer Eigenschaft210px.Die entsprechenden Viewport-Prozent-Einheiten für kleine, große und dynamische Viewport-Größen sind
svh,lvhunddvh.vhist gleichwertig zulvh, repräsentiert die Viewport-Prozent-Längeneinheit basierend auf der großen Viewport-Größe.vwRepräsentiert einen Prozentsatz der Breite des initialenUmfassungsblocks des Viewports.
1vwist 1% der Viewport-Breite. Zum Beispiel, wenn die Viewport-Breite800pxbeträgt, dann ist ein Wert von50vwauf einer Eigenschaft400px.Für kleine, große und dynamische Viewport-Größen sind die entsprechenden Viewport-Prozent-Einheiten
svw,lvwunddvw.vwist gleichwertig zulvw, repräsentiert die Viewport-Prozent-Längeneinheit basierend auf der großen Viewport-Größe.vmaxRepräsentiert in Prozent die größere von
vwundvh.Für kleine, große und dynamische Viewport-Größen sind die entsprechenden Viewport-Prozent-Einheiten
svmax,lvmaxunddvmax.vmaxist gleichwertig zulvmax, repräsentiert die Viewport-Prozent-Längeneinheit basierend auf der großen Viewport-Größe.vminRepräsentiert in Prozent die kleinere von
vwundvh.Für kleine, große und dynamische Viewport-Größen sind die entsprechenden Viewport-Prozent-Einheiten
svmin,lvminunddvmin.vminist gleichwertig zulvmin, repräsentiert die Viewport-Prozent-Längeneinheit basierend auf der großen Viewport-Größe.vbRepräsentiert den Prozentsatz der Größe des initialenUmfassungsblocks, in der Richtung derBlockachse des Root-Elements.
Für kleine, große und dynamische Viewport-Größen sind die entsprechenden Viewport-Prozent-Einheiten
svb,lvbunddvb, jeweils.vbist gleichwertig zulvb, repräsentiert die Viewport-Prozent-Längeneinheit basierend auf der großen Viewport-Größe.viRepräsentiert einen Prozentsatz der Größe des initialenUmfassungsblocks, in der Richtung derhorizontalen Achse des Root-Elements.
Für kleine, große und dynamische Viewport-Größen sind die entsprechenden Viewport-Prozent-Einheiten
svi,lviunddvi.viist gleichwertig zulvi, repräsentiert die Viewport-Prozent-Längeneinheit basierend auf der großen Viewport-Größe.
Container-Abfrage-Längeneinheiten
Wenn Sie Styles auf einen Container mithilfe von Container-Abfragen anwenden, können Sie Container-Abfrage-Längeneinheiten verwenden.Diese Einheiten geben eine Länge relativ zu den Dimensionen eines Abfrage-Containers an.Komponenten, die Einheiten der Länge relativ zu ihrem Container verwenden, sind flexibler einsetzbar in verschiedenen Containern, ohne dass konkrete Längenwerte neu berechnet werden müssen.
Wenn kein geeigneter Container für die Abfrage verfügbar ist, wird die Container-Abfrage-Längeneinheit auf diekleine Viewport-Einheit für diese Achse (sv*) zurückgesetzt.
Für weitere Informationen sieheContainer-Abfragen.
cqwRepräsentiert einen Prozentsatz der Breite des Abfrage-Containers.
1cqwist 1% der Breite des Abfrage-Containers. Zum Beispiel, wenn die Breite des Abfrage-Containers800pxbeträgt, dann ist ein Wert von50cqwauf einer Eigenschaft400px.cqhRepräsentiert einen Prozentsatz der Höhe des Abfrage-Containers.
1cqhist 1% der Höhe des Abfrage-Containers. Zum Beispiel, wenn die Höhe des Abfrage-Containers300pxbeträgt, dann ist ein Wert von10cqhauf einer Eigenschaft30px.cqiRepräsentiert einen Prozentsatz der Inline-Größe des Abfrage-Containers.
1cqiist 1% der Inline-Größe des Abfrage-Containers. Zum Beispiel, wenn die Inline-Größe des Abfrage-Containers800pxbeträgt, dann ist ein Wert von50cqiauf einer Eigenschaft400px.cqbRepräsentiert einen Prozentsatz der Block-Größe des Abfrage-Containers.
1cqbist 1% der Block-Größe des Abfrage-Containers. Zum Beispiel, wenn die Block-Größe des Abfrage-Containers300pxbeträgt, dann ist ein Wert von10cqbauf einer Eigenschaft30px.cqminRepräsentiert einen Prozentsatz des kleineren Wertes entweder der Inline-Größe oder der Block-Größe des Abfrage-Containers.
1cqminist 1% des kleineren Wertes entweder der Inline-Größe oder der Block-Größe des Abfrage-Containers. Zum Beispiel, wenn die Inline-Größe des Abfrage-Containers800pxbeträgt und seine Block-Größe300px, dann ist ein Wert von50cqminauf einer Eigenschaft150px.cqmaxRepräsentiert einen Prozentsatz des größeren Wertes entweder der Inline-Größe oder der Block-Größe des Abfrage-Containers.
1cqmaxist 1% des größeren Wertes entweder der Inline-Größe oder der Block-Größe des Abfrage-Containers. Zum Beispiel, wenn die Inline-Größe des Abfrage-Containers800pxund seine Block-Größe300pxbeträgt, dann ist ein Wert von50cqmaxauf einer Eigenschaft400px.
Absolute Längeneinheiten
Absolute Längeneinheiten repräsentieren eine physische Messung, wenn die physischen Eigenschaften des Ausgabemediums bekannt sind, wie z.B. für den Drucklayout. Dies wird durchgeführt, indem eine der Einheiten an einephysische Einheit oder dievisuelle Winkelgröße verankert wird und dann die anderen relativ dazu definiert werden. Physische Einheiten umfassencm,in,mm,pc,pt,px undQ. Die Verankerung wird unterschiedlich für Geräte mit niedriger Auflösung, wie Bildschirme, versus Geräte mit hoher Auflösung, wie Drucker, durchgeführt.
Für Geräte mit niedriger dpi repräsentiert die Einheitpx das physischeReferenzpixel; andere Einheiten werden relativ dazu definiert. Deshalb wird1in als96px definiert, was72pt entspricht. Die Folge dieser Definition ist, dass auf solchen Geräten die in Zoll (in), Zentimetern (cm) oder Millimetern (mm) beschriebenen Dimensionen nicht unbedingt mit der Größe der physischen Einheit mit dem gleichen Namen übereinstimmen.
Für Geräte mit hoher dpi sind Zoll (in), Zentimeter (cm) und Millimeter (mm) die gleichen wie ihre physischen Gegenstücke. Daher wird diepx-Einheit relativ zu ihnen definiert (1/96 von1in).
Hinweis:Viele Nutzer erhöhen die Standard-Schriftgröße ihresBenutzeragenten, um Text besser lesbar zu machen. Absolute Längen können zu Barrierefreiheitsproblemen führen, da sie fest sind und nicht an Benutzereinstellungen angepasst werden. Aus diesem Grund sollten Sie relative Längen (wieem oderrem) bevorzugen, wenn Siefont-size setzen.
pxEin Pixel. Für Bildschirmdarstellungen repräsentiert es traditionell einGerätepixel (Punkt). Hingegen implizieren fürDrucker undBildschirme mit hoher Auflösung ein CSS-Pixel mehrere Gerätepixel.
1px=1in / 96.cmEin Zentimeter.
1cm=96px / 2.54.mmEin Millimeter.
1mm=1cm / 10.QEin Viertel eines Millimeters.
1Q=1cm / 40.inEin Zoll.
1in=2.54cm=96px.pcEine Pica.
1pc=12pt=1in / 6.ptEin Punkt.
1pt=1in / 72.
Interpolation
Wenn animiert, werden Werte des<length>-Datentyps als reale, Gleitkommazahlen interpoliert. DieInterpolation erfolgt auf dem berechneten Wert. Die Geschwindigkeit der Interpolation wird durch dieEasing-Funktion beausdruckt, die mit der Animation assoziiert ist.
Beispiele
>Vergleich verschiedener Längeneinheiten
Das folgende Beispiel bietet Ihnen ein Eingabefeld, in das Sie einen<length>-Wert (z.B.300px,50%,30vw) eingeben können, um die Breite einer Ergebnissleiste festzulegen, die darunter erscheint, sobald Sie dieEnter- oder dieReturn-Taste gedrückt haben.
Dies ermöglicht Ihnen, die Effekte verschiedener Längeneinheiten zu vergleichen und gegenüberzustellen.
HTML
<div> <div> <label for="length">Enter width:</label> <input type="text" /> </div> <div></div></div><div></div>CSS
html { font-family: sans-serif; font-weight: bold; box-sizing: border-box;}.outer { width: 100%; height: 50px; background-color: #eeeeee; position: relative;}.inner { height: 50px; background-color: #999999; box-shadow: inset 3px 3px 5px rgb(255 255 255 / 50%), inset -3px -3px 5px rgb(0 0 0 / 50%);}.result { height: 20px; box-shadow: inset 3px 3px 5px rgb(255 255 255 / 50%), inset -3px -3px 5px rgb(0 0 0 / 50%); background-color: orange; display: flex; align-items: center; margin-top: 10px;}.result code { position: absolute; margin-left: 20px;}.results { margin-top: 10px;}.input-container { position: absolute; display: flex; justify-content: flex-start; align-items: center; height: 50px;}label { margin: 0 10px 0 20px;}JavaScript
const inputDiv = document.querySelector(".inner");const inputElem = document.querySelector("input");const resultsDiv = document.querySelector(".results");inputElem.addEventListener("change", () => { inputDiv.style.width = inputElem.value; const result = document.createElement("div"); result.className = "result"; result.style.width = inputElem.value; const code = document.createElement("code"); code.textContent = `width: ${inputElem.value}`; result.appendChild(code); resultsDiv.appendChild(result); inputElem.value = ""; inputElem.focus();});Ergebnis
Spezifikationen
| Specification |
|---|
| CSS Values and Units Module Level 4> # lengths> |