İçeriğe geç

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.css vb.) 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.

  • .js dosyaları body bölümünün sonuna satır içi eklenir
  • .(s)css dosyaları 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.

JSON
{
  "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 @import iç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 </style dizisi içeriyorsa.
  • CSS kaçışları, bir HTML yorum açıcı ya da bir @charset bildirimi 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:

PHP
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.

PHP
<section class="hero <?php echo bs_get_scoped_class($b['name']); ?>">
  <h1 class="hero__title">Scope me!</h1>
</section>
CSS
%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:

HTML
<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)css
  • global-styles.inline.(s)css
  • global-styles.editor.(s)css
  • global-styles.scoped.(s)css
  • global-scripts.js
  • global-scripts.inline.js
  • global-scripts.editor.js
  • global-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)css
  • admin-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)css
  • block-editor-scripts.js

Not

WordPress, istemci taraflı bir blok apiVersion değ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-page durumuna karşı önlem almalı veya .interface-complementary-area ve .interface-navigable-region gibi 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.

PHP
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.

PHP
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.

PHP
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
<?php
  if ( !$a['slides'] ) {
    // or return '';
    return false;
  }
?>

<div>my slider</div>

Twig

Twig
{% if not a.slides %}
  <div>my slider</div>
{% endif %}