İçeriğe geç
Doğrulandı

Rota

Gezinilebilir bir giriş noktası: her biri içeriğini sağlayan Component'e işaret eden hedeflerden oluşan bir menü.

Bir Rota, bir Xuda uygulamasının gezinilebilir bir yüzeyini tanımlar: her biri, onu işleyen Component'e eşlenmiş bir yol veya etiket olan hedeflerden oluşan bir menü. Rotalar Studio ağacında Programlar ve Veritabanı'ndan ayrı, kendi dallarında yer alır ve tek bir uygulama birden fazlasını bildirebilir: herkese açık bir site, bir yönetici paneli, bir mobil kabuk, her biri kendi Rota belgesi.

Özellikler

studio_meta.parentId varsayılan olarak Rotalar ağacının kökü olan routes değerini alır. Programlar ve Veritabanı'ndan farklı olarak Rotalar ağacında klasör iç içeliği yoktur, her Rota doğrudan o kökün altında durur.

Her Rota belgesi bugün hata olarak denetlenir

Denetleyicinin properties.menuType izin listesi (CHK_MSG_OBJ_GEN_105) route'u dışarıda bırakır, bu yüzden check_route kendi gerçek denetimlerini (CHK_MSG_RTE_MNU_010/020/030) hemen yanında çalıştırsa da her Rota belgesi sorun listesinde "invalid properties.menuType" hatası verir. Bir rotanın kaydedilmesini veya dağıtılmasını engellemez, denetleyici çıktısında beklenip yok sayılacak bir gürültüdür, rotanın yanlış yapılandırıldığının işareti değildir.

routeMenu

menu içindeki her girdi, içeriğini sağlayan Component'i adlandıran bir prog_id gerektirir. Eksik olması veya projede olmayan bir programı adlandırması denetleyici hatasıdır. Öğeler iç içe olabilir (children) ve her biri, Rotalar düzenleyicisi tarafından doldurulan, etkin durumu için bgColor / bgTextColor gibi görüntüleme alanları taşır.

Çalışan örnek

Hedefleri listeleyin

Her ekran için bir menü girdisi: bir başlık ve açtığı Component'in _id'si.

Bir varsayılan seçin

default_menu_id, rota ilk açıldığında gösterilen girdiyi adlandırır.

Bir Component'i ona yöneltin

Çoğu uygulama rotayı birebir gezinti arayüzü olarak da yansıtır (sekmeler, bir kenar çubuğu), her düğmenin xu-on:click olayı hedef Component'in kimliğiyle call_page çağırır, böylece rota doğruluk kaynağı olarak kalır ve arayüz onunla eşitli kalır.

Studio ağacında Rotalar altında bir rota ekleyin, ardından menüsünü Rotalar düzenleyicisinde oluşturun: bir öğe ekleyin, ona bir etiket verin ve açması gereken Component'i seçin.

json
{
  "id": "student_app_route",
  "menuTitle": "Student Dashboard Route",
  "menu": [
    { "title": "Login", "prog": "app" },
    { "title": "Students", "prog": "student_classes" },
    { "title": "Tasks", "prog": "student_tasks" }
  ]
}

Bir rotanın .xu kaynak biçimi yoktur, xuda-cli projeleri onu bunun yerine bir .route.json5 dosyası olarak bildirir. Kullanıcı dostu prog anahtarı, Studio belgesinde routeMenu.menu[].prog_id olarak derlenir.

json
{
  "properties": { "menuType": "route", "menuName": "Admin Dashboard" },
  "routeMenu": {
    "default_menu_id": "a1b2c3d4-…",
    "menu": [
      { "id": "a1b2c3d4-…", "prog_id": "97a_cmp_…", "bgColor": "#0f172a", "bgTextColor": "#f8fafc" },
      { "id": "b2c3d4e5-…", "prog_id": "97a_cmp_…", "bgColor": "#1e293b", "bgTextColor": "#e2e8f0" }
    ]
  }
}