Dieser Artikel erklärt das Konzept desViewport — was es ist und seine Auswirkungen im Hinblick auf CSS, SVG und mobile Geräte. Dieser Artikel definiert den initialen Viewport und den tatsächlichen Viewport und unterscheidet zwischen demvisuellen Viewport und demLayout-Viewport.

Was ist ein Viewport?

EinViewport ist eine Funktion des Benutzeragenten, die verwendet wird, um den anfänglichen enthaltenden Block für kontinuierliche Medien zu bestimmen.

Der generische BegriffViewport bezieht sich im Allgemeinen auf den Bereich in der Computergrafik, der gerade betrachtet wird. Im Zusammenhang mit Webbrowsern entspricht dies im Allgemeinen dem Browserfenster, ausgenommen der Benutzeroberfläche, der Menüleiste usw. Das ist der Teil des Dokuments, den Sie gerade betrachten.

Während ein Dokument lädt, durchläuft der Viewport zwei Phasen:

Initialer Viewport

Derinitiale Viewport bezieht sich auf das Fenster oder den Anzeigebereich des Benutzeragenten, bevor Benutzeragent-Stile, HTML-<meta>-Tags oder CSS-Stile dessen Größe überschrieben haben. Die Größe des initialen Viewports basiert auf der Größe des Fensters oder Anzeigebereichs und nicht auf dem Inhalt. Die Größe des initialen Viewports eines Vollbild-Benutzeragenten variiert je nach Orientierung und Gerät, bleibt aber immer gleich bei demselben Gerät in derselben Orientierung.

Tatsächlicher Viewport

Dertatsächliche Viewport ist der Viewport, den Sie nach der Verarbeitung desViewport-<meta>-Tags erhalten. Inhalt, der für große Viewports entworfen wurde, kann eine Vielzahl von Fehlern zeigen, wenn er in kleineren Viewports angezeigt wird, einschließlich unbeabsichtigtes Umbruchverhalten, abgeschnittener Inhalt und falsch dimensionierteScroll-Container. Das Viewport-Meta-Tag bietet Hinweise zur anfänglichen Größe des Viewports. Der tatsächliche Viewport ist die durch seincontent-Attribut definierte Größe. Wenn dieses Tag weggelassen wird, rendern einige mobile Browser den Inhalt mit einer festen Breite des anfänglichen enthaltenden Blocks, typischerweise980px. Sie setzen die Breite des tatsächlichen Viewports auf diesen Wert und skalieren dann den Inhalt, um ihn anzupassen, was die CSS-Pixelgröße kleiner macht als ein tatsächliches Pixel.

Dokumente wie dieser Artikel können sehr lang sein. Ihr Viewport ist alles, was gerade sichtbar ist; insbesondere der Abschnitt "Was ist ein Viewport" und vielleicht ein Teil des Navigationsmenüs. Die Größe des Viewports hängt von der Größe des Bildschirms ab, davon, ob der Browser im Vollbildmodus ist oder nicht, und davon, ob der Browser vergrößert ist oder nicht. Inhalte außerhalb des Viewports, wie der AbschnittSiehe auch in diesem Dokument, sind wahrscheinlich nicht sichtbar, bis sie durch Scrollen in das Sichtfeld gebracht werden.

• Auf größeren Monitoren, bei denen Anwendungen nicht unbedingt im Vollbildmodus sind, ist der Viewport die Größe des Browserfensters.
• Auf den meisten mobilen Geräten und wenn der Browser im Vollbildmodus ist, ist der Viewport der ganze Bildschirm.
• Im Vollbildmodus ist der Viewport der Geräteschirm, das Fenster ist das Browserfenster, das so groß wie der Viewport oder kleiner sein kann, und das Dokument ist die Website, die viel höher oder breiter als der Viewport sein kann.

Fürseitenumbruchfähige Medien basiert der anfängliche enthaltende Block auf dem Seitenbereich. Der Seitenbereich kann durch@page-Regeln festgelegt werden.

Zusammengefasst ist der Viewport im Grunde der Teil des Dokuments, der derzeit sichtbar ist.

Viewport-Größen sind veränderbar

Die Breite des Viewports ist nicht immer die Breite des Fensters. Wenn Sie in Chrome oder Firefox die Breite oder Höhe des Fensters und Dokuments abfragen, erhalten Sie möglicherweise:

document.documentElement.clientWidth; /* 1200 */window.innerWidth; /* 1200 */window.outerWidth; /* 1200 */

document.documentElement.clientHeight; /* 800 */window.innerHeight; /* 800 */window.outerHeight; /* 900 */

Es gibt verschiedene DOM-Eigenschaften, die Ihnen helfen können, die Viewport-Größe und andere ähnliche Längen abzufragen:

• DieElement.clientWidth des Dokumentelements ist die innere Breite eines Dokuments inCSS-Pixeln, einschließlich Padding (jedoch ohne Ränder, Abstände oder vertikale Scrollleisten, falls vorhanden).Dies ist die Viewport-Breite.
• DieWindow.innerWidth ist die Breite, in CSS-Pixeln, des Browserfenster-Viewports einschließlich, falls gerendert, der vertikalen Scrollleiste.
• DieWindow.outerWidth ist die Breite des äußeren Teils des Browserfensters, einschließlich aller Fenster-Chrom.

In einem Experiment mit diesen wareninnerWidth undouterWidth gleich, aberouterHeight war 100px größer alsinnerHeight. Dies liegt daran, dassouterHeight das Browserchrom enthält: Die Messungen wurden in einem Browser mit einer Adressleiste und einer Lesezeichenleiste aufgenommen, die zusammen 100px hoch waren, aber kein Chrom auf der linken oder rechten Seite des Fensters hatten.

Der Bereich innerhalb derinnerHeight undinnerWidth wird im Allgemeinen alsLayout-Viewport betrachtet. Das Browserchrom wird nicht als Teil des Viewports betrachtet.

Bei Vergrößerung melden sowohl Firefox als auch Chrome die neueCSS-Pixel-Größe fürinnerWidth undclientWidth. Die fürouterWidth undouterHeight zurückgegebenen Werte hängen vom Browser ab: Firefox meldet den neuen Wert in CSS-Pixeln, aber Chrome gibt die Länge in der Standard-Pixelgröße zurück. Bei Vergrößerung können Sie erhalten:

document.documentElement.clientWidth; /* 800 */window.innerWidth; /* 800 */window.outerWidth; /* 800 in Firefox, 1200 in chrome */

document.documentElement.clientHeight; /* 533 */window.innerHeight; /* 533 */window.outerHeight; /* 596 in Firefox, 900 in chrome */

Der Viewport war ursprünglich 1200 x 800 Pixel. Bei Vergrößerung wurde der Viewport auf 800 x 533 Pixel geändert. Dies ist derLayout-Viewport. Sticky-Header oder -Footer mit den folgenden Stilen haften entsprechend am oberen und unteren Rand desLayout-Viewports.

body > header {  position: fixed;  top: 0;}body > footer {  position: fixed;  bottom: 0;}

Wir erhielten die 800 x 533 Messwerte, als wir mit der Tastatur vergrößerten. Der Header und Footer blieben bündig mit der Ober- und Unterkante des Fensters. Aber was, wenn wir auf einem Tablet gekniffen und gezoomt hätten? Was passiert, wenn auf einem Telefon eine dynamische Tastatur geöffnet wird?

Layout- und visuelle Viewports

Das Web enthält zwei Viewports, denLayout-Viewport und denvisuellen Viewport. Der visuelle Viewport ist der Teil der Webseite, der derzeit im Browser sichtbar ist und sich ändern kann. Wenn der Benutzer die Seite mit einem Kneifzoom vergrößert, eine dynamische Tastatur öffnet oder wenn eine zuvor verborgene Adressleiste sichtbar wird, schrumpft der visuelle Viewport, aber der Layout-Viewport bleibt unverändert.

Fixierte Sticky-Header oder -Footer bleiben, wie oben diskutiert, am oberen und unteren Rand desLayout-Viewports haften und bleiben daher im Blick, wenn wir mit der Tastatur vergrößern. Wenn Sie mit einem Kneifzoom vergrößern, ist der Layout-Viewport möglicherweise nicht vollständig sichtbar. Wenn Sie aus der Mitte des Layout-Viewports vergrößern, wird der Inhalt in alle vier Richtungen erweitert. Wenn Sie einen Sticky-Header oder -Footer haben, bleiben diese am oberen oder unteren Rand des Layout-Viewports haften, sind jedoch möglicherweise nicht am oberen und unteren Rand des Geräteschirms sichtbar — was der visuelle Viewport ist. Der visuelle Viewport ist der derzeit sichtbare Teil des Layout-Viewports. Wenn Sie nach unten scrollen, ändern Sie den Inhalt des visuellen Viewports und bringen den unteren Rand des Layout-Viewports ins Sichtfeld, wobei der Sticky-Footer angezeigt wird, der dann am unteren Rand haften bleibt.

Der visuelle Viewport ist der sichtbare Teil eines Bildschirms, der On-Screen-Tastaturen, Bereiche außerhalb eines Kneifzoombereichs oder andere Funktionen, die sich nicht mit den Seitendimensionen skalieren, nicht einschließt. Der visuelle Viewport ist genauso groß wie der Layout-Viewport oder kleiner.

Für eine Seite, die Frames, Objekte oder externe SVG enthält, haben sowohl die enthaltenden Seiten als auch jede inkludierte Datei ihr eigenes einzigartiges Fensterobjekt. Nur das Top-Level-Fenster hat einen visuellen Viewport, der sich möglicherweise vom Layout-Viewport unterscheidet. Für inkludierte Dokumente sind der visuelle Viewport und der Layout-Viewport identisch.

CSS

Der oben beschriebene Layout-Viewport und der visuelle Viewport sind nicht die einzigen Viewports, denen Sie begegnen werden. Jeder Unter-Viewport, der vollständig oder teilweise im Layout-Viewport angezeigt wird, wird als visueller Viewport betrachtet.

Wir denken im Allgemeinen, dasswidth- undheight-Medienabfragen relativ zur Breite und Höhe des Browserfensters sind. Tatsächlich sind sie relativ zum Viewport, der das Fenster im Hauptdokument ist, jedoch die intrinsische Größe des Elternelements in einem verschachtelten Browsing-Kontext wie Objekte, Frames und SVG. In CSS haben wir auchLängeneinheiten basierend auf der Viewport-Größe. Einevh-Einheit ist 1% der Höhe des Layout-Viewports. Ebenso ist dievw-Einheit 1% der Breite des Layout-Viewports.

<iframe>

Innerhalb eines<iframe> ist der visuelle Viewport die Größe der inneren Breite und Höhe des Iframes, anstatt des übergeordneten Dokuments. Sie können in einem Iframe jede Höhe und Breite festlegen, aber das gesamte Dokument ist möglicherweise nicht sichtbar.

Wenn SieViewport-Längeneinheiten in Ihrem CSS innerhalb des Iframe-Dokuments verwenden, beträgt1vh 1% der Höhe des Iframes und1vw 1% der Breite des Dokuments.

iframe {  width: 50vw;}

Wenn der Iframe auf 50vw gesetzt ist, beträgt er 50% der Breite des1200px übergeordneten Dokuments in unserem obigen Beispiel, also600px, wobei1vw6px entspricht. Bei Vergrößerung schrumpft der Iframe auf400px und1vw wird4px.

Eine Breiten-basierte Medienabfrage innerhalb des Iframe-Dokuments bezieht sich auf den Viewport des Iframes.

@media screen and (width >= 500px) {  p {    color: red;  }}

Wenn das obige CSS im Iframe enthalten ist, werden die Absätze rot, wenn der Benutzer vergrößert hat, aber dieser Stil gilt nicht im ungezoomten Zustand.

SVG

In einemSVG-Dokument ist der Viewport der sichtbare Bereich des SVG-Bildes. Sie können in einem<svg> jede Höhe und Breite festlegen, aber das gesamte Bild ist möglicherweise nicht sichtbar. Der sichtbare Bereich wird als Viewport bezeichnet. Die Größe des Viewports kann mit den Breiten- und Höhenattributen des<svg>-Elements definiert werden.

<svg height="300" width="400"></svg>

In diesem Beispiel hat der Viewport einSeitenverhältnis von 3:4 und ist standardmäßig 400 x 300 Einheiten groß, wobei eine Einheit im Allgemeinen einem CSS-Pixel entspricht.

SVG hat auch ein internesKoordinatensystem, das über dasviewBox-Attribut definiert ist, was mit dieser Diskussion über den Viewport nicht zusammenhängt.

Wenn Sie eine SVG-Datei in Ihr HTML einfügen, ist der Viewport der SVG der anfängliche enthaltende Block oder die Breite und Höhe des SVG-Containers. Die Verwendung der@media-Abfrage in Ihrem SVG-CSS bezieht sich auf diesen Container, nicht auf den Browser.

@media screen and (400px <= width <= 500px) {  /* CSS goes here */}

Im Allgemeinen werden die Stile angewendet, wenn der obige Medienabfrage der Ansicht entspricht, dass der Viewport, normalerweise das Browserfenster, zwischen 400px und 500px, einschließlich, liegt. Die Breitenmedienabfrage im SVG basiert auf dem Element, in dem das SVG enthalten ist — dem<img>, wenn die Quelle eine SVG-Datei ist, das SVG selbst, wenn das SVG direkt in das HTML eingebettet ist, oder dem Elternteil, wenn das übergeordnete Element eine Breite zugewiesen hat, und nicht auf der Breite des Viewports. Da die obige Medienabfrage in unserer SVG-Datei ist, wird das CSS angewendet, wenn der SVG-Container zwischen 400px und 500px liegt.

JavaScript

DieVisualViewport-Schnittstelle bietet einen Mechanismus zum Abfragen und Ändern der Eigenschaften des visuellen Viewports.

DieViewport-Schnittstelle bietet einen Mechanismus zum Abfragen und Ändern der Eigenschaften des visuellen Viewports.

Mobile Viewports

Mobile Geräte gibt es in allen Formen und Größen, mit Bildschirmen unterschiedlicherGeräte-Pixel-Verhältnisse. Der Viewport des mobilen Browsers ist der Bereich des Fensters, in dem Webinhalt gesehen werden kann, was nicht unbedingt die gleiche Größe wie die gerenderte Seite hat. Mobile Browser rendern Seiten in einem virtuellen Fenster oder Viewport, normalerweise bei 980px, das normalerweise breiter ist als der Bildschirm, und verkleinern dann das gerenderte Ergebnis, damit es auf einmal gesehen werden kann. Benutzer können dann schwenken und zoomen, um verschiedene Bereiche der Seite zu sehen. Zum Beispiel, wenn ein mobiler Bildschirm eine Breite von 320px hat, könnte eine Website mit einem virtuellen Viewport von 980px gerendert werden, und dann wird sie verkleinert, um in den 320px-Raum zu passen, was je nach Design für viele, wenn nicht alle, unleserlich ist. Um dem mobilen Browser mitzuteilen, die Viewport-Breite anstelle der Standard-980px-Breite des Bildschirms zu verwenden, können Entwickler ein Viewport-Meta-Tag einfügen, wie das folgende:

<meta name="viewport" content="width=device-width" />

Diewidth-Eigenschaft steuert die Größe des Viewports. Sie sollte vorzugsweise aufdevice-width gesetzt werden, was die Breite des Bildschirms in CSS-Pixeln bei einer Skalierung von 100% ist. Es gibt andere Eigenschaften, einschließlichmaximum-scale,minimum-scale unduser-scalable, die steuern, ob Benutzer die Seite ein- oder auszoomen können, aber die Standardwerte sind die besten für Barrierefreiheit und Benutzererfahrung, daher können diese weggelassen werden.

Siehe auch

• CSSOM-Ansicht Modul
• CSSOM-Ansicht-API
• <meta>, speziell<meta name="viewport">
• CSS-Viewport Modul
• CSSOM-Ansicht Modul