İçeriğe geç
Taslak

vite-plugin-xu

Bir .xu tek dosyalı bileşenini gerçek bir ES modülüne derleyen, derleme zamanı Vite eklentisi.

@xuda/vite-plugin-xu, .xu tek dosyalı bileşenlerini derleme zamanında ES modüllerine derler ve geliştirme sırasında bunları tam bileşen yeniden yükleme düzeyinde sıcak yeniler.

Bugün bir çalışma alanı paketi, npm kurulumu değil

@xuda/vite-plugin-xu ve bağlı olduğu @xuda/compiler paketi, package.json dosyalarında "private": true taşır. xuda-cli, create-xuda-cli ve @xuda/core'un aksine, ikisi de henüz npm'de yayımlanmamıştır. Bu depodaki tek çalışan tüketici olan examples/hello, ona bir file: bağımlılığı olarak ulaşır: "@xuda/vite-plugin-xu": "file:../../packages/vite-plugin-xu".

Kurulum

js
// vite.config.js
import { defineConfig } from 'vite';
import xu from '@xuda/vite-plugin-xu';

export default defineConfig({ plugins: [xu()] });
js
// src/main.js
import { createApp } from '@xuda/core';
import App from './App.xu';

createApp(App).mount('#app');

examples/hello, bu şekilde oluşturulmuş eksiksiz çalışan bir projedir: bir sayaç, koşullu bir bağlama ve anahtarlı bir liste; bileşenin kendisinde hiçbir sinyal, .value ya da veri kaynağı katmanı görünmeden, yalnızca düz fonksiyonlar ve bir reactive() deposu üzerinde düz değiştirmeyle yönlendirilir.

Eklenti mekanik olarak nedir

Tek bir transform kancası. Vite'in varsayılan load adımı dosyayı zaten okuduğu için kanca .xu kaynağını metin olarak alır, @xuda/compiler derleyicisini çağırır ve üretilen modülü döndürür. Özel bir çözümleyici ve sanal bir modül yoktur: .xu gerçek bir yola sahip gerçek bir dosya olarak kalır; bu da yığın izlerini ve HMR grafiğini dürüst tutar.

enforce: 'pre' önemlidir: onsuz vite:esbuild dosyaya önce ulaşabilir ve <template> üzerinde başarısız olabilir; bu, işlem hattı sırasının yanlış olması yerine dosyanın bozuk olduğu izlenimini verir. Vite ayrıca JS olmayan içe aktarmalara ?import (ve bir HMR yeniden isteğinde ?t=…) ekler; eklenti bunu dahil etme testinden önce ayıklar, yoksa dosya sessizce derlenmez ve tarayıcı, yazarın hiç yazmadığı bir dosyada sözdizimi hatası bildirir.

HMR

Uygulanan düzey tam bileşen yeniden yüklemesidir: düzenlemede modül yeniden yürütülür, o bileşenin bağlı her örneği yeni modülden bağlantısını koparıp yeniden bağlanır ve bileşen durumu sıfırlanır. <script> içindeki bir reactive({ count: 0 }) yeniden 0 olur. Durumu korumak bilerek denenmez, çünkü <script> düzenlendikten sonra eski reaktif nesnenin hangi yarısının hâlâ aynı anlama geldiğini bilmenin güvenilir bir yolu yoktur.

Sunma modunda eklenti bir import.meta.hot.accept alt bilgisi ekler. __XUDA_HMR__, bir uygulama ilk kez bağlandığında @xuda/core içindeki createApp tarafından kurulur; bu yüzden eklenti kullanıcı koduna asla bir içe aktarma eklemez. Hiçbir bağlı uygulama güncellenen bileşeni üstlenmiyorsa (kimse onu göstermiyordu ya da sayfa henüz açılmadı), güncelleme sessizce hiçbir şey yapmamak yerine tam sayfa yeniden yüklemesine döner. Üretim derlemesi hiç HMR alt bilgisi almaz.

Seçenekler

xuda-cli'nin derlediği blok tabanlı lehçe için ve bu derleyicinin lehçesinin ondan nasıl farklı olduğunu anlatan not için .xu dili sayfasına bakın.