İçeriğe geç
Doğrulandı

Genel Değişkenler

Diğer her programın okuyabildiği tek program: tek bir ekrana değil, uygulamanın tamamına ait durum ve mantık için.

Her Xuda projesinin tam olarak bir Genel Değişkenler programı vardır. Projedeki herhangi bir Component, Get Data, Set Data, Batch, JavaScript veya API programının okuyabildiği sabitleri, ortak değişkenleri ve başlangıç mantığını tutar. Böylece her yerde aynı anlama gelen bir değer (oturum açmış kullanıcı, bir özellik bayrağı, etkin kampüs) ona ihtiyaç duyan her ekrana kopyalanmak yerine tek bir evde durur.

Genel Değişkenler her zaman istemcide çalışır

Başka yerlerde runAt ne derse desin, çalışma zamanı Genel Değişkenler'i client olmaya zorlar. Sunucuda hiç çalışmayan tek program türüdür, bu yüzden cihazdan uzak kalması gereken her şey (gizli bilgiler, ayrıcalıklı okumalar) için yanlış yerdir. Bunun için sunucu tarafında bir Get Data veya Set Data programı kullanın.

Ne zaman kullanılır

Bir değere veya bir parça başlangıç mantığına birden fazla Component'in ihtiyacı varsa ve bunu hepsine parametre olarak geçirmek istemiyorsanız Genel Değişkenler'e başvurun: oturum açmış kullanıcının adı, seçili bir kampüs veya kiracı, bir koyu mod bayrağı, bir destek e-posta adresi, birbiriyle ilgisiz birkaç ekranın dinleyebileceği bir raise_event merkezi.

Tek bir ekrana ait olan (o bir Component alanıdır) veya sunucu tarafında çalışması gereken hiçbir şey için kullanmayın.

Özellikler

Belge, ağaçta kendi dalının kökü olan studio_meta.parentId: "globals" altında durur, programs, database ve routes dallarından ayrıdır. Bir projenin Genel Değişkenler belgesi ve ağaç kökü silinemez.

progFields

Her girdi bir değişkeni bildirir ve her yerde @field_id olarak okunabilir.

Sistem genel değişkenleri her zaman sizinkilerin yanında kullanılabilir: @SYS_GLOBAL_OBJ_LOGIN_USER_INFO (oturum açmış kullanıcı nesnesi) ve @SYS_GLOBAL_OBJ_REFS (xu-ref ile kaydedilen, yükleme ve boş durumlar için kullanılan öğeler).

progEvents

Genel Değişkenler, diğer her programla aynı progEvents yapısını destekler, ancak platformdaki her olay türü ona uygulanmaz. Denetleyici screen_ready, on_refresh, on_unload ve client_interval olaylarını yalnızca Component'lerle sınırlar. Bunlardan birini bir Genel Değişkenler programında bildirmek ağır bir doğrulama hatasıdır. Genel Değişkenler'in gerçekte desteklediği olaylar:

Genel Değişkenler'de client_interval veya server_cron yoktur

Bu birimin eski bir açıklaması, Genel Değişkenler'in bir aralıkla (client_interval) veya bir sunucu cron zamanlamasıyla (server_cron) yoklama yapabildiğini söylüyordu. Hiçbiri güncel denetleyiciyle örtüşmüyor: client_interval yalnızca Component için geçerli olarak doğrulanır ve server_cron tanınan bir olay türü bile değildir, çalışma zamanındaki tek izi yorum satırı yapılmış bir işleyicidir. Bir projenin bugün yinelenen yoklamaya ihtiyacı varsa, zamanlayıcıyı Genel Değişkenler'e değil, bir Component'e koyun (orada client_interval gerçektir ve canlıdır).

Çalışan örnek

Ortak durumu bildirin

Her ekranın ihtiyaç duyduğu değerler için alanlar ekleyin: selected_campus_v, signed_in_user_v, dark_mode_v.

Her yerden okuyun

Projedeki her Component, program veya ifade bunları aynı şekilde, @ ile okur: @selected_campus_v.

Kesişen bir olay tetikleyin

Genel Değişkenler'e bir user_defined olayı verin (örneğin campus_changed) ve kampüsü değiştiren Component'ten raise_event ile çağırın. Aynı ada raise_event dinleyicisi koymuş diğer her açık Component, iki ekran arasında doğrudan bir başvuru olmadan tepki verir.

Studio ağacında Genel Değişkenler, kendi dalının kökündeki tek düğümdür (Programlar'ın altında iç içe değildir). Açın, her ortak değişken için Alanlar tablosuna bir tür ve varsayılan değerle satırlar ekleyin ve on_load / on_exit / adlandırılmış herhangi bir olay için Olaylar'a, her biri kendi iş akışıyla satırlar ekleyin.

xml
<meta lang="json5">
{
  id: "school_globals",
  menuTitle: "School Globals"
}
</meta>

<fields lang="json5">
{
  selected_campus_v: { type: "string", value: "Boston Campus" },
  signed_in_user_v: { type: "string", value: "Avery Walker" },
  support_email_v: { type: "string", value: "[email protected]" },
  dark_mode_v: { type: "boolean", value: false }
}
</fields>
json
{
  "properties": {
    "menuType": "globals",
    "menuName": "School Globals",
    "progDescription": "Campus and operator state shared across the app."
  },
  "progFields": [
    {
      "id": "b2c3d4e5-f6a7-4b8c-9d0e-1f2a3b4c5d6e",
      "data": { "field_id": "selected_campus_v", "type": "virtual" },
      "props": { "fieldType": "string", "fieldValue": "Boston Campus" }
    }
  ],
  "progEvents": [
    { "id": "d4e5f6a7-b8c9-4d0e-af1a-3b4c5d6e7f8a", "data": { "type": "on_load", "parameters": [], "condition": "" }, "workflow": [] }
  ],
  "progDataSource": {}
}