ऐप्लिकेशन को अक्सर डेटा को एक जैसे स्टाइल वाले कंटेनर में दिखाना पड़ता है. जैसे, सूची में मौजूद आइटम की जानकारी रखने वाले कंटेनर. सिस्टम, CardView
एपीआई उपलब्ध कराता है, ताकि आप कार्ड में जानकारी दिखा सकें. यह कार्ड, प्लैटफ़ॉर्म पर एक जैसा दिखता है. उदाहरण के लिए, कार्ड के ऊपर उनके व्यू ग्रुप की डिफ़ॉल्ट ऊंचाई होती है, ताकि सिस्टम उनके नीचे परछाई बना सके. कार्ड, कंटेनर के लिए एक जैसी स्टाइल देते हुए, व्यू का एक ग्रुप शामिल करने
का तरीका बताते हैं.
डिपेंडेंसी जोड़ना
CardView
विजेट, AndroidX का हिस्सा है. अपने प्रोजेक्ट में इसका इस्तेमाल करने के लिए, अपने ऐप्लिकेशन मॉड्यूल की build.gradle
फ़ाइल में यह डिपेंडेंसी जोड़ें:
Groovy
dependencies { implementation "androidx.cardview:cardview:1.0.0" }
Kotlin
dependencies { implementation("androidx.cardview:cardview:1.0.0") }
कार्ड बनाएं
CardView
का इस्तेमाल करने के लिए, उसे अपनी लेआउट फ़ाइल में जोड़ें. अन्य व्यू शामिल करने के लिए, इसे व्यू ग्रुप के तौर पर इस्तेमाल करें. नीचे दिए गए उदाहरण में, उपयोगकर्ता को कुछ जानकारी दिखाने के लिए, CardView
में एक ImageView
और कुछ TextViews
शामिल हैं:
<?xml version="1.0" encoding="utf-8"?>
<androidx.constraintlayout.widget.ConstraintLayout
xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:padding="16dp"
android:background="#E0F7FA"
android:layout_width="match_parent"
android:layout_height="match_parent">
<androidx.cardview.widget.CardView
android:layout_width="match_parent"
android:layout_height="wrap_content"
app:layout_constraintBottom_toBottomOf="parent"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent">
<androidx.constraintlayout.widget.ConstraintLayout
android:padding="4dp"
android:layout_width="match_parent"
android:layout_height="match_parent">
<ImageView
android:id="@+id/header_image"
android:layout_width="match_parent"
android:layout_height="200dp"
android:src="@drawable/logo"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toTopOf="parent" />
<TextView
android:id="@+id/title"
style="@style/TextAppearance.MaterialComponents.Headline3"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginTop="4dp"
android:text="I'm a title"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toBottomOf="@id/header_image" />
<TextView
android:id="@+id/subhead"
style="@style/TextAppearance.MaterialComponents.Subtitle2"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginTop="4dp"
android:text="I'm a subhead"
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toBottomOf="@id/title" />
<TextView
android:id="@+id/body"
style="@style/TextAppearance.MaterialComponents.Body1"
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:layout_marginTop="4dp"
android:text="I'm a supporting text. Very Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam, quis nostrud exercitation ullamco laboris nisi ut aliquip ex ea commodo consequat. Duis aute irure dolor in reprehenderit in voluptate velit esse cillum dolore eu fugiat nulla pariatur. Excepteur sint occaecat cupidatat non proident, sunt in culpa qui officia deserunt mollit anim id est laborum."
app:layout_constraintEnd_toEndOf="parent"
app:layout_constraintStart_toStartOf="parent"
app:layout_constraintTop_toBottomOf="@id/subhead" />
</androidx.constraintlayout.widget.ConstraintLayout>
</androidx.cardview.widget.CardView>
</androidx.constraintlayout.widget.ConstraintLayout>
पिछले कोड स्निपेट से, कुछ ऐसा दिखता है जैसा यहां दिखाया गया है. ऐसा तब होता है, जब आपने एक ही Android लोगो इमेज का इस्तेमाल किया हो:
इस उदाहरण में, कार्ड को स्क्रीन पर डिफ़ॉल्ट ऊंचाई के साथ दिखाया गया है. इस वजह से, सिस्टम उसके नीचे एक छाया बनाता है. card_view:cardElevation
एट्रिब्यूट की मदद से, किसी कार्ड के लिए अपनी पसंद के मुताबिक ऊंचाई तय की जा सकती है. ज़्यादा ऊंचाई पर मौजूद कार्ड की छाया ज़्यादा साफ़ दिखती है. वहीं, कम ऊंचाई पर मौजूद कार्ड की छाया ज़्यादा हल्की दिखती है. CardView
, Android 5.0 (एपीआई लेवल 21) और इसके बाद के वर्शन पर, रीयल एलिवेशन और डाइनैमिक शैडो का इस्तेमाल करता है.
CardView
विजेट के दिखने के तरीके को पसंद के मुताबिक बनाने के लिए, इन प्रॉपर्टी का इस्तेमाल करें:
- अपने लेआउट में कोने की त्रिज्या सेट करने के लिए,
card_view:cardCornerRadius
एट्रिब्यूट का इस्तेमाल करें. - अपने कोड में कोने की त्रिज्या सेट करने के लिए,
CardView.setRadius
तरीके का इस्तेमाल करें. - किसी कार्ड के बैकग्राउंड का रंग सेट करने के लिए,
card_view:cardBackgroundColor
एट्रिब्यूट का इस्तेमाल करें.