Varlıkları Kaydetme
Blockstudio, bloğunuz bir sayfada kullanıldığında .css, .scss ve .js ile biten tüm dosyaları otomatik olarak sıraya alır. Aşağıdaki dosya adlarından birini kullanarak varlıkların nasıl sıraya alınacağını belirleyebilirsiniz. *, istediğiniz herhangi bir dizeyle değiştirilebilen bir joker karakterdir.
Blok CSS ve SCSS dosyalarında %selector%, bloğa özgü sarmalayıcı sınıfına karşılık gelir. Böylece dosya, kapsama alınmış bir varlık olmasa bile bs_get_scoped_class() alan aynı öğeyi hedefleyebilirsiniz.
| Desen | Davranış |
|---|---|
*.(s)css |
Düzenleyicide ve ön yüzde <link> etiketi olarak sıraya alınır |
*.inline.(s)css |
İçerikler, düzenleyicide ve ön yüzde satır içi <style> etiketi içinde sıraya alınır |
*.editor.(s)css |
Yalnızca düzenleyicide <link> etiketi olarak sıraya alınır |
*.scoped.(s)css |
Kapsamlı içerikler, düzenleyicide ve ön yüzde satır içi <style> etiketi içinde sıraya alınır |
*.js |
Düzenleyicide ve ön yüzde <script> etiketi olarak sıraya alınır |
*.inline.js |
İçerikler, düzenleyicide ve ön yüzde satır içi <script> etiketi içinde sıraya alınır |
*.editor.js |
Yalnızca düzenleyicide <script> etiketi olarak sıraya alınır |
*.view.js |
Yalnızca ön yüzde <script> etiketi olarak sıraya alınır |
Not
Tireli gösterim (
*-inline.css,*-editor.cssvb.) geriye dönük uyumluluk için hâlâ desteklenir, ancak kullanımdan kaldırılmıştır. Yeni bloklarda noktalı gösterimi kullanın.
Satır İçi
Satır içi stillerin ve komut dosyalarının önemli bir avantajı, sayfanın içinde doğrudan stil veya komut dosyası etiketleri olarak oluşturulmalarıdır. Aksi halde yapılması gerekecek ek istekleri ortadan kaldırdıkları için yükleme sürelerini kısaltabilirler.
.jsdosyaları body bölümünün sonuna satır içi eklenir.(s)cssdosyaları head bölümünün sonuna satır içi eklenir- Her dosya yalnızca bir kez satır içine eklenir
Küçük Stil Sayfalarını Satır İçi Ekleme
*.(s)css dosyası varsayılan olarak bağlantı şeklinde eklenir ve dosya başına bir istek oluşturur. assets.inlineLimit ayarı bunun yerine küçük stil sayfalarını satır içine yazar; WordPress çekirdeğinin kendi stillerine uyguladığı kuralı izler: bir sayfanın harici blok stil sayfaları en küçükten en büyüğe alınır ve toplamları sınır içinde kaldığı sürece <style> olarak yazdırılır. Diğer tüm dosyalar <link> etiketini korur.
{
"assets": {
"inlineLimit": 40000
}
}
Sınır bayt cinsindendir ve varsayılan değer olan 0 bu davranışı kapatır. <link> tarafından yüklenecek derlenmiş dosyanın boyutunu ölçer; assets.minify.css açıksa dosya küçültülmüş hâliyle ölçülür. Boyuta bağlı olan tek seçim, <link> ile <style> arasındadır. Her etiket, <link> bulunacağı yerde kalır; böylece yükleme sırası ve basamaklandırma değişmez. Öğe, id değerini korur.
Ayar *.inline.(s)css ve *.scoped.(s)css dosyalarına uygulanmaz; bunlar her zaman satır içine eklenir. Düzenleyici ve yönetim varlıklarına ya da içe aktarılan JavaScript modüllerinden çıkarılan stil sayfalarına da uygulanmaz. Genel stil sayfaları, blok stil sayfaları gibi hesaba katılır. Satır içine ekleme değiştirecekse dosya bağlantı olarak kalır:
url()veya@importiçinde göreli bir URL bulunuyorsa, bağlantı olarak eklenirken stil sayfasına, satır içine eklenirken sayfaya göre çözümlenir. Mutlak yollar, tam URL’ler,data:URI’leri ve#parçaları sorun oluşturmaz.image-set()kullanıyorsa veya bir kapatma</styledizisi içeriyorsa.- CSS kaçışları, bir HTML yorum açıcı ya da bir
@charsetbildirimi içeriyorsa. Bu dosyalar, URL değerinin değişmesi veya belge ayrıştırmasının bozulması riskini almamak için temkinli biçimde bağlantı olarak kalır.
Sınırı PHP değerinden değiştirmek için ayar filtresini kullanın:
add_filter('blockstudio/settings/assets/inline_limit', fn() => 40000);
Satır içine eklenen CSS, sayfanın HTML parçası hâline gelir. Stil sayfası değiştikten sonra sayfa önbelleğinin temizlenmesi gerekir ve tarayıcı bu baytları sayfalar arasında önbelleğe alamaz; bu nedenle sınır, sayfa başına toplam boyut üzerinden belirlenir.
Kapsamlı
Kapsamlı stiller de satır içine eklenir, ancak her bloğa özgü bir kimlikle öneklenir. Sınıfı şablonunuza eklemek için bs_get_scoped_class işlevini kullanın.
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
<h1 class="hero__title">Scope me!</h1>
</section>
%selector% {
--hero-gap: var(--wp--preset--spacing--space-10);
}
%selector%.hero {
border-bottom: 1px solid currentColor;
}
.hero__title {
color: red;
}
Yukarıdaki yapı, aşağıdaki kapsamlı stili oluşturur:
<style>
.bs-62df71e6cc9a {
--hero-gap: var(--wp--preset--spacing--space-10);
}
.bs-62df71e6cc9a.hero {
border-bottom: 1px solid currentColor;
}
.bs-62df71e6cc9a .hero__title {
color: red;
}
</style>
<section class="hero bs-62df71e6cc9a">
<h1 class="hero__title">Scope me!</h1>
</section>
Kapsamlı bir dosyanın içindeki normal seçiciler, kapsamlı sarmalayıcının alt öğelerini hedeflemeye devam eder. Sarmalayıcının kendisini biçimlendirmek istediğinizde %selector% kullanın.
Genel
Bloğa özgü varlıklara ek olarak, bir blok bulunup bulunmadığına bakılmaksızın tüm sayfalarda kullanılabilen genel varlıklar da sıraya alınabilir. Genel bir varlığı sıraya almak için dosya adına global- önekini ekleyin. Herhangi bir sonek (e.g. -inline) birlikte kullanılabilir.
Olası birleşimler:
global-styles.(s)cssglobal-styles.inline.(s)cssglobal-styles.editor.(s)cssglobal-styles.scoped.(s)cssglobal-scripts.jsglobal-scripts.inline.jsglobal-scripts.editor.jsglobal-scripts.view.js
Yönetici
Yönetici varlıkları yalnızca WordPress yönetim alanında sıraya alınır. Yönetici varlıklarını tanımlamak için admin- öneki kullanılır.
admin-styles.(s)cssadmin-scripts.js
Blok Düzenleyicisi
Blok düzenleyicisi varlıkları yalnızca blok düzenleyicisinde sıraya alınır. Blok düzenleyicisi varlıklarını tanımlamak için block-editor- öneki kullanılır.
block-editor-styles.(s)cssblock-editor-scripts.js
Not
WordPress, istemci taraflı bir blok
apiVersiondeğerinden düşük bir değerle kaydedildiği için düzenleyici iframe’ini devre dışı bırakırsa, düzenleyici tuvali ile WordPress yönetim arayüzü aynı belgeyi paylaşır.window,document,body, tekerlek olaylarına veya belge kaydırmasına bağlanan genel ya da düzenleyici komut dosyaları,body.block-editor-pagedurumuna karşı önlem almalı veya.interface-complementary-areave.interface-navigable-regiongibi WordPress düzenleyici bölgelerini kapsam dışında bırakmalıdır.
Yükleme Sırası
Ön yüzde, otomatik varlık sıraya alma ve çıktı tamponlama etkinleştirildiğinde,
Blockstudio blok CSS <link> ve <style> etiketlerini kaydedip wp_enqueue_style() ile eklemek yerine, tamponlanan sayfaya kapanış </head> etiketinden hemen önce ekler. Bu nedenle blok CSS, wp_enqueue_style() ile sıraya alınan tema ve eklenti stilleri de dahil olmak üzere, WordPress tarafından head bölümünde zaten yazdırılmış stil sayfalarından sonra gelir; bunun için sıraya alma önceliği veya bağımlılıkları önem taşımaz. Yönetici ve block-editor- varlıkları bunun yerine WordPress’ın sıraya alma sistemini kullanır.
Önem derecesi, basamak katmanı ve özgüllüğü aynı olan kurallarda blok stil sayfası tema stil sayfasına üstün gelir. Bunu değiştirmek için tema kuralının özgüllüğünü artırın veya temanın stil sayfasını blockstudio/render/head filtresiyle Blockstudio tarafından oluşturulan head bölümüne ekleyin. Filtrenin eklediği içerik blok varlıklarından sonra yerleştirilir. Stil sayfasının iki kez yüklenmemesi için WordPress içindeki sıradan da çıkarın.
add_action('wp_enqueue_scripts', function() {
wp_dequeue_style('theme-overrides');
}, 100);
add_filter('blockstudio/render/head', function($head) {
return $head . '<link rel="stylesheet" href="' . esc_url(get_theme_file_uri('overrides.css')) . '">';
});
head filtresi yalnızca Blockstudio sayfayı arabelleğe aldığında çalışır. Customizer önizlemesinde ve blockstudio/buffer/enabled, false döndürdüğünde arabelleğe alma kapalıdır. bs_is_buffering() hangi durumda olduğunuzu bildirir; böylece tema, sayfa arabelleğe alındığında filtre üzerinden stil sayfasını ekleyebilir, aksi durumda ise WordPress ile kuyruğa alabilir. Yanıt, wp_enqueue_scripts itibarıyla kullanılabilir olur ve template_redirect öncesinde false olur.
add_action('wp_enqueue_scripts', function() {
$url = get_theme_file_uri('overrides.css');
if (bs_is_buffering()) {
add_filter('blockstudio/render/head', function($head) use ($url) {
return $head . '<link rel="stylesheet" href="' . esc_url($url) . '">';
});
return;
}
wp_enqueue_style('theme-overrides', $url);
});
Son belgeyi farklı bir şekilde yeniden düzenlemeniz gerekiyorsa blockstudio/buffer/output kullanın.
Sıraya Almayı Devre Dışı Bırakma
Otomatik varlık sıraya alma, assets/enqueue ayarı kullanılarak devre dışı bırakılabilir. Tüm varlıkları sıraya alma işlemini kendiniz yönetmek istiyorsanız bu kullanışlıdır.
add_filter('blockstudio/settings', function($settings) {
$settings['assets']['enqueue'] = false;
return $settings;
});
Blok Başına
Bir blok şablonu hiçbir şey döndürmediğinde Blockstudio o blok için hiçbir varlığı sıraya almaz. Belirli bir koşul karşılandığında sıraya almayı devre dışı bırakmak için bu yöntem kullanışlıdır.
PHP
<?php
if ( !$a['slides'] ) {
// or return '';
return false;
}
?>
<div>my slider</div>
Twig
{% if not a.slides %}
<div>my slider</div>
{% endif %}