Tìm hiểu cách Portals API được đề xuất có thể cải thiện trải nghiệm người dùng khi điều hướng.
Đảm bảo trang tải nhanh là yếu tố then chốt để mang lại trải nghiệm tốt cho người dùng. Nhưng có một khía cạnh mà chúng ta thường bỏ qua là hiệu ứng chuyển đổi trang – những gì người dùng nhìn thấy khi họ di chuyển giữa các trang.
Một đề xuất API nền tảng web mới có tên là Portals (Cổng thông tin) nhằm mục đích giúp giải quyết vấn đề này bằng cách đơn giản hoá trải nghiệm khi người dùng di chuyển trên trang web của bạn.
Xem cách hoạt động của Cổng:
Lợi ích của Cổng thông tin
Ứng dụng trang đơn (SPA) mang lại hiệu ứng chuyển đổi đẹp mắt nhưng lại có độ phức tạp cao hơn khi xây dựng. Ứng dụng nhiều trang (MPA) dễ xây dựng hơn nhiều, nhưng bạn sẽ thấy màn hình trống giữa các trang.
Cổng thông tin mang lại lợi ích tốt nhất cho cả hai:
độ phức tạp thấp của MPA với các hiệu ứng chuyển đổi liền mạch của SPA.
Hãy coi các thành phần này như một <iframe> vì chúng cho phép nhúng, nhưng không giống như <iframe>, các thành phần này cũng có các tính năng để điều hướng đến nội dung của chúng.
Trăm nghe không bằng một thấy: trước tiên, hãy xem những gì chúng tôi đã giới thiệu tại Hội nghị Nhà phát triển Chrome năm 2018:
Với thao tác điều hướng thông thường, người dùng phải đợi với màn hình trống cho đến khi trình duyệt kết xuất xong đích đến.
Với Cổng, người dùng có thể trải nghiệm ảnh động,
trong khi <portal> kết xuất trước nội dung và tạo ra trải nghiệm điều hướng liền mạch.
Trước khi có Portals, chúng ta có thể kết xuất một trang khác bằng <iframe>. Chúng ta cũng có thể thêm ảnh động để di chuyển khung hình xung quanh trang. Nhưng <iframe> sẽ không cho phép bạn di chuyển vào nội dung của nó. Cổng thông tin thu hẹp khoảng cách này, cho phép các trường hợp sử dụng thú vị.
Dùng thử Cổng thông tin
Bật thông qua about://flags
Hãy dùng thử Cổng trong Chrome 85 trở lên bằng cách bật cờ thử nghiệm:
- Bật cờ
about://flags/#enable-portalscho các thao tác điều hướng cùng nguồn gốc. - Để thử nghiệm tính năng điều hướng khác nguồn gốc, hãy bật thêm cờ
about://flags/#enable-portals-cross-origin.
Trong giai đoạn đầu của thử nghiệm Cổng,
chúng tôi cũng khuyên bạn nên sử dụng một thư mục dữ liệu người dùng hoàn toàn riêng biệt cho các thử nghiệm của mình
bằng cách đặt
cờ hiệu dòng lệnh --user-data-dir.
Sau khi bật Cổng, hãy xác nhận trong Công cụ cho nhà phát triển rằng bạn có HTMLPortalElement mới.

Triển khai cổng thông tin
Hãy cùng xem qua một ví dụ về cách triển khai cơ bản.
// 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();
});
Thật đơn giản. Hãy thử mã này trong bảng điều khiển Công cụ cho nhà phát triển, trang Wikipedia sẽ mở ra.

Nếu bạn muốn tạo một ứng dụng như chúng tôi đã giới thiệu tại Hội nghị Nhà phát triển Chrome và hoạt động giống như bản minh hoạ ở trên, thì đoạn mã sau đây sẽ giúp ích cho bạn.
// 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);
Bạn cũng có thể dễ dàng phát hiện tính năng để cải tiến tăng dần trang web bằng Cổng.
if ('HTMLPortalElement' in window) {
// If this is a platform that have Portals...
const portal = document.createElement('portal');
...
}
Nếu bạn muốn nhanh chóng trải nghiệm cảm giác của Cổng, hãy thử sử dụng uskay-portals-demo.glitch.me. Hãy nhớ truy cập bằng Chrome 85 trở lên và bật cờ thử nghiệm!
- Nhập URL mà bạn muốn xem trước.
- Sau đó, trang này sẽ được nhúng dưới dạng phần tử
<portal>. - Nhấp vào bản xem trước.
- Bản xem trước sẽ được kích hoạt sau một ảnh động.

Xem thông số kỹ thuật
Chúng tôi đang tích cực thảo luận về thông số kỹ thuật của Cổng trong Nhóm cộng đồng ươm tạo web (WICG). Để nhanh chóng nắm bắt, hãy xem một số tình huống chính. Sau đây là ba tính năng quan trọng mà bạn cần làm quen:
- Phần tử
<portal>: Bản thân phần tử HTML. API này rất đơn giản. API này bao gồm thuộc tínhsrc, hàmactivatevà một giao diện để gửi thông báo (postMessage).activatenhận một đối số không bắt buộc để truyền dữ liệu đến<portal>khi kích hoạt. - Giao diện
portalHost: Thêm đối tượngportalHostvào đối tượngwindow. Điều này cho phép bạn kiểm tra xem trang có được nhúng dưới dạng phần tử<portal>hay không. Lớp này cũng cung cấp một giao diện để nhắn tin (postMessage) trở lại máy chủ lưu trữ. - Giao diện PortalActivateEvent: Một sự kiện kích hoạt khi
<portal>được kích hoạt. Có một hàm gọn gàng tên làadoptPredecessormà bạn có thể dùng để truy xuất trang trước dưới dạng phần tử<portal>. Nhờ đó, bạn có thể tạo ra trải nghiệm điều hướng liền mạch và kết hợp giữa hai trang.
Hãy cùng tìm hiểu thêm ngoài mẫu sử dụng cơ bản. Dưới đây là danh sách chưa đầy đủ về những việc bạn có thể làm với Cổng thông tin cùng với mã mẫu.
Tuỳ chỉnh kiểu khi được nhúng dưới dạng phần tử <portal>
// Detect whether this page is hosted in a portal
if (window.portalHost) {
// Customize the UI when being embedded as a portal
}
Nhắn tin giữa phần tử <portal> và 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
});
Kích hoạt phần tử <portal> và nhận sự kiện portalactivate
// 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;
});
Đang truy xuất phiên bản trước
// Listen to the portalactivate event
window.addEventListener('portalactivate', (evt) => {
// ... and creatively use the predecessor
const portal = evt.adoptPredecessor();
document.querySelector('someElm').appendChild(portal);
});
Biết rằng trang của bạn đã được sử dụng làm trang tiền nhiệm
// 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
});
}
});
Bằng cách kết hợp tất cả các tính năng mà Cổng thông tin hỗ trợ, bạn có thể xây dựng trải nghiệm người dùng thực sự thú vị. Ví dụ: bản minh hoạ dưới đây cho thấy cách Portals có thể mang lại trải nghiệm người dùng liền mạch giữa một trang web và nội dung nhúng của bên thứ ba.
Trường hợp sử dụng và kế hoạch
Chúng tôi hy vọng bạn thích chuyến tham quan ngắn này về Cổng thông tin! Chúng tôi rất mong được thấy những ý tưởng của bạn. Ví dụ: bạn có thể muốn bắt đầu sử dụng Cổng cho các thao tác điều hướng không đơn giản như: kết xuất trước trang cho sản phẩm bán chạy nhất của bạn từ trang danh sách danh mục sản phẩm.
Một điều quan trọng khác cần biết là bạn có thể sử dụng Cổng trong các thao tác điều hướng khác nguồn gốc, giống như <iframe>. Vì vậy, nếu có nhiều trang web tham chiếu chéo lẫn nhau, bạn cũng có thể sử dụng Cổng để tạo các thao tác điều hướng liền mạch giữa hai trang web khác nhau. Trường hợp sử dụng khác nguồn gốc này rất đặc biệt đối với Cổng thông tin và thậm chí có thể cải thiện trải nghiệm người dùng của ứng dụng trang đơn (SPA).
Chúng tôi mong nhận được ý kiến phản hồi của bạn
Cổng thông tin đã sẵn sàng để thử nghiệm trong Chrome 85 trở lên. Ý kiến phản hồi của cộng đồng đóng vai trò quan trọng trong việc thiết kế các API mới, vì vậy, hãy dùng thử và cho chúng tôi biết ý kiến của bạn! Nếu bạn có yêu cầu về tính năng hoặc ý kiến phản hồi, vui lòng truy cập vào kho lưu trữ GitHub của WICG.