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

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

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

Properties panelinden aşağıdaki ayarları yapılandırabilirsiniz:

• Value: Kullanıcı tarafından girilen veya başlangıçta atanmış metni temsil eder.
• Placeholder: Kullanıcı metin girmediğinde görünen bilgilendirici metindir (örn. “Adınızı girin”).
• Max Length: Kullanıcının girebileceği maksimum karakter sayısını sınırlar (örn. 30 karakter).
• Allow Clear: Sağ kenarda bulunan Sil (X) simgesiyle metnin hızlıca temizlenmesini sağlar.
• Mask: Kullanıcının belirli bir formatta metin girmesini sağlar (örn. tarih için ##/##/####).
• Formatter: Girilen metni belirli bir biçime dönüştürür:
  
  • Lowercase: Harflerin küçük harfe dönüştürülmesini sağlar.
  • Uppercase: Harflerin büyük harfe dönüştürülmesini sağlar.
• Input Mode: Klavye düzenini belirler (örn. all – tüm karakterler, char – harf ve semboller, number – yalnızca sayılar).
• Allowed Chars: Girilebilecek karakterleri belirler (örn. yalnızca rakam ve "-", "(", ")" gibi karakterler).
• Auto Complete: Kullanıcının yazdığı metne uygun öneriler sunar (örn. "İ" yazıldığında "İzmir", "İstanbul" gibi seçenekler çıkar).
• Input Mode: Klavye düzenini belirler. Seçenekler:
  
  • all: Tüm karakterlere izin verilir
  • char: Harf ve sembollere izin verilir
  • number: Yalnızca sayılar girilebilir
• Speech To Text: Sesli komutlarla metin girişi yapılmasını sağlar.

Text Input elementi, belirli formatlara uygun veri girişini sağlamak amacıyla maskeleme işlemlerini destekler. Böylece kullanıcıdan gelen verilerin doğru ve tutarlı formatta olması garanti altına alınır.

Temel Mask Sembolleri

• 9: Rakam (0-9)
• a: Harf (A-Z, a-z)
• *: Alfanümerik karakter (A-Z, a-z, 0-9)

Örnek Maske Formatları

• 99/99/9999: Tarih biçimi (örn. 01/01/2023)
• (999)-999-9999: Telefon numarası (örn. (555)-555-1234)
• $999,999.00: Para birimi (örn. $123,456.00)
• aaaa9999: Harf ve sayı karışımı (örn. ABcd2025)
• ***-***: Seri numarası formatı (örn. aZ3-bT7)
• AA 9999: Plaka formatı (örn. TR 1234)

Ülke Bazlı Telefon Formatları

• Türkiye: 999 999 99 99
• Almanya: +49 99 999 99
• Fransa: 9 99 99 99 99

Uygulama Adımları

1. Elements panelinden Text Input elementini sayfaya sürükleyin.
2. Sağ taraftaki Properties panelinden Mask bölümünü açın.
3. Mask → Fixed Value alanına:
   
   • Manuel olarak bir maske formatı girin,
   • veya veri tabanından gelen bir değer bağlayın.

Maskeleme ayarlarını yaptıktan sonra önizleme alarak sonucu test edebilirsiniz.

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 koşullara bağlı olarak görünür.

Sometimes Visible seçeneği kullanıldığında AND / OR grupları doğrudan eklenebilir ve görünürlük kuralları birlikte gruplandırılarak daha karmaşık senaryolar rahatlıkla yönetilebilir.

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.