CSS ve varlıklar

Modül JS/CSS dosyaları#

Dosyaları Resources/assets/ altına koyun ve Resources/config/importmap.php ile tanıtın:

return [
    'ornek' => ['path' => 'Resources/assets/ornek.js', 'entrypoint' => true],
    'ornek-css' => ['path' => 'Resources/assets/ornek.css', 'type' => 'css', 'entrypoint' => true],
];

Şablonda: {{ importmap(['ornek-css', 'ornek']) }}. Modül etkin değilse ya da dosya yoksa kayıt sessizce atlanır.

Yerel kütüphaneler#

Dışarıdan (CDN) betik çağrılmaz. Kütüphaneyi Resources/assets/vendor/ içine koyun ve JS'ten göreli içe aktarın:

import hljs from './vendor/highlight.esm.min.js';

• ES modülü sürümünü tercih edin. UMD paketleri (self kullananlar) yan etki olarak içe aktarılabilir ve genelde self.<ad> altında yaşar.
• Kütüphane lisansını (MIT, BSD…) dosya başlığında koruyun.

Tailwind ve modül sınıfları#

Çekirdek stil dosyası Tailwind ile derleme sırasında üretilir ve şablonları tarar. Modülünüzün Tailwind sınıfları kullanması için:

• Şablonlar Resources/views/**/*.twig altında olmalıdır (tarama yolu budur).
• Yerel geliştirmede şablon değiştirince tailwind:build --minify ve asset-map:compile çalıştırın; public/assets eski kalırsa yeni sınıflar görünmez.
• Yayın betiği git'e girmeyen modüllerin şablonlarını da tarar; yine de modülün kendi görünümü için düz CSS dosyası kullanmak (örn. belge modülü) çekirdek stilinden bağımsızlık sağlar.

CSP#

Satır içi <script> ve <style> için csp_nonce_attr() kullanın.