Portals ile uygulamalı çalışma: Web'de sorunsuz gezinme

Önerilen Portals API'nin gezinme kullanıcı deneyiminizi nasıl iyileştirebileceğini öğrenin.

Yusuke Utsunomiya
Yusuke Utsunomiya

Sayfalarınızın hızlı yüklenmesini sağlamak, iyi bir kullanıcı deneyimi sunmanın anahtarıdır. Ancak genellikle gözden kaçırdığımız bir alan var: sayfa geçişleri, yani kullanıcılarımızın sayfalar arasında gezinirken gördükleri.

Portals adlı yeni bir web platformu API teklifi, kullanıcılar sitenizde gezinirken deneyimi kolaylaştırarak bu konuda yardımcı olmayı amaçlamaktadır.

Portals'ın nasıl çalıştığını görün:

Portals ile sorunsuz yerleştirme ve gezinme. Adam Argyle tarafından oluşturulmuştur.

Portalların sağladığı olanaklar

Tek sayfalık uygulamalar (SPA) güzel geçişler sunar ancak oluşturulması daha karmaşıktır. Çok sayfalı uygulamaları (MPA) oluşturmak çok daha kolaydır ancak sayfalar arasında boş ekranlar görürsünüz.

Portallar, her iki dünyanın da en iyi özelliklerini sunar: MPA'nın düşük karmaşıklığı ve SPA'nın sorunsuz geçişleri. Bunları yerleştirmeye olanak tanıyan <iframe> gibi düşünebilirsiniz. Ancak <iframe>'ten farklı olarak, içeriklerine gitme özellikleri de vardır.

Gözlerinizle görün: Lütfen önce Chrome Dev Summit 2018'de sergilediklerimize göz atın:

Klasik gezinme yöntemlerinde kullanıcılar, tarayıcı hedefi oluşturmayı tamamlayana kadar boş bir ekranla beklemek zorunda kalır. Portallar sayesinde kullanıcılar bir animasyon deneyimi yaşarken <portal>, içeriği önceden oluşturur ve sorunsuz bir gezinme deneyimi sunar.

Portallar'dan önce, başka bir sayfayı <iframe> kullanarak oluşturabiliyorduk. Çerçeveyi sayfa üzerinde hareket ettirmek için animasyonlar da ekleyebilirdik. Ancak <iframe>, içeriğinde gezinmenize izin vermez. Portallar bu boşluğu doldurarak ilginç kullanım alanları sağlar.

Portalları deneyin

about://flags üzerinden etkinleştirme

Deneysel bir işaretçiyi etkinleştirerek Chrome 85 ve sonraki sürümlerde Portals'ı deneyebilirsiniz:

  • Aynı kaynaklı gezinmeler için about://flags/#enable-portals işaretini etkinleştirin.
  • Çapraz kaynak gezinmelerini test etmek için about://flags/#enable-portals-cross-origin işaretini de etkinleştirin.

Portals denemesinin bu erken aşamasında, testleriniz için tamamen ayrı bir kullanıcı verileri dizini kullanmanızı da öneririz. Bunun için --user-data-dir komut satırı işaretini ayarlamanız gerekir. Portallar etkinleştirildikten sonra Geliştirici Araçları'nda yeni HTMLPortalElement özelliğine sahip olduğunuzu onaylayın.

HTMLPortalElement'i gösteren Geliştirici Araçları konsolunun ekran görüntüsü

Portalları uygulama

Temel bir uygulama örneğini inceleyelim.

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

Bu kadar basit. Bu kodu Geliştirici Araçları konsolunda deneyin. Wikipedia sayfası açılacaktır.

Önizleme portalı stili demosunun GIF'i

Chrome Dev Summit'te gösterdiğimiz ve yukarıdaki demo gibi çalışan bir şey oluşturmak istiyorsanız aşağıdaki snippet ilginizi çekecektir.

// 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'ı kullanarak bir web sitesini aşamalı olarak geliştirmek için özellik algılama yapmak da kolaydır.

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

Aşağıdaki demoda Portals'ın nasıl çalıştığı gösterilmektedir:

  1. Önizlemek istediğiniz URL'yi girin.
  2. Ardından sayfa, <portal> öğesi olarak yerleştirilir.
  3. Önizlemeyi tıklayın.
  4. Önizleme, bir animasyondan sonra etkinleştirilir.

Portals demosunun kullanımını gösteren bir GIF

Teknik özellikleri inceleyin

Web Incubation Community Group'ta (WICG) Portals spesifikasyonunu aktif olarak tartışıyoruz. Hızlı bir şekilde bilgi edinmek için temel senaryolardan bazılarına göz atın. Aşağıda, bilgi edinmeniz gereken üç önemli özellik verilmiştir:

  • <portal> öğesi: HTML öğesinin kendisi. API çok basittir. src özelliği, activate işlevi ve mesajlaşma için bir arayüzden (postMessage) oluşur. activate, etkinleştirme sırasında <portal>'ye veri iletmek için isteğe bağlı bir bağımsız değişken alır.
  • portalHost arayüzü: window nesnesine bir portalHost nesnesi ekler. Bu sayede, sayfanın <portal> öğesi olarak yerleştirilip yerleştirilmediğini kontrol edebilirsiniz. Ayrıca, ana makineye mesaj göndermek (postMessage) için bir arayüz sağlar.
  • PortalActivateEvent arayüzü: <portal> etkinleştirildiğinde tetiklenen bir etkinlik. Önceki sayfayı <portal> öğesi olarak almak için kullanabileceğiniz adoptPredecessor adlı kullanışlı bir işlev vardır. Bu sayede iki sayfa arasında sorunsuz gezinme ve birleştirilmiş deneyimler oluşturabilirsiniz.

Temel kullanım modelinin ötesine geçelim. Portals ile yapabileceklerinizin olası her örneği içermeyen bir listesini ve örnek kodu aşağıda bulabilirsiniz.

<portal> öğesi olarak yerleştirildiğinde stili özelleştirme

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

<portal> öğesi ile portalHost arasında mesajlaşma

// 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> öğesini etkinleştirme ve portalactivate etkinliğini alma

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

Önceki sürüm alınıyor

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

Sayfanızın öncül olarak kabul edildiğini bilmek

// 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 tarafından desteklenen tüm özellikleri birleştirerek gerçekten etkileyici kullanıcı deneyimleri oluşturabilirsiniz. Örneğin, aşağıdaki demoda Portals'ın bir web sitesi ile üçüncü taraf yerleştirme içeriği arasında sorunsuz bir kullanıcı deneyimi sunmak için nasıl kullanılabileceği gösterilmektedir.

Kullanım alanları ve planlar

Portals'ın bu kısa turunu beğendiğinizi umuyoruz. Neler üreteceğinizi görmek için sabırsızlanıyoruz. Örneğin, bir ürün kategorisi listeleme sayfasından en çok satan ürününüzün sayfasını önceden oluşturma gibi önemsiz olmayan gezinmeler için Portals'ı kullanmaya başlayabilirsiniz.

Portalların, tıpkı <iframe> gibi çapraz kaynaklı gezinmelerde de kullanılabileceğini unutmayın. Dolayısıyla, birbirine çapraz referans veren birden fazla web siteniz varsa iki farklı web sitesi arasında sorunsuz gezinme deneyimi oluşturmak için Portals'ı da kullanabilirsiniz. Bu çapraz kaynak kullanım alanı, Portals'a özgüdür ve SPA'ların kullanıcı deneyimini bile iyileştirebilir.

Geri bildirimlerinize önem veriyoruz

Portallar, Chrome 85 ve sonraki sürümlerde denemeye hazırdır. Topluluktan gelen geri bildirimler, yeni API'lerin tasarımı açısından çok önemlidir. Bu nedenle, lütfen yeni API'yi deneyin ve düşüncelerinizi bizimle paylaşın. Özellik isteğiniz veya geri bildiriminiz varsa lütfen WICG GitHub deposuna gidin.