آشنایی با Portals: ناوبری یکپارچه در وب

با نحوه بهبود تجربه کاربری پیمایش بااستفاده از Portals API پیشنهادی آشنا شوید.

Yusuke Utsunomiya
Yusuke Utsunomiya

اطمینان از اینکه صفحه‌هایتان سریع بار می‌شود کلید ارائه تجربه کاربری خوب است. اما حوزه‌ای که اغلب نادیده می‌گیریم انتقال صفحه است—آنچه کاربران هنگام جابه‌جایی بین صفحه‌ها می‌بینند.

پیشنهاد جدیدی برای API پلاتفرم وب به‌نام Portals ارائه شده است که هدف آن کمک به این موضوع ازطریق ساده‌سازی تجربه کاربران هنگام پیمایش در سراسر سایت شما است.

دیدن «درگاه‌ها» در عمل:

جاسازی و پیمایش یکپارچه با «پرتال‌ها». ایجادشده توسط آدام آرگیل.

آنچه «درگاه‌ها» فعال می‌کند

«برنامه‌های تک‌صفحه‌ای» (SPA) انتقال‌های خوبی ارائه می‌دهند اما هزینه آن پیچیدگی بیشتر در ساخت است. ساختن برنامه‌های چندصفحه‌ای (MPA) بسیار آسان‌تر است، اما درنهایت بین صفحه‌ها با صفحه‌نمایش‌های خالی مواجه می‌شوید.

درگاه‌ها بهترین‌های هر دو دنیا را ارائه می‌دهند: پیچیدگی کم MPA با انتقال یکپارچه SPA. آن‌ها را مانند یک <iframe> در نظر بگیرید که امکان جاسازی را فراهم می‌کنند، اما برخلاف یک <iframe>، آن‌ها همچنین دارای ویژگی‌هایی برای پیمایش به محتوای خود هستند.

شنیدن کی بود مانند دیدن: لطفاً ابتدا آنچه را در «اجلاس توسعه‌دهندگان Chrome» در سال ۲۰۱۸ به‌نمایش گذاشتیم ببینید:

با پیمایش‌های کلاسیک، کاربران باید با صفحه‌ای خالی منتظر بمانند تا مرورگر پرداز مقصد را تمام کند. با «درگاه‌ها»، کاربران پویانمایی را تجربه می‌کنند، درحالی‌که <portal> محتوا را پیش‌پرداز می‌کند و تجربه پیمایش یکپارچه‌ای ایجاد می‌کند.

پیش‌از Portals، می‌توانستیم صفحه دیگری را بااستفاده از <iframe> ارائه کنیم. همچنین می‌توانستیم پویانمایی‌هایی اضافه کنیم تا قاب را در صفحه جابه‌جا کند. اما <iframe> به شما اجازه نمی‌دهد در محتوای آن پیمایش کنید. درگاه‌ها این شکاف را پر می‌کنند و موارد استفاده جالبی را ممکن می‌سازند.

امتحان کردن «درگاه‌ها»

فعال کردن ازطریق flags://about

با فعال کردن پرچم آزمایشی، «درگاه‌ها» را در Chrome 85 و نسخه‌های جدیدتر امتحان کنید:

  • پرچم about://flags/#enable-portals را برای ناوبری‌های هم‌مبدأ فعال کنید.
  • برای آزمایش پیمایش‌های میان‌مبدئی، پرچم about://flags/#enable-portals-cross-origin را نیز فعال کنید.

درطول این مرحله اولیه از آزمایش Portals، همچنین توصیه می‌کنیم از دایرکتوری داده‌های کاربر کاملاً جداگانه‌ای برای آزمایش‌هایتان استفاده کنید با تنظیم پرچم خط فرمان --user-data-dir. پس‌از فعال شدن «درگاه‌ها»، در DevTools تأیید کنید که HTMLPortalElement جدید و درخشان را دارید.

نماگرفتی از کنسول DevTools که HTMLPortalElement را نشان می‌دهد

پیاده‌سازی درگاه‌ها

بیایید یک نمونه پیاده‌سازی پایه را با هم مرور کنیم.

// 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();
});

به همین سادگی است. این کد را در کنسول DevTools امتحان کنید، صفحه ویکی‌پدیا باید باز شود.

گیف نسخه نمایشی سبک درگاه پیش‌نمایش

اگر می‌خواهید چیزی شبیه به آنچه در Chrome Dev Summit نشان دادیم بسازید که دقیقاً مانند نسخه نمایشی بالا کار می‌کند، قطعه زیر برایتان جالب خواهد بود.

// 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);

همچنین به‌راحتی می‌توان تشخیص ویژگی را برای بهبود تدریجی وب‌سایت بااستفاده از Portals انجام داد.

if ('HTMLPortalElement' in window) {
  // If this is a platform that have Portals...
  const portal = document.createElement('portal');
  ...
}

نسخه نمایشی زیر نشان می‌دهد که «درگاه‌ها» چه حسی دارند:

  1. نشانی وبی را که می‌خواهید پیش‌نمایش شود وارد کنید.
  2. سپس صفحه به‌عنوان عنصر <portal> جاسازی خواهد شد.
  3. روی پیش‌نمایش کلیک کنید.
  4. پیش‌نمایش پس‌از پویانمایی فعال خواهد شد.

گیفی از استفاده از نسخه نمایشی Portals

مشخصات را بررسی کنید

ما فعالانه درحال بحث درباره مشخصات Portals در «گروه انجمن رشد وب» (WICG) هستیم. برای اینکه سریعاً با این ویژگی آشنا شوید، نگاهی به برخی از سناریوهای کلیدی بیندازید. این سه ویژگی مهمی است که باید با آن‌ها آشنا شوید:

  • عنصر <portal>: خود عنصر اچ‌تی‌ام‌ال. میانای برنامه‌سازی کاربردی بسیار ساده است. این API از مشخصه src، تابع activate، و میانایی برای پیام‌رسانی (postMessage) تشکیل شده است. activate آرگومانی اختیاری را برای ارسال داده به <portal> پس‌از فعال‌سازی می‌گیرد.
  • میانای portalHost: شیء portalHost را به شیء window اضافه می‌کند. این کار به شما امکان می‌دهد بررسی کنید که آیا صفحه به‌عنوان عنصر <portal> جاسازی شده است یا نه. همچنین میانایی برای ارسال پیام (postMessage) به میزبان ارائه می‌دهد.
  • میانای PortalActivateEvent: رویدادی که هنگام فعال شدن <portal> اجرا می‌شود. تابع جالبی به‌نام adoptPredecessor وجود دارد که می‌توانید از آن برای بازیابی صفحه قبلی به‌عنوان عنصر <portal> استفاده کنید. این به شما امکان می‌دهد پیمایش‌های یکپارچه و تجربه‌های ترکیبی بین دو صفحه ایجاد کنید.

بیایید فراتر از الگوی استفاده پایه را بررسی کنیم. در اینجا فهرستی غیرجامع از آنچه می‌توانید با Portals به‌همراه کد نمونه به‌دست آورید آورده شده است.

سفارشی‌سازی سبک هنگام جاسازی به‌عنوان عنصر <portal>

// Detect whether this page is hosted in a portal
if (window.portalHost) {
  // Customize the UI when being embedded as a portal
}

پیام‌رسانی بین عنصر <portal> و 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
});

فعال کردن عنصر <portal> و دریافت رویداد 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;
});

درحال بازیابی پیشین

// Listen to the portalactivate event
window.addEventListener('portalactivate', (evt) => {
  // ... and creatively use the predecessor
  const portal = evt.adoptPredecessor();
  document.querySelector('someElm').appendChild(portal);
});

دانستن اینکه صفحه شما به‌عنوان پیشین پذیرفته شده است

// 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
    });
  }
});

با ترکیب کردن همه ویژگی‌های پشتیبانی‌شده توسط Portals، می‌توانید تجربه‌های کاربری واقعاً جذابی بسازید. برای مثال، نسخه نمایشی زیر نشان می‌دهد که چگونه Portals می‌تواند تجربه کاربری یکپارچه‌ای را بین وب‌سایت و محتوای جاسازی‌شده شخص ثالث ایجاد کند.

موارد استفاده و طرح‌ها

امیدواریم از این گشت کوتاه در «درگاه‌ها» لذت برده باشید! بی‌صبرانه منتظریم ببینیم چه چیزی می‌توانید ارائه دهید. برای مثال، ممکن است بخواهید از «درگاه‌ها» برای پیمایش‌های غیربدیهی استفاده کنید، مانند: پیش‌پرداز کردن صفحه برای محصول پرفروش شما از صفحه فهرست دسته محصول.

نکته مهم دیگری که باید بدانید این است که از «پورتال‌ها» می‌توان در پیمایش‌های میان‌مبدئی استفاده کرد، درست مثل <iframe>. بنابراین، اگر چند وب‌سایت دارید که به یکدیگر ارجاع می‌دهند، می‌توانید از Portals برای ایجاد پیمایش‌های یکپارچه بین دو وب‌سایت مختلف نیز استفاده کنید. این مورد استفاده میان‌مبدئی برای «درگاه‌ها» بسیار منحصربه‌فرد است و حتی می‌تواند تجربه کاربری برنامه‌های تک‌صفحه‌ای را بهبود بخشد.

بازخورد پذیرفته می‌شود

درگاه‌ها برای آزمایش در Chrome نسخه ۸۵ و نسخه‌های جدیدتر آماده هستند. بازخورد انجمن برای طراحی میاناهای برنامه‌سازی کاربردی جدید بسیار مهم است، بنابراین لطفاً آن را امتحان کنید و نظرتان را به ما بگویید! اگر درخواست ویژگی یا بازخوردی دارید، لطفاً به مخزن GitHub مربوط به WICG مراجعه کنید.