Ö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_tagfiltresi, 3. pozisyonun ötesindeki bölümlere otomatik olarakloading="lazy"uygular, bu nedenle hero'nun bunusection.indexile 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:loadbir 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:unloadiçinde silin. section.indexvesection.locationhiç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.liquiddüğü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_urldüğü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.productsdö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 fetchpriority | Notlar |
|---|---|---|---|
| 1 | eager | high | Hero veya banner. <link rel="preload"> ekleyin. |
| 2 veya 3 | eager | auto | Çoğu görünüm alanında üst kısımdan aşağıda. |
| 4 veya daha yüksek | lazy | auto | Varsayılan image_tag davranışı bunu zaten yapar. |
nil (statik bölüm) | eager veya hardcode | auto | section.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:
- Handler'ı, aynı referansı
removeEventListener'a geçebilmek için adlandırılmış bir değişkende depolayın. shopify:section:unloadiçinde kaldırma temizliğini çalıştırın; bu, bölüm değiştirilmeden hemen önce ateşlenir.- Her DOM sorgusunu
event.targetveyadocument.getElementById('shopify-section-' + event.detail.sectionId)ile kapsam içine alın, asla globaldocument'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:
| Olay | Yük | Ne 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.
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.