Varlıkları İşleme
Küçültme
Blockstudio, bir bloktaki tüm CSS ve JS dosyalarını otomatik olarak küçültebilir.
Derlenen dosyalar bloğun _dist klasörüne kaydedilir ve blok kullanıldığında sıraya alınır. Kaynak dosya güncellendiğinde Blockstudio, bu zaman damgasına sahip derlenmiş bir dosyanın bulunup bulunmadığını kontrol eder; yoksa dosyayı oluşturur.
Bu amaçla minify kitaplığı kullanılır.
Küçültme, assets/minify ayarı kullanılarak etkinleştirilebilir:
add_filter('blockstudio/settings/assets/minify/css', function() {
return true;
});
add_filter('blockstudio/settings/assets/minify/js', function() {
return true;
});
SCSS
Stillerinizi SCSS ile yazmayı tercih ediyorsanız SCSS işlemeyi etkinleştirebilirsiniz:
add_filter('blockstudio/settings/assets/process/scss', function() {
return true;
});
Bu, .css dosyaları için SCSS işlemeyi etkinleştirir.
Alternatif olarak .scss uzantısını kullanabilirsiniz; böylece yukarıdaki ayar true olmasa bile stiller otomatik olarak işlenir.
İçe Aktarma Yolları
SCSS kullanırken başka SCSS dosyalarını içe aktarmak mümkündür. İçe aktarımlar, içe aktarıldıkları dosyaya göreli olarak çözümlenir.
@import "modules.scss";
Ayrıca blockstudio/assets/process/scss/import_paths filtresiyle özel içe aktarma yolları tanımlanabilir; böylece klasör yapısı belirtmeden diğer dizinlerdeki dosyalar içe aktarılabilir.
İçe aktarımlarda .scss uzantısı atlanabilir; _tokens.scss gibi kısmi dosyalar veya bir dizinin _index.scss dosyası çözümlenebilir.
add_filter('blockstudio/assets/process/scss/import_paths', function($paths) {
$paths[] = get_template_directory() . '/scss';
return $paths;
});
Ön Kod
Paylaşılan Sass işlevlerinin, değişkenlerinin, mixin’lerinin veya yardımcı araçlarının her SCSS dosyasında kullanılabilir olmasını istiyorsanız derlemeden önce genel bir ön kod ekleyebilirsiniz.
Bu, her blok varlığında içe aktarımları tekrarlamadan kesme noktaları gibi paylaşılan mixin’lere erişmek isteyebileceğiniz Bootstrap gibi çatılar için kullanışlıdır.
add_filter('blockstudio/assets/process/scss/prelude', function($prelude, $path, $scss) {
return '@import "functions";' . "\n"
. '@import "variables";' . "\n"
. '@import "mixins";';
}, 10, 3);
blockstudio/assets/process/scss/import_paths ile birlikte kullanıldığında, başvurulan Sass yüzeyi her derlenmiş dosyada kullanılabilir hale gelir.
Bir bağımlılığın değiştirilme zamanı değiştiğinde blok varlıkları yeniden derlenir; buna başka kısmi dosyaların içe aktardığı dosyalar da dahildir. Blockstudio, ön kod bağımlılıkları ve yapılandırılmış içe aktarma yolları dahil, yerel @import, @use ve @forward bağımlılıklarını izler. Paylaşılan bağımlılıklar bir kez izlenir ve keşif sırasında döngüler oluşmaz. Bu dosyalar çalışma zamanı önbelleğinin izleme listesine de eklenir.
Örneğin scss/_wysiwyg.scss mixin’ini içe aktaran mixins/_wysiwyg.scss düzenlendiğinde global-styles.scss yeniden derlenir. Değişiklikler giriş dosyasına dokunmayı gerektirmez. Sass yerleşik modülleri ve uzak içe aktarımlar yerel bağımlılık grafiğinin dışında tutulur.
ES Modülleri
Blockstudio içindeki tüm komut dosyaları (satır içi ve varsayılan), varsayılan olarak type="module" uygulanmış şekilde yüklenir. Bu sayede bloklarınızın komut dosyalarında ek kurulum yapmadan import sözdizimini kullanabilirsiniz.
Not
ES modüllerini daha ayrıntılı incelemek için MDN web belgelerini ziyaret edin.
Bir script.js içindeki aşağıdaki kodu düşünelim:
import { h, render } from "https://esm.sh/preact@10.15.1";
import htm from "https://esm.sh/htm@3.1.1";
import confetti from "https://esm.sh/canvas-confetti@1.6.0";
const html = htm.bind(h);
function App(props) {
confetti();
return html`<h1>Hello ${props.name}!</h1>`;
}
render(
html`<${App} name="Hello from Preact!" />`,
document.querySelector("#element")
);
Yukarıdaki örnek, Preact kullanarak bir bileşen oluşturur ve gerekli tüm bileşenleri ve işlevleri ESM uyumlu bir CDN üzerinden içe aktarır; bu örnekte esm.sh kullanılır. Bu yaklaşımda yanlış bir şey yoktur, ancak gerekli varlıkların harici bir siteden istenmesi gerekir ve CDN çalışmazsa komut dosyaları bozulabilir.
Blockstudio, ES modüllerini bloğa indirmek için kullanışlı bir yöntem sunar; böylece üretimde harici ESM CDN’lerine ihtiyaç kalmaz.
Kurulum
Bir modülü blok dizininize indirmek için npm: önekini, ardından paket adını ve sürümünü kullanın:
import { h, render } from "npm:preact@10.15.1";
import htm from "npm:htm@3.1.1";
import confetti from "npm:canvas-confetti@1.6.0";
Bu sözdizimi, Deno’ın npmspecifier kuralıyla uyumludur.
Not
Eski
blockstudio/öneki (e.g.,blockstudio/preact@10.15.1), geriye dönük uyumluluk için hâlâ desteklenir; ancak yeni projelerdenpm:önekinin kullanılmasını öneririz. Ayrıntılar için geçiş kılavuzuna bakın.
Blockstudio, değiştirilen .js dosyalarını içe aktarımlar açısından otomatik olarak kontrol eder ve bunları yerel blok dizinine indirir. İndirilen dosyalar blok dizinindeki modules klasörüne yerleştirilir.
Komut dosyası dosyası, yerel olarak barındırılan modüle uyum sağlaması için kaydedildiğinde yeniden yazılır:
import { h, render } from "./modules/preact/10.15.1.js";
import htm from "./modules/htm/10.15.1.js";
import confetti from "./modules/canvas-confetti/1.6.0.js";
Düzenleyicinin içindeyken bloğu önizler ve üzerinde çalışırken yine CDN URL’si kullanılır (Blockstudio, esm.sh kullanıyor).
Dikkat Edilmesi Gerekenler
Sürüm
Normalde modüller, sürüm numarası olmadan CDN’lerden kullanılabilir. Bu durumda her zaman en yeni sürüm kullanılır. Blockstudio veritabanına herhangi bir bilgi kaydetmediğinden, modülleri kullanırken sürüm numarası gerekir.
Aynı Modüller
Modüller kendi blokları kapsamında kullanılır. Aynı modülü aynı sürüm numarasıyla birden fazla blokta kullansanız bile Blockstudio istenen modülü her blok için indirmeye devam eder. Bunun temel nedeni, blokların başka kurulumlar veya siteler arasında kolayca paylaşılabilen bağımsız birimler olması gerektiğidir.
Buna ek olarak, her iki blok da bir sayfadaysa aynı modül iki kez istenir. Bu sorun script.js dosyası yerine script-inline.js kullanılarak çözülebilir. Blockstudio, ad ve sürüm numarası aynı olduğunda içe aktarımların her birini modülün ilk bulunduğu konuma yönlendirir.
CSS Yükleyicisi
Yukarıdakiyle aynı sözdizimini kullanarak CSS dosyalarını da içe aktarmak mümkündür.
import "npm:swiper@11.0.0/swiper.min.css";
CSS dosyası modules klasörüne indirilir ve blok kullanıldığında otomatik olarak sıraya alınır. Sürüm aynı olduğu sürece, CSS dosyası birden fazla blokta bulunsa bile yalnızca tek bir sürümü sıraya alınır.