İçeriğe geç
Doğrulandı

Xuda Slim

Xuda çalışma zamanına hafif tarayıcı giriş noktası; proje yükleyicisi gerekmez.

Xuda Slim, Xuda çalışma zamanı için hafif bir yazım ve gömme yüzeyidir. Xuda'nın reaktif veri kaynağını, yönergelerini, olaylarını ve yapısal etiketlerini, tam Xuda CLI proje yapısıyla başlamadan kullanmak istediğinizde işe yarar.

Slim hâlâ Xuda'dır, farklı bir çalışma zamanı değildir. İfadeler alanları hâlâ @field_name ile okur, çalışma zamanı hâlâ Xuda program belgeleriyle çalışır ve xu-single-view ile xu-panel gibi yapısal etiketler hâlâ önemlidir. <template> desteklenir, ancak zorunlu değildir.

Slim ne için kullanılır

  • Xuda reaktifliğiyle elle yazılmış HTML sayfaları
  • çalışma zamanı demoları ve dokümantasyon
  • gömülebilir pencere öğeleri veya mikro siteler
  • üretilmiş project_data çalışma zamanı ağaçları
  • önce tam bir kaynak derleyicisi getirmeden Xuda'yı kademeli olarak benimsemek

Üç yazım modu

Bu modlar karıştırılabilir: Slim project_data alırsa ve sayfada <template> etiketleri de varsa, şablonlar ayrıştırılır ve onunla birlikte project_data.programs içine eklenir.

Çalışma zamanını yükleme

Paketi almanın desteklenen yolu, herkese açık npm paketi @xuda.io/xuda-runtime-slim-es paketidir. Dağıtılmış bir Xuda uygulamanız varsa platform, çalışma zamanı paketini kendi uygulama alan adınızdan /cdn altında, küçültülmemiş yapıyı da /cdn/debug altında sunar.

html
<script src="https://xuda.ai/dist/runtime/js/xuda-runtime-slim.js"></script>
Üretimde bir geliştirme sunucusundan yüklemeyin

Yukarıdaki script etiketi bir geliştirme sunucusunu gösterir ve Slim'i yerelde denemek için yararlıdır. Dağıtılmış bir sayfa @xuda.io/xuda-runtime-slim-es paketini yüklemeli ya da paketi kendi uygulama alan adınızdan /cdn altında sunmalıdır.

Kurucu

js
new xuda(element?, options?, callback?)
new xuda.xuda(element?, options?, callback?)

Bağımsız değişkenler konuma göre değil türe göre eşleştirilir: bir öğe, bir seçenekler nesnesi ve bir geri çağırma herhangi bir sırayla verilebilir.

  • element: bağlanılacak DOM öğesi. Slim'de isteğe bağlıdır: atlarsanız çalışma zamanı başarısız olmak yerine document.body öğesine geri döner ve bir uyarı günlüğe yazar.
  • options: aşağıda ele alınan oturum ve çalışma zamanı seçenekleri.
  • callback: uygulama hazır olduğunda callback('xuda_ready', SESSION_ID, SESSION_OBJ) olarak çağrılır.

Bağlamanın tamamlanması için en güvenilir kanca, document.body üzerindeki on_mounted olayıdır:

js
document.body.addEventListener('on_mounted', () => {
  console.log('Slim page mounted');
}, { once: true });

Yaygın seçenekler

Aşağıdaki her seçenek aynı altı adımlı zincirle çözülür: önce bir URL sorgu parametresi, sonra kök öğedeki bir öznitelik, sonra options.params[key], sonra options[key], sonra bir çerez, sonra localStorage. Bir Slim sayfasının, kodda değişiklik yapmadan bir sorgu dizesinden yeniden yapılandırılabilmesinin nedeni budur.

Slim'in çalıştığını nasıl anlarsınız

  • paket yüklendi
  • prog_id değeriniz görünür bir şey oluşturuyor
  • on_mounted olayı tetikleniyor
  • alan odaklı arayüz güncellemeleri reaktif davranmaya başlıyor

Dördü de gerçekleşiyorsa sayfa iyi durumdadır. Hiçbir şey görüntülenmiyorsa sırayla şunları kontrol edin: paket gerçekten yüklendi mi, prog_id gerçek bir şablon kimliği veya program anahtarıyla eşleşiyor mu, program project_data.programs içinde var mı ve bağlama hedefi gerçek bir öğe mi (ya da bilerek body geri dönüşüne bırakıldı mı).