clamp() CSS-Funktion

Probieren Sie es aus

font-size: clamp(1rem, 2.5vw, 2rem);

font-size: clamp(1.5rem, 2.5vw, 4rem);

font-size: clamp(1rem, 10vw, 2rem);

<section class="default-example" id="default-example">
  <div class="transition-all" id="example-element">
    The font-size of this text varies depending on the base font of the page,
    and the size of the viewport.
  </div>
</section>

Beachten Sie, dass die Verwendung von clamp() für Schriftgrößen, wie in diesen Beispielen gezeigt, es Ihnen ermöglicht, eine Schriftgröße festzulegen, die mit der Größe des Ansichtsfensters wächst, aber nicht unter eine Mindestschriftgröße oder über eine Maximalschriftgröße hinausgeht. Es hat den gleichen Effekt wie der Code in Fluid Typography, aber in einer Zeile und ohne die Verwendung von Media Queries.

Syntax

/* Static values */
width: clamp(200px, 40%, 400px);
width: clamp(20rem, 30vw, 70rem);
width: clamp(10vw, 20em, 100vw);

/* Calculated values */
width: clamp(min(10vw, 20rem), 300px, max(90vw, 55rem));
width: clamp(100px, calc(30% / 2rem + 10px), 900px);

Parameter

Die Funktion clamp(min, val, max) akzeptiert drei durch Kommas getrennte Ausdrücke als Parameter.

min

Der Mindestwert ist der kleinste (am negativsten) Wert. Dies ist die untere Grenze im Bereich der zulässigen Werte. Wenn der bevorzugte Wert kleiner als dieser Wert ist, wird der Mindestwert verwendet.

val

Der bevorzugte Wert ist der Ausdruck, dessen Wert verwendet wird, solange das Ergebnis zwischen den Mindest- und Höchstwerten liegt.

max

Der Höchstwert ist der größte (am positivsten) Ausdruckswert, dem der Wert der Eigenschaft zugewiesen wird, wenn der bevorzugte Wert größer als diese obere Grenze ist.

Die Ausdrücke können mathematische Funktionen sein (siehe calc() für weitere Informationen), literale Werte, andere Ausdrücke, die sich zu einem gültigen Argumenttyp auswerten (wie <length>), oder verschachtelte min() und max() Funktionen. Für mathematische Ausdrücke können Sie Addition, Subtraktion, Multiplikation und Division ohne die Verwendung der Funktion calc() selbst verwenden. Sie können auch Klammern verwenden, um die Reihenfolge der Berechnungen festzulegen, wenn nötig.

Sie können für jeden Wert in Ihren Ausdrücken unterschiedliche Einheiten verwenden und unterschiedliche Einheiten in jeder mathematischen Funktion, die ein Argument bildet.

Beachten Sie die folgenden Aspekte bei der Arbeit mit der Funktion:

• Mathematische Ausdrücke, die Prozentsätze für Breiten und Höhen bei Tabellenspalten, Tabellenspalten-Gruppen, Tabellenzeilen, Tabellenzeilengruppen und Tabellenzellen in sowohl automatisierten als auch festen Layout-Tabellen beinhalten, können so behandelt werden, als ob auto angegeben worden wäre.
• Es ist erlaubt, max() und min() Funktionen als Ausdruckswerte zu verschachteln, wobei die inneren als grundlegende Klammern behandelt werden. Die Ausdrücke sind vollständige mathematische Ausdrücke, sodass Sie direkte Addition, Subtraktion, Multiplikation und Division ohne die Verwendung der Funktion calc() selbst verwenden können.
• Der Ausdruck kann Werte kombinieren, die die Operatoren Addition (+), Subtraktion (-), Multiplikation (*) und Division (/) unter Verwendung der standardmäßigen Operatorrangfolgeregeln nutzen. Stellen Sie sicher, dass auf jeder Seite der + und - Operanden ein Leerzeichen vorhanden ist. Sie können unterschiedliche Einheiten für jeden Wert in Ihrem Ausdruck verwenden. Sie können auch Klammern verwenden, um die Reihenfolge der Berechnungen festzulegen, wenn nötig.
• Oftmals möchten Sie min() und max() innerhalb einer clamp()-Funktion verwenden.

Rückgabewert

clamp(MIN, VAL, MAX) wird als max(MIN, min(VAL, MAX)) aufgelöst.

Basierend auf den angegebenen Parametern gibt die Funktion <length>, <frequency>, <angle>, <time>, <percentage>, <number>, oder <integer> zurück.

Formale Syntax

<clamp()> = 
  clamp( [ <calc-sum> | none ] , <calc-sum> , [ <calc-sum> | none ] )  

<calc-sum> = 
  <calc-product> [ [ '+' | '-' ] <calc-product> ]*  

<calc-product> = 
  <calc-value> [ [ '*' | / ] <calc-value> ]*  

<calc-value> = 
  <number>        |
  <dimension>     |
  <percentage>    |
  <calc-keyword>  |
  ( <calc-sum> )  

<calc-keyword> = 
  e          |
  pi         |
  infinity   |
  -infinity  |
  NaN        

Beispiele

Vergleich von min(), max() und clamp()

In diesem Beispiel haben wir eine Webseite, die min(), max() und clamp() verwendet, um Größen reaktionsfreundlich einzustellen.

Das Beispiel passt die Größen der Seitenelemente auf drei Arten an:

• die Längen der Textzeilen
• die Schriftgröße des Absatztextes
• die Schriftgröße des Überschriftstextes

In allen drei Fällen verwendet die Seite eine Kombination aus ansichtsfensterrelativen Einheiten (vw und <percentage>), um eine Größe festzulegen, die mit der Ansichtsfensterbreite variiert, und einem Wert, der nicht ansichtsfensterrelativ ist (rem und px), um Mindest- und/oder Höchstgrößen zu implementieren.

Das Beispiel befindet sich unter https://mdn.github.io/css-examples/min-max-clamp/. Öffnen Sie es in einem neuen Fenster und versuchen Sie, die Fensterbreite anzupassen.

Die Zeilenlänge (gesteuert durch die width des <body>-Elements) erhöht sich, wenn die Fensterbreite zunimmt, aber nur bis zu einem bestimmten Punkt (1000px), und darüber hinaus wird sie nicht weiter zunehmen. Wir verwenden min(), um eine maximale Zeilenlänge festzulegen: sie kann unter 1000px gehen, aber nicht darüber. Dies ist hilfreich, weil lange Zeilen schwieriger zu lesen sind, daher möchten wir oft begrenzen, wie lang eine Zeile sein kann. Um dies zu erreichen, verwenden wir min(1000px, calc(70% + 100px)): wenn das Ergebnis der prozentsatzbasierten Berechnung über 1000px geht, wechseln wir zum festen Wert von 1000px.

Die Größe des Absatztextes, die durch die font-size des <p>-Elements gesteuert wird, nimmt ab, wenn das Fenster schmaler wird, aber nur bis zu einem bestimmten Punkt, und darüber hinaus (der Punkt, an dem 1.2vw weniger als 1.2rem ist) wird sie nicht kleiner: Sie bleibt bei 1.2rem. Wir verwenden max(), um eine Mindestschriftgröße festzulegen: die Schrift kann über 1.2rem hinaus wachsen, aber nie darunter. Dies ist hilfreich, weil wirklich kleiner Text schwer zu lesen ist. Um dies zu erreichen, verwenden wir max(1.2rem, 1.2vw). Das bedeutet, dass die font-size auf 1.2rem eingestellt wird, es sei denn, der berechnete Wert von 1.2vw ist größer als der von 1.2rem, in diesem Fall wird er stattdessen auf 1.2vw eingestellt.

Die Größe des Überschriftstextes, gesteuert durch die font-size des <h1>-Elements, hat einen ansichtsfensterrelativen Wert mit sowohl einer maximalen als auch einer minimalen Schwelle. Um dies zu erreichen, verwenden wir clamp(1.8rem, 2.5vw, 2.8rem). Der ansichtsfensterrelative Wert ist 2.5vw, aber er wird zwischen 1.8rem und 2.8rem begrenzt, sodass:

• wenn der berechnete Wert von 2.5vw kleiner als 1.8rem ist, wird 1.8rem verwendet
• wenn der berechnete Wert von 2.5vw größer als 2.8rem ist, wird 2.8rem verwendet.

Dies verhindert, dass der Überschriftstext in einem sehr schmalen Fenster zu klein oder in einem sehr breiten Fenster zu groß wird.

HTML

<h1>Basic responsive test</h1>
<p>
  Lorem ipsum dolor sit amet, consectetur adipiscing elit. In orci orci,
  eleifend id risus nec, mattis rutrum velit. Suspendisse fringilla egestas erat
  eu convallis. Phasellus eu velit ut magna dapibus elementum cursus at ligula.
  Ut tempus varius nibh, nec auctor sapien iaculis sit amet. Fusce iaculis,
  libero quis elementum viverra, nulla ante accumsan lectus, sit amet convallis
  lacus ipsum vel est. Curabitur et urna non est consectetur pulvinar vel id
  risus. Ut vestibulum, sem in semper aliquet, felis arcu euismod sapien, ac
  imperdiet massa nisl quis sem. Vestibulum ac elementum felis, in tempor velit.
  Pellentesque purus ex, mattis at ornare quis, porta condimentum mi. Donec
  vestibulum ligula vel nulla blandit, quis euismod nulla vestibulum.
  Suspendisse potenti. Nunc neque mauris, tempor sed facilisis at, ultrices eget
  nulla. Pellentesque convallis ante nec augue porttitor, id tempus ante luctus.
</p>

<p>
  Integer rutrum sollicitudin tellus, quis cursus nulla scelerisque nec. Nunc eu
  facilisis lorem. Maecenas faucibus sapien eleifend, semper tellus at, pharetra
  quam. Cras feugiat vulputate tortor at rhoncus. Class aptent taciti sociosqu
  ad litora torquent per conubia nostra, per inceptos himenaeos. Nam non felis
  quis sem lobortis sodales vel id libero. Phasellus sit amet placerat lorem.
</p>

CSS

html {
  font-family: sans-serif;
}

body {
  margin: 0 auto;
  width: min(1000px, calc(70% + 100px));
}

h1 {
  letter-spacing: 2px;
  font-size: clamp(1.8rem, 2.5vw, 2.8rem);
}

p {
  line-height: 1.5;
  font-size: max(1.2rem, 1.2vw);
}

Barrierefreiheit

Wenn clamp() zur Steuerung der Schriftgröße verwendet wird, stellen Sie sicher, dass der maximal zulässige Wert eine relative Längeneinheit ist, die nicht weniger als das Doppelte des minimal zulässigen Werts beträgt, zum Beispiel:

font-size: clamp(1rem, 2.5vw, 2rem);

Dies hilft sicherzustellen, dass die Schriftgröße auf mindestens 200% skaliert werden kann, wenn die Seite gezoomt wird.

• MDN Verständnis von WCAG, Richtlinie 1.4 Erklärungen
• Verstehen des Erfolgskriteriums 1.4.4: Textgröße anpassen | WAI | W3C

Spezifikationen

Browser-Kompatibilität

Siehe auch

• calc()
• max()
• min()
• Lernen: CSS Werte und Einheiten