Movatterモバイル変換


[0]ホーム

URL:


  1. Web
  2. CSS
  3. Reference
  4. Values
  5. \<length>

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

View in EnglishAlways switch to English

\<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>.

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.

cap

Entspricht der "Kapphöhe" (nominale Höhe von Großbuchstaben) derfont des Elements.

ch

Repräsentiert die Breite oder, genauer gesagt, dasVorwärtsmaß des Zeichens0 (Null, das Unicode-Zeichen U+0030) in derfont des Elements.In Fällen, in denen es unmöglich oder unpraktisch ist, das Maß des0-Glyphen zu bestimmen, muss angenommen werden, dass es0.5em breit und1em hoch ist.

em

Repräsentiert die berechnetefont-size des Elements. Wenn sie auf derfont-size-Eigenschaft selbst verwendet wird, repräsentiert sie diegeerbte Schriftgröße des Elements.

ex

Entspricht derx-Höhe derfont des Elements. In Schriften mit dem Buchstabenx ist dies im Allgemeinen die Höhe der Kleinbuchstaben in der Schriftart;1ex ≈ 0.5em in vielen Schriften.

ic

Repräsentiert das verwendeteVorwärtsmaß des „水“-Glyphen (CJK-Wasserideogramm, U+6C34), das in der Schriftart gefunden wird, die es rendert.

lh

Entspricht dem berechneten Wert derline-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:

rcap

Entspricht der "Kapphöhe" (nominale Höhe von Großbuchstaben) derfont des Root-Elements.

rch

Entspricht der Breite oder demVorwärtsmaß des Glyphen0 (Null, das Unicode-Zeichen U+0030) in derfont des Root-Elements.

rem

Repräsentiert diefont-size des Root-Elements (typischerweise<html>). Wenn sie innerhalb derfont-size des Root-Elements verwendet wird, repräsentiert sie ihren Anfangswert. Ein gängiger Browser-Standardwert ist16px, aber benutzerdefinierte Einstellungen können dies ändern.

rex

Entspricht der x-Höhe derfont des Root-Elements.

ric

Entspricht dem Wert deric-Einheit in der Schriftart des Root-Elements.

rlh

Entspricht dem Wert derlh-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 dassv-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 daslv-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 dasdv-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.

vh

Repräsentiert einen Prozentsatz der Höhe des initialenUmfassungsblocks des Viewports.1vh ist 1% der Viewport-Höhe. Zum Beispiel, wenn die Viewport-Höhe300px beträgt, dann ist ein Wert von70vh auf einer Eigenschaft210px.

Die entsprechenden Viewport-Prozent-Einheiten für kleine, große und dynamische Viewport-Größen sindsvh,lvh unddvh.vh ist gleichwertig zulvh, repräsentiert die Viewport-Prozent-Längeneinheit basierend auf der großen Viewport-Größe.

vw

Repräsentiert einen Prozentsatz der Breite des initialenUmfassungsblocks des Viewports.1vw ist 1% der Viewport-Breite. Zum Beispiel, wenn die Viewport-Breite800px beträgt, dann ist ein Wert von50vw auf einer Eigenschaft400px.

Für kleine, große und dynamische Viewport-Größen sind die entsprechenden Viewport-Prozent-Einheitensvw,lvw unddvw.vw ist gleichwertig zulvw, repräsentiert die Viewport-Prozent-Längeneinheit basierend auf der großen Viewport-Größe.

vmax

Repräsentiert in Prozent die größere vonvw undvh.

Für kleine, große und dynamische Viewport-Größen sind die entsprechenden Viewport-Prozent-Einheitensvmax,lvmax unddvmax.vmax ist gleichwertig zulvmax, repräsentiert die Viewport-Prozent-Längeneinheit basierend auf der großen Viewport-Größe.

vmin

Repräsentiert in Prozent die kleinere vonvw undvh.

Für kleine, große und dynamische Viewport-Größen sind die entsprechenden Viewport-Prozent-Einheitensvmin,lvmin unddvmin.vmin ist gleichwertig zulvmin, repräsentiert die Viewport-Prozent-Längeneinheit basierend auf der großen Viewport-Größe.

vb

Reprä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-Einheitensvb,lvb unddvb, jeweils.vb ist gleichwertig zulvb, repräsentiert die Viewport-Prozent-Längeneinheit basierend auf der großen Viewport-Größe.

vi

Reprä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-Einheitensvi,lvi unddvi.vi ist 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.

cqw

Repräsentiert einen Prozentsatz der Breite des Abfrage-Containers.1cqw ist 1% der Breite des Abfrage-Containers. Zum Beispiel, wenn die Breite des Abfrage-Containers800px beträgt, dann ist ein Wert von50cqw auf einer Eigenschaft400px.

cqh

Repräsentiert einen Prozentsatz der Höhe des Abfrage-Containers.1cqh ist 1% der Höhe des Abfrage-Containers. Zum Beispiel, wenn die Höhe des Abfrage-Containers300px beträgt, dann ist ein Wert von10cqh auf einer Eigenschaft30px.

cqi

Repräsentiert einen Prozentsatz der Inline-Größe des Abfrage-Containers.1cqi ist 1% der Inline-Größe des Abfrage-Containers. Zum Beispiel, wenn die Inline-Größe des Abfrage-Containers800px beträgt, dann ist ein Wert von50cqi auf einer Eigenschaft400px.

cqb

Repräsentiert einen Prozentsatz der Block-Größe des Abfrage-Containers.1cqb ist 1% der Block-Größe des Abfrage-Containers. Zum Beispiel, wenn die Block-Größe des Abfrage-Containers300px beträgt, dann ist ein Wert von10cqb auf einer Eigenschaft30px.

cqmin

Repräsentiert einen Prozentsatz des kleineren Wertes entweder der Inline-Größe oder der Block-Größe des Abfrage-Containers.1cqmin ist 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-Containers800px beträgt und seine Block-Größe300px, dann ist ein Wert von50cqmin auf einer Eigenschaft150px.

cqmax

Repräsentiert einen Prozentsatz des größeren Wertes entweder der Inline-Größe oder der Block-Größe des Abfrage-Containers.1cqmax ist 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-Containers800px und seine Block-Größe300px beträgt, dann ist ein Wert von50cqmax auf 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.

px

Ein 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.

cm

Ein Zentimeter.1cm =96px / 2.54.

mm

Ein Millimeter.1mm =1cm / 10.

Q

Ein Viertel eines Millimeters.1Q =1cm / 40.

in

Ein Zoll.1in =2.54cm =96px.

pc

Eine Pica.1pc =12pt =1in / 6.

pt

Ein 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

html
<div>  <div>    <label for="length">Enter width:</label>    <input type="text" />  </div>  <div></div></div><div></div>

CSS

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

js
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

Browser-Kompatibilität

Siehe auch

Help improve MDN

Learn how to contribute Diese Seite wurde automatisch aus dem Englischen übersetzt.

[8]ページ先頭

©2009-2026 Movatter.jp