Hier erfahren Sie, wie die vorgeschlagene Portals API die Navigation verbessern kann.
Schneller Seitenaufbau ist entscheidend für eine gute Nutzererfahrung. Ein Bereich, den wir oft übersehen, sind jedoch Seitenübergänge – also das, was Nutzer sehen, wenn sie zwischen Seiten wechseln.
Ein neuer API-Vorschlag für Webplattformen namens Portals soll hier Abhilfe schaffen, indem die Navigation auf Ihrer Website optimiert wird.
Portale in Aktion:
Vorteile von Portalen
Single-Page-Anwendungen (SPAs) bieten schöne Übergänge, sind aber komplexer zu erstellen. Mehrseitige Anwendungen (MPAs) sind viel einfacher zu erstellen, aber zwischen den Seiten werden leere Bildschirme angezeigt.
Portale bieten das Beste aus beiden Welten: die geringe Komplexität einer MPA mit den nahtlosen Übergängen einer SPA.
Sie sind mit einem <iframe> vergleichbar, da sie eingebettet werden können. Im Gegensatz zu einem <iframe> bieten sie jedoch auch Funktionen, mit denen Sie zu ihren Inhalten navigieren können.
Überzeugen Sie sich selbst und sehen Sie sich an, was wir auf dem Chrome Dev Summit 2018 vorgestellt haben:
Bei der klassischen Navigation müssen Nutzer bei einem leeren Bildschirm warten, bis der Browser das Rendern des Ziels abgeschlossen hat.
Mit Portalen sehen Nutzer eine Animation, während die <portal> Inhalte vorab rendert und für eine nahtlose Navigation sorgt.
Vor der Einführung von Portals konnten wir eine andere Seite mit einem <iframe> rendern. Wir hätten auch Animationen hinzufügen können, um den Frame auf der Seite zu bewegen. Bei einem <iframe> ist es jedoch nicht möglich, zu den Inhalten zu navigieren. Portale schließen diese Lücke und ermöglichen interessante Anwendungsfälle.
Portale ausprobieren
Aktivierung über „about://flags“
Sie können Portale in Chrome 85 und höher ausprobieren, indem Sie ein experimentelles Flag aktivieren:
- Aktivieren Sie das Flag
about://flags/#enable-portalsfür Navigationen desselben Ursprungs. - Wenn Sie ursprungsübergreifende Navigationen testen möchten, aktivieren Sie zusätzlich das Flag
about://flags/#enable-portals-cross-origin.
In dieser frühen Phase des Portals-Experiments empfehlen wir außerdem, für Ihre Tests ein völlig separates Nutzerdatenverzeichnis zu verwenden. Legen Sie dazu das Befehlszeilen-Flag --user-data-dir fest.
Nachdem Portale aktiviert wurden, können Sie in den Entwicklertools prüfen, ob Sie das neue HTMLPortalElement haben.

Portale implementieren
Sehen wir uns ein einfaches Implementierungsbeispiel an.
// Create a portal with the wikipedia page, and embed it
// (like an iframe). You can also use the <portal> tag instead.
portal = document.createElement('portal');
portal.src = 'https://en.wikipedia.org/wiki/World_Wide_Web';
portal.style = '...';
document.body.appendChild(portal);
// When the user touches the preview (embedded portal):
// do fancy animation, e.g. expand …
// and finish by doing the actual transition.
// For the sake of simplicity, this snippet will navigate
// on the `onload` event of the Portals element.
portal.addEventListener('load', (evt) => {
portal.activate();
});
So einfach ist das. Probieren Sie diesen Code in der DevTools-Konsole aus. Die Wikipedia-Seite sollte sich öffnen.

Wenn Sie etwas wie das, was wir auf dem Chrome Dev Summit gezeigt haben, erstellen möchten, das genau wie die obige Demo funktioniert, ist das folgende Snippet für Sie interessant.
// Adding some styles with transitions
const style = document.createElement('style');
style.innerHTML = `
portal {
position:fixed;
width: 100%;
height: 100%;
opacity: 0;
box-shadow: 0 0 20px 10px #999;
transform: scale(0.4);
transform-origin: bottom left;
bottom: 20px;
left: 20px;
animation-name: fade-in;
animation-duration: 1s;
animation-delay: 2s;
animation-fill-mode: forwards;
}
.portal-transition {
transition: transform 0.4s;
}
@media (prefers-reduced-motion: reduce) {
.portal-transition {
transition: transform 0.001s;
}
}
.portal-reveal {
transform: scale(1.0) translateX(-20px) translateY(20px);
}
@keyframes fade-in {
0% { opacity: 0; }
100% { opacity: 1; }
}
`;
const portal = document.createElement('portal');
// Let's navigate into the WICG Portals spec page
portal.src = 'https://wicg.github.io/portals/';
// Add a class that defines the transition. Consider using
// `prefers-reduced-motion` media query to control the animation.
// https://developers.google.com/web/updates/2019/03/prefers-reduced-motion
portal.classList.add('portal-transition');
portal.addEventListener('click', (evt) => {
// Animate the portal once user interacts
portal.classList.add('portal-reveal');
});
portal.addEventListener('transitionend', (evt) => {
if (evt.propertyName == 'transform') {
// Activate the portal once the transition has completed
portal.activate();
}
});
document.body.append(style, portal);
Außerdem ist es einfach, eine Funktionserkennung durchzuführen, um eine Website mithilfe von Portalen schrittweise zu verbessern.
if ('HTMLPortalElement' in window) {
// If this is a platform that have Portals...
const portal = document.createElement('portal');
...
}
Die folgende Demo zeigt, wie sich Portale anfühlen:
- Geben Sie eine URL ein, die Sie als Vorschau ansehen möchten.
- Die Seite wird dann als
<portal>-Element eingebettet. - Klicken Sie auf die Vorschau.
- Die Vorschau wird nach einer Animation aktiviert.

Spezifikation ansehen
Wir diskutieren die Portals-Spezifikation aktiv in der Web Incubation Community Group (WICG). Sehen Sie sich einige der wichtigsten Szenarien an, um sich schnell einen Überblick zu verschaffen. Diese drei wichtigen Funktionen solltest du kennen:
- Das
<portal>-Element: Das HTML-Element selbst. Die API ist sehr einfach. Es besteht aus dem Attributsrc, der Funktionactivateund einer Schnittstelle für Nachrichten (postMessage).activateverwendet ein optionales Argument, um bei der Aktivierung Daten an<portal>zu übergeben. - Die
portalHost-Schnittstelle: Fügt demwindow-Objekt einportalHost-Objekt hinzu. So können Sie prüfen, ob die Seite als<portal>-Element eingebettet ist. Außerdem bietet sie eine Schnittstelle für Nachrichten (postMessage) zurück an den Host. - Die PortalActivateEvent-Schnittstelle: Ein Ereignis, das ausgelöst wird, wenn das
<portal>aktiviert wird. Es gibt eine praktische Funktion namensadoptPredecessor, mit der Sie die vorherige Seite als<portal>-Element abrufen können. So können Sie nahtlose Navigationen und zusammengesetzte Erlebnisse zwischen zwei Seiten erstellen.
Sehen wir uns nun ein komplexeres Nutzungsmuster an. Hier ist eine unvollständige Liste der Möglichkeiten, die Portale bieten, zusammen mit Beispielcode.
Stil anpassen, wenn als <portal>-Element eingebettet
// Detect whether this page is hosted in a portal
if (window.portalHost) {
// Customize the UI when being embedded as a portal
}
Nachrichten zwischen dem <portal>-Element und portalHost
// Send message to the portal element
const portal = document.querySelector('portal');
portal.postMessage({someKey: someValue}, ORIGIN);
// Receive message via window.portalHost
window.portalHost.addEventListener('message', (evt) => {
const data = evt.data.someKey;
// handle the event
});
Aktivieren des <portal>-Elements und Empfangen des portalactivate-Ereignisses
// You can optionally add data to the argument of the activate function
portal.activate({data: {somekey: 'somevalue'}});
// The portal content will receive the portalactivate event
// when the activate happens
window.addEventListener('portalactivate', (evt) => {
// Data available as evt.data
const data = evt.data;
});
Vorgänger abrufen
// Listen to the portalactivate event
window.addEventListener('portalactivate', (evt) => {
// ... and creatively use the predecessor
const portal = evt.adoptPredecessor();
document.querySelector('someElm').appendChild(portal);
});
Wissen, dass Ihre Seite als Vorgänger übernommen wurde
// The activate function returns a Promise.
// When the promise resolves, it means that the portal has been activated.
// If this document was adopted by it, then window.portalHost will exist.
portal.activate().then(() => {
// Check if this document was adopted into a portal element.
if (window.portalHost) {
// You can start communicating with the portal element
// i.e. listen to messages
window.portalHost.addEventListener('message', (evt) => {
// handle the event
});
}
});
Durch die Kombination aller von Portalen unterstützten Funktionen können Sie wirklich ausgefallene Nutzererfahrungen erstellen. In der Demo unten wird beispielsweise gezeigt, wie Portale eine nahtlose Nutzererfahrung zwischen einer Website und eingebetteten Inhalten von Drittanbietern ermöglichen können.
Anwendungsfälle und Abos
Wir hoffen, dass Ihnen diese kurze Einführung in Portale gefallen hat. Wir sind gespannt, was Sie sich einfallen lassen. Sie können Portale beispielsweise für nicht triviale Navigationen verwenden, z. B. für das Vorab-Rendering der Seite für Ihr meistverkauftes Produkt von einer Produktkategorie-Listenseite.
Ein weiterer wichtiger Punkt ist, dass Portale wie ein <iframe> für die ursprungsübergreifende Navigation verwendet werden können. Wenn Sie also mehrere Websites haben, die aufeinander verweisen, können Sie mit Portalen auch eine nahtlose Navigation zwischen zwei verschiedenen Websites erstellen. Dieser ursprungsübergreifende Anwendungsfall ist einzigartig für Portale und kann sogar die Nutzerfreundlichkeit von SPAs verbessern.
Wir freuen uns über euer Feedback!
Portale können in Chrome 85 und höher getestet werden. Das Feedback der Community ist für die Entwicklung neuer APIs von entscheidender Bedeutung. Probieren Sie sie also aus und teilen Sie uns Ihre Meinung mit. Wenn Sie Feature Requests oder Feedback haben, rufen Sie das WICG-GitHub-Repository auf.