İçeriğe geç
Doğrulandı

Bileşen

Arayüzün birimi: yerel duruma, verilere ve onları birbirine bağlayan iş akışı mantığına bağlı bir öğe ağacı.

Bileşen bir arayüz birimidir: yerel duruma, isteğe bağlı verilere, yaşam döngüsü mantığına ve bir girdi ile çıktı arayüzüne bağlı bir öğe ağacı. Bir sayfa, bir kart, bir modal, bir açılır pencere, satır içi bir parça: hepsi Bileşendir ve platformun en zengin belge türüdür; diğer tüm program türleriyle paylaşılan alanların, olayların ve veri kaynağının yanında kendi arayüz ağacını da taşır.

Özellikler

renderType eski bir bayraktır, canlı bir özellik değil

renderType (form / grid / list) kullanımdan kaldırılmıştır ve artık gerekli değildir; yeni bileşenler onsuz oluşturulur. Yeni bir Bileşenin gerçekte aldığı şey bir iskele seçimidir, single veya multi, Yeni Bileşen penceresinde bir kez seçilir: single, doğrudan içinde çalışmaya hazır boş bir xu-template kökü ekler; multi, aynı xu-template kökünü, içine yerleştirilmiş bir yükleme div'i ve bir xu-multi-view ile ekler. xu-single-view hâlâ gerçek ve yazılabilir bir etikettir, yalnızca fabrikanın sizin için yerleştirdiği bir etiket değildir: yalnızca taşınmamış eski bir belge (kökü henüz xu-template olmayan), eski renderType değeri hâlâ form diyorsa buna karşı denetlenir.

progUi, öğe ağacı

Kök düğüm her zaman şeffaf bir xu-template'tir ve create_prog'un scaffold_prog_ui işlevi tarafından eklenir. multi iskelesini seçmek, sizin için içine bir yükleme div'i ve bir xu-multi-view yerleştirir; single iskelesi onu boş bırakır, doğrudan children içinde oluşturun. Her düğümün benzersiz bir id, type: "element", bir tagName ve boş olsa bile attributes: {} ile children: [] değerlerine ihtiyacı vardır.

Düz HTML etiketlerinin yanı sıra bir avuç xuda etiketi doğrudan yazılır: xu-template, xu-single-view, xu-multi-view, xu-panel, xu-teleport, xu-slot.

Büyük harfle başlayan bir tagName (Button, Dialog) her zaman derlenmiş bir tasarım sistemi bileşeni olarak ele alınır, asla bir HTML öğesi olarak değil; bir yazım hatası olsa bile. Bağlanırken etiketi ve denenen tüm kaynakları adlandırarak hata verir. Düz öznitelikleri DOM öznitelikleri değil props olur (variant, color, class hepsi props.<name> olarak gelir) ve xu-panel'den farklı olarak çıkış parametresi yoktur; bir bileşen etiketi yalnızca ona geçirdiğinizi okur.

Dinamik davranış: xu-* öznitelikleri

Bir Bileşenin öğe ağacının taşıyabileceği her xu-* özniteliği:

İkisi kolayca karıştırılır: xu-bind çıplak alan kimliğini alır, @ olmadan; bu, başka her yerdeki @ kuralının tek istisnasıdır. xu-exp:class ise statik class özniteliğinin yerini tamamen alır, bu yüzden yerleşim sınıflarını ifadenin içinde yinelemeniz gerekir.

progFields, progEvents, progDataSource

Yerel durum (progFields, virtual veya table'a bağlı), isteğe bağlı gömülü bir Veri kaynağı ve yaşam döngüsü olayları. Bu olaylardan üçü işi kolayca karıştırılabilecek şekilde bölüşür:

Yenileme işini screen_ready içine koymak, oluşturma mantığını hâlâ var olan DOM üzerinde yeniden çalıştırır ve ilkinin üstüne ikinci bir widget yığar.

Başka bir programı gömme: xu-panel

xu-panel (küçük harfli tagName, program özniteliği), büyük harfli bir tasarım sistemi etiketinin aksine, başka bir Bileşen programını kendi alanları, veri kaynağı ve olaylarıyla bağlar. _in parametrelerine değerleri xu-exp:<param> öznitelikleriyle geçirin; bir tasarım sistemi etiketinden farklı olarak bir panel, _out parametreleri üzerinden değerleri sizin alanlarınıza geri yazabilir.

json
{ "id": "ui-…", "type": "element", "tagName": "xu-panel", "attributes": { "program": "392_cmp_child…", "xu-exp:order_id_in": "@selected_order_v" } }

Çalışan örnek

Biçimi seçin

Tek bir kayıt için Yeni Bileşen penceresinde single seçin: doğrudan xu-template kökünün içinde oluşturun. Bir liste için multi seçin: o kökün içine sizin için bir xu-multi-view ekler, tekrarlanan düğüme xu-for (veya .xu içindeki for= kısayolu) ekleyin.

Veriyi bağlayın

Girdiler için xu-bind, hesaplanan metin için xu-exp:xu-content, bileşen kendi okumasına sahipse bir progDataSource.

Etkileşimi bağlayın

Bir iş akışıyla xu-on:click veya .xu içinde @click ile başvurulan adlandırılmış bir eylem bloğu.

Ağacı tuval üzerinde oluşturun: öğeleri sürükleyin, öznitelikleri özellikler panelinde ayarlayın, xu-on:* işleyicilerini iş akışı düzenleyicisinde iş akışı adımlarına bağlayın. Sonucu canlı denetlemek için önizleme oynat düğmesine basın.

xml
<meta lang="json5">
{
  id: "user_profile_card",
  menuTitle: "User Profile Card",
  uiFramework: "@xuda.io/xuda-framework-plugin-tailwind"
}
</meta>

<params lang="json5">
{
  in: { user_name_in: "string", user_role_in: "string" }
}
</params>

<template>
  <single-view>
    <aside class="user-card">
      <div class="avatar" :content="(@user_name_in || 'A').substring(0, 1)"></div>
      <h3 :content="@user_name_in"></h3>
      <p :content="@user_role_in"></p>
    </aside>
  </single-view>
</template>

<style>
.user-card { display: grid; gap: 0.75rem; padding: 1rem; border-radius: 1.2rem; }
</style>

.xu, <single-view> etiketini xu-single-view'a, :content özniteliğini bir xu-exp:xu-content ifadesine ve çıplak bir for="@list_v" özniteliğini xu-for'a derler.

json
{
  "properties": { "menuType": "component", "menuName": "Student Card", "rwMode": "U", "allowCreate": false },
  "progUi": [
    { "id": "root", "type": "element", "tagName": "xu-template", "attributes": {}, "children": [] }
  ],
  "progFields": [
    { "id": "b2c3d4e5-…", "data": { "field_id": "STU_Student_Id", "type": "table" }, "props": { "fieldType": "string" } }
  ],
  "progEvents": [
    { "id": "d4e5f6a7-…", "data": { "type": "on_load", "parameters": [], "condition": "" }, "workflow": [] }
  ]
}