想要了解新提案的 Portals API 是如何改善页面跳转用户体验的吗?本文将主要对 Portals 的具体内容、Portals 在 Chrome Canary 中的试用、Portals 的规范等几个方面进行详细讲解。如果你希望用户在浏览自家网站时,能够在不同页面跳转得更加流畅,不妨来读一读这篇文章。
确保页面快速加载是提供良好用户体验的关键。但是我们经常忽略的一个领域是页面过渡,也就是用户在页面之间移动时所看到的内容。
一项名为 Portals 的 Web 平台 API 新提案,可以让用户在浏览网站时提升不同页面间跳转的流畅体验,从而帮助实现这一目标。该视频展示了 Portals 的实际使用效果。
Portals 带来了哪些内容
单页应用程序(SPA)提供了很好的页面过渡效果,但代价是更高的构建复杂性。多页面应用程序(MPA)的构建更容易一些,但结果会导致页面之间跳转时屏幕显示空白内容。
Portals 则取两者所长:同时具备 MPA 的低复杂性和 SPA 的无缝过渡效果。可以将它们视为一个iframe
,其中可以嵌入内容。但与iframe
不同,它们还具有跳转到其中内容上的功能。
眼见为实,请先来看看我们去年在 Chrome 开发者峰会上展示的内容。
使用经典跳转时,用户必须在等待时看着空白屏幕,直到浏览器渲染完目标页面为止。现在有了 Portals,用户可以在等待时体验到动画效果,而portal
会预渲染内容并创建出无缝的跳转体验。
在 Portals 诞生之前,我们可以使用iframe
来预先渲染另一个页面。我们还可以添加动画在页面上移动这个 frame。但是iframe
不能让你跳转到其中的内容上。Portals 弥补了这一空白,从而可以实现一些有趣的用例。
在 Chrome Canary 中试用 Portals
要在 Chrome Canary 中试用 Portals,只需启用一个实验性标志:
chrome://flags/#enable-portals
目前在 Portals 实验的早期阶段,我们还建议设置 --user-data-dir 命令行标志,使用完全独立的用户数据目录进行测试。启用 Portals 后,在开发工具中确认你已经有了全新的 HTMLPortalElement。
让我们来看一个基本的例子。
// 用维基百科页面创建一个 portal,然后嵌入它。
// (就像一个 iframe)。你也可以使用<portal>标志。
portal = document.createElement('portal');
portal.src = 'https://en.wikipedia.org/wiki/World_Wide_Web';
portal.style = '...';
document.body.appendChild(portal);
// 用户触碰预览时(嵌入的 portal):
// 播放漂亮的动画,例如展开……
// 实际跳转完成后动画结束。
portal.activate();
复制代码
就这么简单。在开发工具控制台中尝试这段代码,应该会打开维基百科页面。
如果你想构建像我们在 Chrome 开发者峰会上展示的那种效果,就像上面的视频演示那样,那么可以看看下面这段有趣的代码。
// 添加一些过渡样式
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');
// 跳转到 WICG Portals spec 页面
portal.src = 'https://wicg.github.io/portals/';
// 添加一个定义了过渡效果的类。考虑使用
// `prefers-reduced-motion` media query 来控制动画。
// https://developers.google.com/web/updates/2019/03/prefers-reduced-motion
portal.classList.add('portal-transition');
portal.addEventListener('click', evt => {
// 用户交互时显示 portal 的动画
portal.classList.add('portal-reveal');
});
portal.addEventListener('transitionend', evt => {
if (evt.propertyName == 'transform') {
// 过渡效果完成时激活这个 portal
portal.activate();
}
});
document.body.append(style, portal);
复制代码
功能检测也很容易,这样就可以使用 Portals 对网站进行渐进式增强。
if ('HTMLPortalElement' in window) {
// 如果这个平台有 Portals……
const portal = document.createElement('portal');
...
}
复制代码
如果你想快速体验 Portal 的感觉,请试试 uskay-portals-demo.glitch.me。请使用 Chrome Canary 访问它并打开实验性标志!
1.输入你要预览的 URL。
2.然后,该页面将作为一个元素嵌入。
3.单击预览。
4.动画播放后将激活预览。
查看规范
我们正在 Web 孵化社区组(WICG)中积极讨论 Portals 的规范。要跟上最新的节奏,请看一下 explainer。以下是你需要熟悉的三个重要功能:
portal
元素:HTML 元素本身。该 API 非常简单。它由 src 属性、activate 函数和消息传递接口(postMessage)组成。activate 带有一个可选参数,以在激活时将数据传递给portal
。
portalHost 接口:将一个 portalHost 对象添加到 window 对象。这使你可以检查页面是否作为portal
元素嵌入。它还提供了用于将消息传递(postMessage)返回主机的接口。
PortalActivateEvent 接口:激活portal
时将触发的事件。有一个整洁的函数,名为 adoptPredecessor,你可以用它将上一页作为一个portal
元素取回。这使你可以在两个页面之间创建无缝跳转和组合式体验。
下面看看基本使用模式以外的内容。以下是 Portals 可以实现的内容详细列表及示例代码。
当嵌入为元素时自定义样式
// 检查该页面是否由一个 portal 托管
if (window.portalHost) {
// 嵌入为 portal 时自定义 UI
}
复制代码
元素和 portalHost 之间的消息传递
// 向 portal 元素发送消息
const portal = document.querySelector('portal');
portal.postMessage({someKey: someValue}, ORIGIN);
// 通过 window.portalHost 接收消息
window.portalHost.addEventListener('message', evt => {
const data = evt.data.someKey;
// 处理事件
});
复制代码
激活元素并接收 portalactivate 事件
// 你可以选择向激活函数的参数添加数据
portal.activate({data: {'somekey': 'somevalue'}});
// 激活时 portal 内容会接收 portalactivate 事件
window.addEventListener('portalactivate', evt => {
// 数据作为 evt.data 可用
const data = evt.data;
});
复制代码
获取前页
// 侦听 portalactivate 事件
window.addEventListener('portalactivate', evt => {
// ……创新地使用前页
const portal = evt.adoptPredecessor();
document.querySelector('someElm').appendChild(portal);
});
复制代码
知道你的页面已被视为前页
// 激活函数返回一个 Promise.
// 当 promise 解析时, 意味着 portal 已被激活。
// 如果该文档被其采用,则会存在 window.portalHost。
portal.activate().then(_ => {
// 检查该文档是否被 portal 元素采纳。
if (window.portalHost) {
// 可以开始与 portal 元素通信
// 如侦听消息
window.portalHost.addEventListener('message', evt => {
// 处理事件
});
}
});
复制代码
通过组合 Portals 支持的所有这些功能,你可以构建非常精美的用户体验。例如,该视频演示了 Portal 如何在网站和第三方嵌入内容之间实现无缝的用户体验。
对这个演示感兴趣吗?可以在 GitHub 上 fork 它,并构建你自己的版本。
用例和计划
我们希望你喜欢这篇关于 Portals 的简短介绍!我们迫不及待想看看大家能做出些什么内容。你可能想要开始使用 Portals 进行非常规跳转,比如,从产品类别列表页面中预渲染最畅销产品页面。
另一件重要的事情是,Portals 可以像iframe
一样用于跨域跳转。因此,如果你有多个相互交叉引用的网站,还可以使用 Portals 在两个不同的网站之间创建无缝跳转。这是 Portals 的独特用例,甚至可以改善 SPA 的用户体验。
欢迎反馈
Portals 提案仍处于早期阶段,因此并非一切都能正常工作(这就是它位于实验性标志后的原因)。也就是说,它已准备好在 Chrome Canary 中进行实验。社区的反馈对于新 API 的设计至关重要,因此请尝试一下,并告诉我们你的想法!你可以在 Chromium 错误跟踪器上检查当前的限制条件。如果你有任何功能要求或反馈,请转到 WICG GitHub 仓库。
原文链接:
https://web.dev/hands-on-portals/
评论 1 条评论