İçeriğe geç
Doğrulandı

@xuda/core

Platformun, derleyicinin ve demo uygulamalarının üzerine bağlandığı, bağımlılığı olmayan reaktif motor.

@xuda/core, Xuda reaktif motorudur (sinyaller, zamanlayıcı, anahtarlı liste farkı, reaktif oluşturucu, yönlendirici); bağımlılığı olmayan bir ESM paketi olarak sunulur. İçe aktarıldığında hiçbir genel değişken okumaz ya da yazmaz: func yok, SESSION_OBJ yok, window yok, document yok.

Dokümanların bu bölümündeki tek herkese açık paket

@xuda/core'un package.json dosyası "private": false taşır. Bu bölümde ele alınan üç paket (@xuda/compiler ve @xuda/vite-plugin-xu ile birlikte, ikisi de private: true) arasında bu depo dışında bağımlılık olarak kullanılmak üzere oluşturulmuş tek pakettir.

Ayrıca platformun zaten gönderdiği motordan ayrı bir motor değildir: paketin kendi build:globals betiği (esbuild src/globals.js --bundle ... --outfile ../../runtime/js/xuda_core.globals.js), platformun kendi gönderdiği reaktif oluşturucu paketi olan runtime/js/xuda_core.globals.js dosyasının nasıl oluşturulduğudur.

Reaktif yüzey

js
import { ref, reactive, computed, effect, watch, effectScope } from '@xuda/core';

Hepsinin altında tek bir bağımlılık grafiği, tek bir sahip ağacı, tek bir toplu işlem arabelleği ve tek bir zamanlayıcı vardır: bir effect() içinde okunan bir ref, bir watch() içinde okunan bir sinyalle aynı şekilde onu izler ve yeniden çalıştırır. Buradaki computed, bir getter ya da yazılabilir bir computed için bir { get, set } çifti kabul eder.

js
const state = reactive({ count: 0 });
state.count++;             // no .get(), no .set()

const n = ref(0);
n.value++;

effectScope(), "bunu kim yok eder" sorusunu yanıtlar: bir dizi yok edici elle toplamak yerine, elden ele verebileceğiniz, iç içe geçirebileceğiniz ve tek çağrıyla durdurabileceğiniz adlandırılmış bir sahip.

js
const scope = effectScope();
scope.run(() => {
  effect(() => { /* ... */ });
  watch(source, callback);
  onScopeDispose(() => io.disconnect());
});
scope.stop();

createApp() ile örneklenen bir bileşen bunlardan birine zaten sahiptir: <script> bileşenin kendi ayrılmış kapsamı içinde çalışır; bu yüzden orada yazılan bir efekt, bileşen bağlantısı kesildiğinde otomatik olarak yok edilir.

Düşük düzeyli ilkel

signal(initial) (.get(), .set(), .peek(), .notify(), .subscribe()) ve signalComputed, ref ile computed altındaki motorun kendi hücreleridir. Dışa aktarılırlar ve tamamen desteklenirler, kaldırılmadılar; çünkü oluşturucu ve eski köprü bunların üzerine kuruludur ve değer değişikliği olmadan abonelerin yeniden çalıştırılması olan signal.notify()'nin bir ref karşılığı yoktur. Uygulama kodu bunun yerine ref ve computed kullanmalıdır; bu iki ad bir alt katman olarak belgelenir, çalışma zamanında kullanımdan kaldırılmış değildir (signal() üzerinde bir uyarı, o katmanda tam olarak doğru şeyi yapan kod için satır kapsamı başına ve panel parametresi başına, ekran başına binlerce kez tetiklenirdi).

Uygulama giriş noktası

js
import { createApp } from '@xuda/core';
import App from './App.xu';

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

App, @xuda/compiler veya vite-plugin-xu derleme adımı tarafından üretilen derlenmiş bir .xu modülüdür. createApp, oluşturucunun ihtiyaç duyduğu yedi enjekte bağımlılığı, modülün setup() fonksiyonunun döndürdüğü thunk tablosu üzerinde kurar, oluşturucuyu yaratır ve bileşen ağacını bağlar. İkinci bir oluşturucu değildir: derlenmiş yol ile yorumlanan platform yolu render.js dosyasını paylaşır.

examples/hello, bunun somut, test edilmiş sürümüdür: bir sayaç, bir koşul ve anahtarlı bir liste içeren derlenmiş bir App.xu üzerinde createApp(App).mount('#app').

Bağımlılık enjekte edilen oluşturucu

js
import { create_renderer } from '@xuda/core';
import { reactive } from '@xuda/core/reactivity';

create_renderer(deps) DOM'dan bağımsızdır. Ortama ait her şey tek bir deps nesnesiyle gelir ve en küçük dürüst ana makinenin tam olarak yedisine ihtiyacı vardır: document (createElement / createTextNode / createComment), evaluate (izlenen, eşzamanlı bir ifade değerlendirici), cast_bool (xu-render / xu-if için doğruluk), resolve_rows (xu-for için izlenen bir satır dizisi çözümleyici), row_key (kararlı satır kimliği), write_field (xu-bind yazmaları) ve dispatch_event (xu-on:* işleyicileri). packages/core/demo, bunu düz bir reactive({...}) nesnesi üzerinde tam olarak böyle kurar; altında hiçbir yerde SESSION_OBJ, veri kaynağı katmanı ya da eski köprü yoktur.

Kendi bağdaştırıcınızı yazarsanız iki sessiz DOM sözleşmesi tuzağı

nodeType değeri olmayan bir deps.document düğümü gerçek bir DOM düğümü yerine jQuery nesnesi olarak okunur; bu, hiçbir hata atılmadan her satırı öncekinin içine yerleştirebilir. remove() olmayan bir düğüm, bırakılan bir satırı sessizce reddedilen bir promise'e çevirir: liste güncellenmeyi bırakır ve hiçbir şey günlüğe yazılmaz. Demodaki create_adapter, düğüm oluşturma sırasında hata atarak ikisini de korur; korumanın neden var olduğunu anladıktan sonra vazgeçmek için { guard: false } verin.

Tanılama ve whenElement

onDiagnostic, getDiagnostics, diagnosticCount ve resetDiagnostics, motorun sessiz vazgeçişlerini dağınık console.error çağrıları yerine tek bir gözlemlenebilir kanala dönüştürür; böylece bir ana makine bağdaştırıcısı ya da bir test bunlara kodla abone olabilir. whenElement, bir düğüm var olduğunda bir geri çağırma çalıştırır: bir kez sorar, sonra zamanlayıcının commit aşamasında (DOM'un tam olarak yerleştiği, boyamadan önceki an) yeniden sorar ve yirmi yerleşik oluşturmadan sonra hâlâ karşılanmayan bir bekleme, sessizce vazgeçmek yerine kendini adıyla bildirir.

Yönlendirici

createRouter, createWebHistory, createWebHashHistory, createMemoryHistory, useRouter ve useRoute aynı paketten gelir. Geçerli rota @xuda/core'un kendi reactive nesnesidir ve geçmiş platformdan gelir; bu yüzden kullanmak kendine ait bir bağımlılık eklemez.

Paket dışa aktarımları

Node 18 veya daha yenisi, bildirilen motor alt sınırıdır.