Select Box

30/6/25

‍

Kuika'nın Select Box elementi, kullanıcıların açılır menü aracılığıyla belirli seçenekler arasından seçim yapmalarını sağlar. Bu kılavuzda, Select Box elementini nasıl kullanacağınızı ve seçeneklerinizi nasıl yapılandıracağınızı öğreneceksiniz.

Select Box elementi hem web hem de mobil uygulamalarda kullanılabilir.

Select Box Elementi Ekleme
Select Box Elementi Özellikleri
Datasources Modülünde Veri Aktarımı
UI Design Modülünde Veri Aktarımı
Elements ayarları ve özelleştirme

Select Box Elementi Ekleyin

Kuika platformuna giriş yapın.
Apps ekranından çalışacağınız projeyi açın.
UI Design modülüne gidin.

Sol kenardaki Elements panelinden Select Input kategorisini seçin.
Select Box elementini çalışma alanına sürükleyip bırakın.

Boş bir alana sürüklerseniz, Select Box elementi bir Row elementi ile birlikte eklenir.
Column içerisine sürüklerseniz yalnızca Select Box elementi eklenir.

Select Box Elementi Özellikleri

Value: Statik bir değer ekleyebilir veya Symbol Picker kullanarak başka bir elementin içeriğini ya da aksiyon sonucunu dinamik olarak gösterebilirsiniz.
Options: Açılır liste içinde gösterilecek veri tablosunun bağlantısını sağlar.
Fixed Options List: Manuel olarak tanımlanan sabit verilerin listelenmesini sağlar.
Placeholder: Kullanıcının veri girmediğinde görünen yer tutucu metindir.
Allow Clear: Seçilen değerin tek tıklamayla silinmesini sağlar.
Searchable: Açılır liste içinde arama yapılabilmesine olanak tanır.
Contains Null Item: Listenin ilk değerini boş olarak ayarlayabilirsiniz.‍
Sort By: Liste öğelerini alfabetik olarak A-Z veya Z-A sıralar.
Dropdown Scroll Item Limit: Açılır listede aynı anda görüntülenecek maksimum öğe sayısını belirler. Belirtilen limit aşıldığında, kullanıcı aşağı kaydırarak kalan seçenekleri görebilir.

Select Box Elementine Veri Aktarımı için Datasources Modülünde Çalışma

1. Datasources modülünü açın.

Verilerinizi içeren bir tablo oluşturun. Örnek: Department tablosu.

Tabloya gerekli sütunları ekleyin (örn. DepartmentName).

Actions bölümünden yeni bir SQL Action oluşturun. Örnek: SelectDepartment.

SQL Editöründe şu sorguyu yazın:

SELECT * FROM Department

‍

6. Action’ı kaydedin.

Select Box Elementine Veri Aktarımı için UI Design Modülünde Çalışma

UI Design modülüne gidin.
Select Box’ı eklediğiniz ekranda sağ kenardaki Properties panelinden ADD ACTION butonuna tıklayın.‍
Initial Actions → Custom → Datasource adımlarını izleyerek SelectDepartment aksiyonunu seçin.‍
Select Box elementine tıklayın ve Options menüsünden şu ayarları yapın:
- Action: SelectDepartment
- Field to display: DepartmentName‍
- Field to Use as Key: Id

Element Ayarları ve Özelleştirme

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:

Ekrandaki elementi seçin.
Sağ kenardaki Properties panelini açın.
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.