Kuika’nın Switch elementi, kullanıcıların bir özelliği veya ayarı tek dokunuşla aktif/pasif hale getirmesine olanak tanır. Basit, sezgisel ve görsel olarak anlaşılır yapısıyla kullanıcı etkileşimini güçlendirir. Genellikle bağlantı, bildirim, güvenlik veya görünürlük ayarlarında tercih edilir.

Hem web hem de mobil uygulamalarda desteklenir.

Kullanım Alanları

• Bildirim veya e-posta aboneliği yönetimi
• Uygulama içi karanlık/aydınlık tema geçişi
• Konum, Bluetooth veya cihaz bağlantısı kontrolü
• Oturum açık kalma veya otomatik giriş ayarları
• Kullanıcı erişimi veya özellik yetkilendirmesi

Kullanım Senaryosu – Cihaz Bağlantısı Aktifleştirme

Bir akıllı ev uygulamasında, kullanıcı evcil hayvan mama makinesini (Pet Feeder) yönetmektedir. Bu ekranda Switch elementi, cihaz bağlantısının aktif olup olmadığını gösterir ve kullanıcı tarafından kontrol edilir.

Senaryoda:

• Kullanıcı “Stay Connected” başlığını ve bağlantı durumunu gösteren bir mesaj görür.
• Switch açık (mavi) konumdaysa, cihaz bağlantısı aktif demektir.
• Kullanıcı Switch’i kapattığında bağlantı devre dışı kalır.
• Sistem bu değeri veritabanına kaydeder ve arayüzde “Disconnected” mesajı gösterilir.

Veri Kaynağı Bağlama

• Datasources modülüne gidin.
• Tables başlığı yanındaki “+” ikonuna tıklayın.
• Tabloya DeviceConnections adını verin.
• Aşağıdaki tabloyu oluşturun. 

• Ardından Actions > SQL Actions sekmesinde yeni bir aksiyon oluşturun, adına UpdateConnectionStatus yazın.
• Aşağıdaki SQL komutunu girin:

UPDATE DeviceConnectionsSET IsConnected = @IsConnectedWHERE DeviceId = @DeviceId

• UI Design modülünde Switch elementini seçin.
• OnChange → Managed DB → UpdateConnectionStatus aksiyonunu bağlayın.
• Parametre eşleştirmelerini yapın:
  
  • @DeviceId = Current.DeviceId
  • @IsConnected = Switch.Value

UI Design Modülü İşlemleri

1. UI Design modülüne gidin.
2. Sol panelden Elements > Select Input > Switch elementini seçin.
3. Elementi ekranın uygun bölümüne sürükleyip bırakın.
4. Properties panelinde şu ayarları yapılandırın:

• Value: true (varsayılan olarak aktif)

Senaryo Tamamlandığında

• Kullanıcı “Stay Connected” anahtarını aktif ettiğinde, cihaz bağlantısı başlatılır.
• Switch mavi renkte görünür ve sistem “Your device is successfully connected.” mesajını gösterir.
• Kullanıcı anahtarı kapattığında bağlantı kesilir, Switch griye döner.
• Arka planda veritabanındaki IsConnected değeri güncellenir.

Kısıtlamalar

• Switch elementi yalnızca true/false değerleriyle çalışır.
• OnChange aksiyonu tanımlanmazsa, değişiklikler yalnızca görsel olur, veri tabanına yansımaz.
• Çok fazla Switch aynı sayfada kullanıldığında performans için Lazy Load önerilir.

İpuçları ve Best Practices

• Switch elementini kısa etiketlerle (ör. “Active”, “Enabled”, “Connected”) kullanın.
• Renk kodlamasıyla durumu net gösterin (ör. mavi = aktif, gri = pasif).
• Kritik işlemlerde OnChange aksiyonu öncesi “confirmation popup” ekleyin.
• “Tooltip” ekleyerek kullanıcıya açıklayıcı bilgi sağlayın.
• Switch’i Toggle Button yerine tercih edin, çünkü yalnızca ikili (on/off) durumlar için idealdir.