5 Kasım 2026 · 8 dk okuma

Özel Liquid Bölüm Performansı: LCP, Theme Inspector ve section:load Yeniden Başlatması

Özel Liquid bölümlerde LCP denetimi ve düzeltmeyi Theme Inspector alev grafikleri, section.index yükleme stratejisi ve güvenli section:load ile öğrenin.

Özel Liquid Bölüm Performansı: LCP, Theme Inspector ve section:load Yeniden Başlatması

Özel Liquid bölümler, Shopify temalarında LCP regresyonunun en yaygın kaynağıdır. Temel nedenler neredeyse her zaman üç şeyden biridir: yanlışlıkla tembel yüklenen bir hero resmi, bir döngüde sunucu zamanını harcayan bir Liquid şablonu veya sadece DOMContentLoaded'da çalışan ve tema editöründe sessizce kıran JavaScript. Üçü de nerede bakacağınızı bildiğinizde düzeltilebilir.

Temel çıkarımlar

  • Shopify'ın image_tag filtresi, 3. pozisyonun ötesindeki bölümlere otomatik olarak loading="lazy" uygular, bu nedenle hero'nun bunu section.index ile geçersiz kılması gerekir.
  • Theme Inspector alev grafiği (Chrome Web Store'da sürüm 3.0.2, Ocak 2025'te güncellendi) satır başına Liquid maliyetini ortaya koymaktadır. Toplam 200ms'nin altında hedefleyin; 500ms'nin üzerindeki her şeyi P1 olarak değerlendirin.
  • shopify:section:load bir bölüm editörde eklendiğinde veya yeniden render edildiğinde her seferinde ateşlenir. Bu, DOMContentLoaded'ın yerine geçmez.
  • Yığılan olay dinleyicileri en yaygın editör çöküş desenidir. Handler'ı her zaman adlandırılmış bir değişkende depolayın ve shopify:section:unload içinde silin.
  • section.index ve section.location hiçbir ticari olarak görünen ayar değiştirmesi olmadan render zamanında yükleme stratejisini dallandırmanıza izin verir.

Özel bölümler neden yerleşik bölümlerden daha çok LCP'ye zarar verir

Shopify'ın resmi performans belgeleri, 2025'in sonlarında web performans mühendisi Dan Gayle altında 10 aylık bir dönem boyunca genişletilen, bu konu hakkında açıktır: doğru resim yükleme stratejisi, çoğu vitrin için LCP'de doğrudan bir etkiye sahiptir. Sorun, özel bölümleri sıfırdan yazan tema yazarlarının, Dawn ve Horizon'un otomatik olarak işlediği yükleme stratejisi dallanmasını sıklıkla atlaması olmuştur.

Alan verilerindeki spesifik sayılar anlamlandırmaya değer. Ortalama Shopify mağazası mobil LCP'de 3.0 ile 4.5 saniye arasında kalmaktadır. Google'ın "İyi" eşiği 2.5 saniyenin altıdır. 2.5 saniyelik LCP'deki mağazaların, 3.5 saniyelik LCP'si olan mağazalardan yaklaşık yüzde 30 daha yüksek dönüşüm gördüğü, Shopify'ın kendi yayınlanan rakamlarına göre bildirilmektedir. Bu farklar gerçektir ve orantısız olarak özellikle de özellikler değil yükleme sırası üzerine odaklanan geliştiriciiler tarafından yazılan üst alan bölümlerinden kaynaklanır.

1. Adım: Theme Inspector ile Suçluyu Belirleyin

Shopify Theme Inspector for Chrome (şu anda sürüm 3.0.2'de olan resmi Shopify tarafından oluşturulmuş uzantı) sunucu tarafında Liquid yürütümünün bir alev grafiğini oluşturur. Yükleyin, Shopify kimlik bilgilerinizle oturum açın, geliştirme mağazanızda herhangi bir sayfayı yükleyin ve uzantı simgesini tıklayın.

Gördüğünüz şey, her düğümün bir Liquid dosyasını veya bloğunu temsil ettiği bir zaman çizelgesidir. Düğüm genişliği render zamanıyla orantılıdır. Anahtar okuma:

  • Zaman - bu düğümün (artı onun alt düğümleri) sunucuda ne kadar sürdüğü.
  • Yüzde - o düğümün toplam render zamanından payı.
  • Sandwich görünümü - aynı filtreye veya etikete yapılan her çağrıyı gruplandırır, böylece tekrarlanan çağrılardan kümülatif maliyeti görebilirsiniz.

Shopify'ın rehberliği, 500ms'yi sabit tavan olarak kabul edinerek toplam 200ms'yi hedeflemektir. 10.000'in üzerinde SKU'su olan bir kataloğunda özel bir koleksiyon bölümünün 480ms'den 61ms'ye sadece bir metafield aramasını ürün döngüsünün dışına çıkararak geçtiğini gördüm. Alev grafiği döngüyü iki dakikadan kısa sürede açık hale getirmiştir.

İzlemek için yaygın alev grafiği desenleri

  • layout/theme.liquid düğümünden görsel olarak daha geniş bir bölüm düğümü, genellikle yineleme başına API çağrılarını içeren bir Liquid döngüsüne sahip olduğunuzu anlamına gelir.
  • Sandwich görünümünde yüzlerce kez görünen bir filter:image_url düğümü, filtreyi sonucu saklamadan bir döngü içinde çağırdığınız anlamına gelir. Her çağrı ucuz olmuştur (yaklaşık 50 mikrosaniye), ancak bunlardan 2.000'i sessizce 100ms ekler.
  • Geniş ancak görünür alt öğeleri olmayan her şey, genellikle sınırsız bir for product in collection.products döngüsüdür, bu da yineleme başına tam bir ürün yüklemesini tetikler.
{%- comment -%} Kötü: döngü içinde N+1 metafield getirmesi {%- endcomment -%}
{%- for product in collection.products -%}
  {{ product.metafields.custom.badge.value }}
{%- endfor -%}

{%- comment -%} Daha iyi: döngüyü kaldırın, assign içinde önbelleğe alın {%- endcomment -%}
{%- assign badge_map = '' -%}
{%- for product in collection.products -%}
  {%- assign badge = product.metafields.custom.badge.value -%}
  {%- if badge != blank -%}...{%- endif -%}
{%- endfor -%}

2. Adım: section.index ve fetchpriority ile LCP'yi Düzeltin

Özel bir hero bölümündeki tek en zararlı hata, banner resmine loading="lazy" eklemektir. Shopify'ın verileri, bir noktada Shopify sayfalarının yüzde 82'sinin LCP resimlerini tembel yüklediğini göstermiştir. Başlık resiminden loading="lazy"'yi kaldırmak, Shopify'ın performance.shopify.com'da yayınladığı WebPageTest karşılaştırmasında LCP'yi 0.5 saniye iyileştirmiştir.

Shopify'ın Liquid API'si, bir ticari olarak görünen toggle olmadan bunu doğru şekilde işlemek için iki özellik sağlar:

  • section.index - bölümün konumu içindeki 1 tabanlı konum (template, header, footer, vb.).
  • section.index0 - aynı, ancak 0 tabanlı.
  • section.location - kapsam dizesi (template, header, footer veya özel bölüm grubu adı).

Not: section.index statik bölümler için nil döndürür (bunlar theme.liquid'de kodlanmış olanlar, JSON şablonu aracılığıyla dahil edilenler yerine), bu nedenle koşullu mantıkta her zaman nil'e karşı koruma sağlayın.

Özel bir resim-banner bölümü için doğru bir yükleme stratejisi:

{%- liquid
  assign loading_strategy = 'lazy'
  assign fetch_priority = 'auto'

  if section.index == 1
    assign loading_strategy = 'eager'
    assign fetch_priority = 'high'
  elsif section.index <= 3
    assign loading_strategy = 'eager'
  endif
-%}

{%- if section.index == 1 -%}
  <link
    rel="preload"
    as="image"
    href="{{ section.settings.image | image_url: width: 1200 }}"
    fetchpriority="high"
  >
{%- endif -%}

{{ section.settings.image
  | image_url: width: 1500
  | image_tag:
    loading: loading_strategy,
    fetchpriority: fetch_priority,
    width: section.settings.image.width,
    height: section.settings.image.height
}}

Shopify'ın resmi performans belgeleri, "LCP resmini asla tembel yüklemeyin"i, "LCP resmini fetchpriority="high" ile işaretleyin" etiketiyle birlikte Yüksek öncelikli bir öneri olarak belirtir. theme.liquid'deki preload linki (veya bölümün kendi {% style %} bloğunda bölümün ilk olduğunu biliyorsanız) resmi, Liquid sayfanın geri kalanını render etmeyi bitirmeden tarayıcının preload tarayıcısına çeker.

Bölüm konumuna göre resim yükleme stratejisi

section.index değeriÖnerilen loadingÖnerilen fetchpriorityNotlar
1eagerhighHero veya banner. <link rel="preload"> ekleyin.
2 veya 3eagerautoÇoğu görünüm alanında üst kısımdan aşağıda.
4 veya daha yükseklazyautoVarsayılan image_tag davranışı bunu zaten yapar.
nil (statik bölüm)eager veya hardcodeautosection.index mevcut değildir; bunun yerine bir bölüm ayarı kullanın.

Resim ızgarası render eden bölümler için (ürün kartları, koleksiyon kutucukları), section.index'i forloop.index ile birleştirin: ilk satırı eager yükleyin, bunun altındaki her şeyi tembel yükleyin.

3. Adım: Dinleyicileri Yığmadan section:load Yeniden Başlatması

Bu, çoğu öğretici tarafından atlanan kısımdır. Bir ticari, tema editöründe bir bölüm ayarını düzenledikçe, Shopify tüm bölüm HTML'sini yeniden render eder ve shopify:section:load ateşlenir. Shopify'ın kendi belgeleri tarafından ifade edildiği üzere, olay "bir bölüm eklendiğinde veya yeniden render edildiğinde" ateşlenir ve "bölümün çalışması ve düzgün şekilde görüntülenmesi için gerekli herhangi bir JavaScript'i, sayfanın az önce yüklenmiş gibi yeniden yürütmeniz gerekir."

Sorun, bölüm içindeki betik etiketinin bölüm HTML'si her değiştirilişinde çalışmasıdır. Dinleyici kaydınız satır içi ise, eski olanı kaldırmadan her düzenlemede yeni bir dinleyici eklersiniz. Sonuç, yinelenen başlatmalar, kırılan kaydırıcılar ve ağır durumlarda donmuş bir tema editörüdür (her düzenleme o oturumda N düzenlemesi için N paralel başlatmasını tetikler).

Güvenli yeniden başlatma için üç kural:

  1. Handler'ı, aynı referansı removeEventListener'a geçebilmek için adlandırılmış bir değişkende depolayın.
  2. shopify:section:unload içinde kaldırma temizliğini çalıştırın; bu, bölüm değiştirilmeden hemen önce ateşlenir.
  3. Her DOM sorgusunu event.target veya document.getElementById('shopify-section-' + event.detail.sectionId) ile kapsam içine alın, asla global document'a değil.
// sections/my-carousel.liquid, satır içi <script>
(function () {
  const sectionId = {{ section.id | json }};
  const selector = '.my-carousel__track';

  function initCarousel(container) {
    // Karusel örneğinizi ayarlayın, konteynere depolayın
    if (container._carousel) return; // idempotency koruması
    container._carousel = new MyCarousel(container);
  }

  function destroyCarousel(container) {
    if (container._carousel) {
      container._carousel.destroy();
      container._carousel = null;
    }
  }

  // --- İlk sayfa yüklemesi ---
  const initialEl = document.querySelector(
    '#shopify-section-' + sectionId + ' ' + selector
  );
  if (initialEl) initCarousel(initialEl);

  // --- Editör yeniden başlatması ---
  if (Shopify.designMode) {
    function handleLoad(event) {
      if (event.detail.sectionId !== sectionId) return;
      const el = event.target.querySelector(selector);
      if (el) initCarousel(el);
    }

    function handleUnload(event) {
      if (event.detail.sectionId !== sectionId) return;
      const el = document.querySelector(
        '#shopify-section-' + sectionId + ' ' + selector
      );
      if (el) destroyCarousel(el);
      // Yığılmayacak şekilde kendi dinleyicileri kaldırın
      document.removeEventListener('shopify:section:load', handleLoad);
      document.removeEventListener('shopify:section:unload', handleUnload);
    }

    document.addEventListener('shopify:section:load', handleLoad);
    document.addEventListener('shopify:section:unload', handleUnload);
  }
})();

IIFE sarmalayıcı sectionId'yi ve her iki handler referansını aynı kapanışta tutar, böylece removeEventListener tam aynı işlev nesnesini alabilir. Bunu olmadan, bölüme yapılan her düzenleme başka bir kalıcı dinleyici ekler.

Özel bölümler için mevcut tema editörü olayları

Shopify, editörden tam bir set iptal edilemez, kabarcık olay ateşler. Blok düzenlemesine de yanıt vermesin bir karusel veya sekme bileşeni için:

OlayYükNe zaman kullanılacağı
shopify:section:load{ sectionId }Tüm bölümü yeniden başlatın.
shopify:section:unload{ sectionId }Örnekleri yok edin, dinleyicileri kaldırın.
shopify:section:select{ sectionId, load }Görünüme kaydırın, önizleme durumunu etkinleştirin.
shopify:section:deselect{ sectionId }Önizleme durumunu sıfırlayın.
shopify:block:select{ sectionId, blockId, load }Düzenlenen slayta veya sekmeye atlayın.
shopify:block:deselect{ sectionId, blockId }Varsayılan duruma geri dönün.
shopify:inspector:activate(hiçbiri)Theme Inspector kaplaması açılmıştır.
shopify:inspector:deactivate(hiçbiri)Theme Inspector kaplaması kapatılmıştır.

Sonucu Doğrulama

Değişiklikler yaptıktan sonra, her iki eksen arasında doğrulayın:

Sunucu tarafında (Liquid render zamanı):

  • Theme Inspector'u yeniden yükleyin. Bölümünüzle sayfaların toplam render zamanı 200ms'nin altında düşmelidir. Yeni Liquid mantığı ekledikten sonra regresyonu izleyin.

İstemci tarafında (LCP ve CWV):

  • CPU 4x yavaşlaması ve Fast 3G kapasitesi throttling ile Chrome DevTools Performance paneli kullanın. LCP öğesinin (Performance Insights kenar çubuğunda raporlanan) hero resminiz olduğunu, geri dönüş metin düğümü değil olduğunu onaylayın.
  • Canlı URL'de PageSpeed Insights çalıştırın. CrUX'ten alan verisi ("Gerçek kullanıcılarınızın deneyimini keşfedin" bölümü) Google sıralamasını etkileyen sayıdır, laboratuvar puanı değil.
  • Editör için, tema özelleştiricisini açın, bölümünüzü ekleyin, bir ayarı düzenleyin ve tarayıcı konsolunu yinelenen günlükler veya hatalar için inceleyin. Karusel başlatmasında yineleme yok, ayar değişikliklerinde hata yok.

Büyük katalog deposunda tam denetim akışının işlenmiş bir örneği için vaka çalışması bölümüne bakın. TTFB, CrUX ve fetchpriority gibi terimler tanımları için sözlüğün kısa açıklamaları vardır.

section.index aracılığıyla CSS ertelenmesi hakkında bir not

Resim yüklemesini kontrol eden aynı section.index dalı ayrıca kritik olmayan CSS'yi de erteleyebilir. 4. veya daha yüksek dizin bölümleri için, bölüm stil sayfasını asynchronously yüklemek (bir media özniteliği swap numarası aracılığıyla veya dinamik olarak enjekte edilen <link> aracılığıyla) render bloklama yaramaz. Shopify'ın kendi performans blogu bu kalıbı resim stratejisinin yanında belgeler. Büyük bileşen stil sayfaları (sekmeler, akordeon, tam genişlik video) içeren ancak nadir olarak başlangıç görünümü içinde olan bölümler için yapılmaya değerdir.

Sonuç

Burada ele alınan üç sorun üretimde birbirini bileştirir. Yavaş bir Liquid render TTFB'yi geciktirir, bu da tarayıcının LCP resmini keşfetme yeteneğini geciktirir. Bu resim daha sonra tembel yüklenirse, LCP üzerine başka bir ceza yığın. Ve bölümün JavaScript'i editörde asla temiz şekilde yeniden başlatılmazsa, geliştirme yavaşlanır çünkü her test tam bir sayfa yeniden yüklemesi gerektirir. Bunları sırada düzeltin: önce Theme Inspector ile denetim yapın, sonra yükleme stratejisini section.index ile ayarlayın, sonra adlandırılmış dinleyici referansları ve unload temizlemesi ile editör yaşam döngüsünü sağlamlaştırın. Her adım bağımsız olarak doğrulanabilir.

Bunu şirket içinde yapmak yerine yaptırmak isterseniz, yönettiğim stüdyo Lintel bu tür projeler için Shopify performans ve teknik SEO sunuyor.

shopifyliquidperformancetheme-developmentcore-web-vitals

Sıkça sorulan sorular

Shopify Theme Inspector nedir ve nasıl kullanırım?

Shopify Theme Inspector, sunucu tarafında Liquid render zamanlarının bir alev grafiğini render eden resmi bir Chrome uzantısıdır (Ocak 2025 itibariyle sürüm 3.0.2). Chrome Web Store'dan yükleyin, Shopify kimlik bilgilerinizle oturum açın ve mağazanızda herhangi bir sayfayı yükleyerek dosya başına ve satır başına render maliyetlerini görmek için. Toplam render zamanı için 200ms altını hedefleyin, 500ms'yi sabit tavan olarak kabul edin.

Neden özel bölümüm bir ayarı düzenledikten sonra Shopify tema editöründe kırılıyor?

Bir bölüm ayarı değiştiğinde, Shopify tüm bölüm HTML'sini yeniden render eder, bu da önceki tüm ekteki DOM olay dinleyicilerini kaldırır. shopify:section:load olayını dinlemeniz ve JavaScript başlatmanızı belirli bölüme sectionId tarafından kapsamlı olarak yeniden çalıştırmanız gerekir. Her zaman shopify:section:unload'da dinleyicileri temizleyin ve yığılmasını önleyin.

Shopify Liquid'de section.index nedir ve LCP'yi nasıl etkiler?

section.index, bölümün konumu içindeki konumunu döndüren 1 tabanlı bir tamsayıdır (template, header, footer, vb.). Bunu ilk bir veya iki bölümde loading="eager" ve fetchpriority="high" uygulamak ve 4. veya daha yüksek dizinde loading="lazy" uygulamak için kullanın. section.index'in theme.liquid'de kodlanmış olanlar yerine JSON şablonu aracılığıyla dahil edilen statik bölümler için nil döndürdüğünü unutmayın.

Yedi yıllık Shopify, tek sayfada.

Roller, projeler, teknoloji yığını ve sertifikalar özgeçmişte.

Özgeçmiş PDF indir LinkedIn