1. Kuika platformuna giriş yapın.
2. Apps ekranından projenizi seçin.
3. UI Design modülüne gidin.

4. Sol kenardaki Elements panelinden Navigation kategorisini seçin.‍
5. Breadcrumb elementini sürükleyip çalışma alanına bırakın.

‍

Breadcrumb elementi, uygulamanın bulunduğu ekranı current (mevcut sayfa) olarak işaretlerken, ona ait üst seviye parent menüleri sol tarafa dinamik olarak yerleştirir. Menü yapısına bağlı olarak otomatik güncellenir ve herhangi bir manuel müdahale olmadan hiyerarşik olarak çalışır.

Properties paneli üzerinden özelleştirilebilecek başlıca ayarlar:

• Options: Menü öğeleri bu alanda tanımlanır. Her bir öğe için etiket (label), hedef (path) ve isteğe bağlı olarak action (tıklama sonrası tetiklenecek işlem) tanımlanabilir.
• Active Item Color: Mevcut (aktif) sayfayı temsil eden breadcrumb öğesinin rengini belirler.
• Title Field: BreadCrumb üzerinde görünecek başlıkların bulunduğu alandır.
• Parent Key Field: BreadCrumb içerisindeki bir step’in parent (üst seviye) step’ini belirler.
• Link Field: BreadCrumb üzerindeki steplere tıklanarak NAVIGATE işleminin gerçekleşmesini sağlar. Bu alana proje içerisindeki ekran isimleri bağlanmalıdır.
• Key Field: Tabloda genellikle “Id” gibi unique bir değeri temsil eder ve her satırı ayırt etmek için kullanılır.

BreadCrumb Bağlantı Yapısı ve Örnek Senaryo

BreadCrumb’ın doğru çalışabilmesi için veri kaynağında (örneğin bir tablo veya API kaynağında) bağlantı alanlarının uygun şekilde yapılandırılması gerekir. Aşağıdaki kontrolleri yaparak ilerleyebilirsiniz:

• Key Field alanı: “Id” gibi benzersiz (unique) bir değer olmalıdır.
• Title Field alanı: BreadCrumb üzerinde gösterilecek başlıkları temsil eder.
• Parent Key Field alanı: BreadCrumb içindeki bir step’in parent step’ini belirler.
• Link Field alanı: Tıklama sonrası yönlendirme yapılacak ekran adlarını içerir.

Örnek Senaryo: HomePage / Urunler / Teknoloji

Bu yapıda “Urunler” butonuna tıklandığında Urunler ekranına yönlendirme yapılabilmesi için Link Field alanında “Urunler” değeri bulunmalıdır.
Bu özelliğin doğru çalışması için projede HomePage, Urunler ve Teknoloji ekranlarının tanımlı olması gerekir.

Örnek Tablo Yapısı

BreadCrumb verisi için en temel seviyede tablo aşağıdaki kolonları içermelidir:

• Id: Her satır için benzersiz (unique) bir kimlik numarası.
• Page Name: BreadCrumb üzerinde görünecek sayfa adı.
• ParentId: Bir önceki (üst) sayfanın Id değeri.
• LinkField: İlgili sayfaya yönlendirme (navigate) yapılacak ekran adı.

Örnek yapı:

• 1 → HomePage
  
  • ParentId: Yok (ilk seviye sayfa)
  • LinkField: HomePage
• 2 → Urunler
  
  • ParentId: 1
  • LinkField: Urunler
• 3 → Teknoloji
  
  • ParentId: 2
  • LinkField: Teknoloji

Bu yapı sayesinde BreadCrumb elementi, kullanıcı hangi ekrandaysa o ekranın hiyerarşisini dinamik olarak oluşturur ve önceki sayfalara geri dönüşü sağlar.

Authorization (Yetkilendirme)

Element düzeyindeki erişim kontrolünü yönetmek için, Properties panelindeki Authorization bölümünü kullanabilirsiniz.

Erişim Tipleri

Anonymous

Elementin tüm kullanıcılar tarafından, giriş yapmadan görüntülenmesine izin verir.

Restricted

Erişimin yalnızca doğrulanmış kullanıcılara veya belirli rollere göre sınırlandırılmasını sağlar.

• Everyone: Aktif edildiğinde, giriş yapmış tüm kullanıcılar elemente erişebilir.
• Roles: Elemente erişmesine izin verilen roller buradan seçilir. Rol listesini düzenlemek için Roles alanının yanındaki dişli (⚙️) ikonuna tıklayarak Role Management penceresini açabilirsiniz. Bu pencereden yeni rol ekleyebilir, klasör oluşturabilir veya mevcut rolleri yönetebilirsiniz.

Unauthorized Behavior (Hide / Disable)

Kullanıcı gerekli role sahip değilse, elementin nasıl davranacağını Choose alanından belirleyebilirsiniz:

• Hide: Kullanıcı yetkili değilse element tamamen gizlenir ve ekranda görünmez.
• Disable: Element görünür kalır ancak tıklanamaz / kullanılamaz hâle gelir.

Bu ayar, yetkisiz kullanıcıların elementle nasıl karşılaşacağını yönetmeniz için kullanılır.

Visibility (Görünürlük)

• Always Visible: Element her zaman görünür.
• Hidden: Element gizlenir.
• Sometimes Visible: Element, belirli bir koşula bağlı olarak görünür.

Ayarı yapılandırmak için:

1. Ekrandaki elementi seçin.
2. Sağ kenardaki Properties panelini açın.
3. Visibility alanında ihtiyacınıza göre bir seçenek belirleyin.

Editability (Düzenlenebilirlik)

• Enabled: Element düzenlenebilir.
• Disabled: Element düzenlenemez.
• Sometimes Enabled: Element, belirli koşullara göre düzenlenebilir veya düzenlenemez.

Style Panel ile Arayüz Tasarımı

Elementlerinizi Styling Panel ile özelleştirerek, web ve mobil uygulamalarınız için etkileyici arayüzler oluşturabilirsiniz. Bu bölümde, aşağıdaki ayarları yapılandırabilirsiniz:

• Layout (Düzen): Boyutlandırma, hizalama ve iç boşluk (padding) ayarları. Ayarlar arasında Size, Min Size ve Align bulunur.
• Text (Metin): Yazı tipi, stil, renk, boyut ve aralık ayarları.
• Fill (Dolgu): Arka planı renk veya görsellerle özelleştirme.
• Border (Kenarlık): Kenarlık ekleme ve köşe yarıçapı ayarları.
• Shadow (Gölge): Elementlere derinlik katmak için gölge efekti ekleme.