Card
bileşeni, kullanıcı arayüzünüz için bir Material Design kapsayıcısı görevi görür.
Kartlar, tek bir tutarlı içerik parçası sunar. Örneğin:
- Alışveriş uygulamasındaki bir ürün.
- Haber uygulamasındaki bir haber.
- İletişim uygulamasındaki bir mesaj.
Card
, tek bir içeriği göstermeye odaklandığı için diğer kapsayıcılardan farklıdır. Örneğin, Scaffold
tüm ekran için genel yapıyı sağlar. Kart, daha büyük bir düzenin içindeki daha küçük bir kullanıcı arayüzü öğesidir. Column
veya Row
gibi bir düzen bileşeni ise daha basit ve daha genel bir API sağlar.
Bu konuda, dört tür kartı nasıl uygulayabileceğiniz gösterilmektedir:
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
Temel kart oluşturma
Card
, Oluştur'daki diğer kapsayıcılara benzer şekilde çalışır. İçeriğini, içindeki diğer birleştirilebilir öğeleri çağırarak belirtirsiniz. Örneğin, aşağıdaki minimal örnekte Card
'in Text
çağrısını nasıl içerdiğini düşünün:
Doldurulmuş kart oluşturma
Buradaki anahtar, doldurulmuş rengi değiştirmek için colors
mülkünün kullanılmasıdır:
Sonuçlar
![Kart, materyal temasından alınan yüzey varyantı rengiyle doldurulur.](https://developer.android.google.cn/static/develop/ui/compose/images/components/card-filled.png?hl=tr)
Üst düzey kart oluşturma
Aşağıdaki snippet'te, yükseltilmiş kartın nasıl uygulanacağı gösterilmektedir. Özel ElevatedCard
bileşenini kullanın.
Yüksekliğin görünümünü ve ortaya çıkan gölgeyi kontrol etmek için elevation
mülkünü kullanabilirsiniz.
Sonuçlar
![Bir kart, gölgeli olarak uygulamanın arka planının üzerinde yükseltilir.](https://developer.android.google.cn/static/develop/ui/compose/images/components/card-elevated.png?hl=tr)
Ana hatlarıyla belirtilmiş kart oluşturma
Aşağıda, kenarları sivriltilmiş bir kart örneği verilmiştir. Özel OutlinedCard
bileşenini kullanın.
Sonuçlar
![Kartın etrafına ince siyah bir kenarlık çizilir.](https://developer.android.google.cn/static/develop/ui/compose/images/components/card-outlined.png?hl=tr)
Önemli noktalar
Card
API tanımı için referans bölümüne bakın. Bileşenin görünümünü ve davranışını özelleştirmek için kullanabileceğiniz çeşitli parametreler tanımlar.
Bazı temel parametreler şunlardır:
elevation
: Bileşene, arka planın üzerinde yükselmiş gibi görünmesini sağlayan bir gölge ekler.colors
: Hem kapsayıcının hem de alt öğelerinin varsayılan rengini ayarlamak içinCardColors
türünü kullanır.enabled
: Bu parametre içinfalse
değerini gönderirseniz kart devre dışı olarak görünür ve kullanıcı girişlerine yanıt vermez.onClick
: NormaldeCard
, tıklama etkinliklerini kabul etmez. Bu nedenle, dikkate almak istediğiniz birincil aşırı yükleme,onClick
parametresini tanımlayan aşırı yüklemedir.Card
uygulamanızın kullanıcının tıklamalarına yanıt vermesini istediğinizde bu aşırı yüklemeyi kullanın.
Kartlar, kaydırma veya kapatma işlemleriyle birlikte gelmez ancak bu özellikleri sunan bileşenlere entegre edilebilir. Örneğin, bir kartta kapatmak için kaydır özelliğini uygulamak istiyorsanız bu özelliği SwipeToDismiss
bileşeniyle entegre edin. Kaydırma ile entegre etmek için verticalScroll
gibi kaydırma değiştiricileri kullanın. Daha fazla bilgi için Scroll
belgelerini inceleyin.
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)