Switch
bileşeni, kullanıcıların işaretli ve işaretsiz olmak üzere iki durum arasında geçiş yapmasına olanak tanır. Kullanıcının aşağıdakilerden birini yapmasına izin vermek için bir anahtar kullanın:
- Bir ayarı açın veya kapatın.
- Bir özelliği etkinleştirme veya devre dışı bırakma
- Bir seçenek belirleyin.
Bileşenin iki bölümü vardır: küçük resim ve parça. Başparmak, anahtarın sürüklenebilir kısmıdır ve parça arka plandır. Kullanıcı, anahtarın durumunu değiştirmek için başparmağı sola veya sağa sürükleyebilir. Ayrıca anahtara dokunarak da bu ayarı kontrol edip temizleyebilirler.
Sürüm uyumluluğu
Bu uygulama için projenizin minSDK değerinin API düzeyi 21 veya üstü olarak ayarlanması gerekir.
Bağımlılıklar
Geçiş yapma
Aşağıdaki örnek, Switch
bileşeninin en basit uygulamasıdır:
Sonuçlar
![İşaretlenmemiş temel anahtar.](https://developer.android.google.cn/static/develop/ui/compose/images/components/switch-deactivated.png?hl=tr)
![Kontrol edilen temel bir anahtar.](https://developer.android.google.cn/static/develop/ui/compose/images/components/switch.png?hl=tr)
Özel küçük resim oluşturma
Özel bir küçük resim oluşturmak için thumbContent
parametresi için herhangi bir bileşeni iletebilirsiniz. Aşağıda, küçük resmi için özel simge kullanan bir anahtar örneği verilmiştir:
Sonuçlar
İşaretlenmemiş görünüm, önceki bölümdeki örneğe benzer. Ancak bu uygulama, kontrol edildiğinde aşağıdaki gibi görünür:
![İşaretlendiğinde özel bir simge görüntülemek için thumbContent parametresini kullanan bir anahtar.](https://developer.android.google.cn/static/develop/ui/compose/images/components/switch-icon.png?hl=tr)
Özel renkler kullanma
Anahtarın işaretçisinin ve kaydırma çubuğunun rengini değiştirmek için colors
parametresini kullanın. Bu parametre, anahtarın işaretli olup olmadığını dikkate alır.
Sonuçlar
![Hem başparmak hem de raptiye için özel renklere sahip bir anahtar görüntülemek üzere colors parametresini kullanan bir anahtar.](https://developer.android.google.cn/static/develop/ui/compose/images/components/switch-colors.png?hl=tr)
Önemli noktalar
Temel parametreler:
checked
: Anahtarın ilk durumu.onCheckedChange
: Anahtarın durumu değiştiğinde çağrılan bir geri çağırma işlevi.enabled
: Anahtarın etkin veya devre dışı olup olmadığını belirtir.colors
: Anahtar için kullanılan renkler.
Gelişmiş parametreler
thumbContent
: İşaretliyken küçük resmin görünümünü özelleştirmek için kullanın.colors
: Parçanın ve küçük resmin rengini özelleştirmek için kullanın.
Bu kılavuzu içeren koleksiyonlar
Bu kılavuz, daha geniş Android geliştirme hedeflerini kapsayan, özel olarak seçilmiş Hızlı Kılavuz koleksiyonlarından biridir:
![](https://developer.android.google.cn/static/images/quick-guides/collection-illustration.png?hl=tr)