डाइनैमिक सूची को पसंद के मुताबिक बनाना   यह Android Jetpack का हिस्सा है.

Compose का इस्तेमाल करके मैसेज लिखना

Android के लिए, Jetpack Compose हमारा सुझाया गया यूज़र इंटरफ़ेस (यूआई) टूलकिट है. Compose में लेआउट इस्तेमाल करने का तरीका जानें.

लेज़ी लिस्ट और ग्रिड →

अपनी ज़रूरतों के हिसाब से, RecyclerView ऑब्जेक्ट को पसंद के मुताबिक बनाया जा सकता है. RecyclerView के साथ डाइनैमिक सूचियां बनाना में बताई गई स्टैंडर्ड क्लास, सभी डेवलपर की ज़रूरतों के हिसाब से काम करती हैं. कई मामलों में, आपको सिर्फ़ हर व्यू होल्डर के लिए व्यू डिज़ाइन करना होगा और उन व्यू को सही डेटा से अपडेट करने के लिए कोड लिखना होगा. हालांकि, अगर आपके ऐप्लिकेशन के लिए कुछ खास ज़रूरतें हैं, तो स्टैंडर्ड व्यवहार में कई तरीकों से बदलाव किया जा सकता है. इस दस्तावेज़ में, पसंद के मुताबिक किए जा सकने वाले कुछ विकल्पों के बारे में बताया गया है.

लेआउट में बदलाव करें

RecyclerView, स्क्रीन पर अलग-अलग आइटम की पोज़िशन तय करने के लिए लेआउट मैनेजर का इस्तेमाल करता है. साथ ही, यह तय करता है कि उपयोगकर्ता को अब दिखने वाले आइटम व्यू का फिर से इस्तेमाल कब किया जाए. किसी व्यू का फिर से इस्तेमाल करने या उसे रीसाइकल करने के लिए, लेआउट मैनेजर, अडैप्टर से कह सकता है कि वह व्यू के कॉन्टेंट को डेटासेट के किसी दूसरे एलिमेंट से बदल दे. इस तरह से व्यू रीसाइकलिंग करने से, ज़रूरत से ज़्यादा व्यू बनाने या महंगे findViewById() लुकअप करने से बचने में मदद मिलती है. इससे परफ़ॉर्मेंस बेहतर होती है. Android Support Library में तीन स्टैंडर्ड लेआउट मैनेजर शामिल हैं. इनमें से हर एक, पसंद के मुताबिक बनाने के कई विकल्प उपलब्ध कराता है:

• LinearLayoutManager: आइटम को एक डाइमेंशन वाली सूची में व्यवस्थित करता है. LinearLayoutManager के साथ RecyclerView का इस्तेमाल करने से, ListView लेआउट जैसी सुविधा मिलती है.
• GridLayoutManager: आइटम को दो डाइमेंशन वाले ग्रिड में व्यवस्थित करता है, जैसे कि चैकरबोर्ड पर स्क्वेयर. RecyclerView के साथ GridLayoutManager का इस्तेमाल करने पर, GridView लेआउट जैसी सुविधा मिलती है.
• StaggeredGridLayoutManager: यह आइटम को दो डाइमेंशन वाले ग्रिड में व्यवस्थित करता है. इसमें हर कॉलम, पहले वाले कॉलम से थोड़ा ऑफ़सेट होता है, जैसे कि अमेरिकी झंडे पर मौजूद तारे.

अगर ये लेआउट मैनेजर आपकी ज़रूरतों के मुताबिक नहीं हैं, तो RecyclerView.LayoutManager आब्स्ट्रैक्ट क्लास को बड़ा करके, अपने हिसाब से लेआउट मैनेजर बनाए जा सकते हैं.

आइटम के ऐनिमेशन जोड़ें

जब भी कोई आइटम बदलता है, तो RecyclerView उसके दिखने का तरीका बदलने के लिए ऐनिमेशन का इस्तेमाल करता है. यह ऐनिमेशन करने वाला ऑब्जेक्ट है, जो एब्स्ट्रैक्ट RecyclerView.ItemAnimator क्लास को एक्सटेंड करता है. डिफ़ॉल्ट रूप से, ऐनिमेशन दिखाने के लिए RecyclerView, DefaultItemAnimator का इस्तेमाल करता है. अगर आपको कस्टम ऐनिमेशन देने हैं, तो RecyclerView.ItemAnimator को एक्सटेंड़ करके, अपना ऐनिमेशन ऑब्जेक्ट तय किया जा सकता है.

सूची-आइटम चुनना चालू करें

recyclerview-selection लाइब्रेरी की मदद से, उपयोगकर्ता टच या माउस इनपुट का इस्तेमाल करके, RecyclerView सूची में मौजूद आइटम चुन सकते हैं. इससे, चुने गए आइटम के विज़ुअल प्रज़ेंटेशन को कंट्रोल किया जा सकता है. आपके पास, आइटम चुनने के तरीके को कंट्रोल करने वाली नीतियों को कंट्रोल करने का विकल्प भी होता है. जैसे, कौनसे आइटम चुने जा सकते हैं और कितने आइटम चुने जा सकते हैं.

RecyclerView इंस्टेंस में, चुनने की सुविधा जोड़ने के लिए, यह तरीका अपनाएं:

1. यह तय करें कि किस तरह के सिलेक्शन बटन का इस्तेमाल करना है. इसके बाद, एक ItemKeyProvider बनाएं.

   चुने गए आइटम की पहचान करने के लिए, इन तीन मुख्य टाइप का इस्तेमाल किया जा सकता है:

   • Parcelable और उसकी सब-क्लास, जैसे कि Uri
   • String
   • Long

   चुनने के लिए बटन के टाइप के बारे में ज़्यादा जानकारी के लिए, SelectionTracker.Builder देखें.

2. ItemDetailsLookup लागू करें.

ItemDetailsLookup, चुनी गई लाइब्रेरी को MotionEvent दिए गए RecyclerView आइटम के बारे में जानकारी ऐक्सेस करने की अनुमति देता है. यह ItemDetails इंस्टेंस के लिए एक फ़ैक्ट्री है. इन इंस्टेंस का बैक अप, RecyclerView.ViewHolder इंस्टेंस से लिया जाता है या उसमें से निकाला जाता है.

3. RecyclerView में आइटम View ऑब्जेक्ट अपडेट करें, ताकि यह दिखाया जा सके कि उपयोगकर्ता उन्हें चुनता है या चुने हुए का निशान हटाता है.

   चुनी गई लाइब्रेरी, चुने गए आइटम के लिए डिफ़ॉल्ट विज़ुअल सजावट नहीं देती है. onBindViewHolder() को लागू करते समय, यह जानकारी दें. हमारा सुझाव है कि आप यह तरीका अपनाएं:

   • onBindViewHolder() में, View ऑब्जेक्ट पर true या false के साथ, setActivated()—नहीं setSelected()—को कॉल करें. यह इस बात पर निर्भर करता है कि आइटम चुना गया है या नहीं.
   • सुविधा चालू होने की स्थिति दिखाने के लिए, व्यू की स्टाइल अपडेट करें. हमारा सुझाव है कि स्टाइल को कॉन्फ़िगर करने के लिए, रंग की स्थिति की सूची वाले संसाधन का इस्तेमाल करें.
4. ActionMode का इस्तेमाल करें और उपयोगकर्ता को चुने गए आइटम पर कार्रवाई करने के लिए टूल दें.

चुने गए विकल्प में बदलाव होने पर सूचना पाने के लिए, SelectionTracker.SelectionObserver रजिस्टर करें. जब कोई सेलेक्ट पहली बार बनाया जाता है, तो उपयोगकर्ता को यह दिखाने के लिए ActionMode शुरू करें और सेलेक्ट के हिसाब से कार्रवाइयां उपलब्ध कराएं. उदाहरण के लिए, ActionMode बार में मिटाएं बटन जोड़ा जा सकता है. साथ ही, चुने गए आइटम हटाने के लिए, बार पर मौजूद बैक ऐरो को कनेक्ट किया जा सकता है. अगर उपयोगकर्ता आखिरी बार चुने गए आइटम को हटा देता है, तो चुने गए आइटम की सूची खाली हो जाने पर ऐक्शन मोड बंद हो जाता है.

5. अनुवाद की गई सेकंडरी ऐक्शन करें.

इवेंट प्रोसेसिंग पाइपलाइन के आखिर में, लाइब्रेरी यह तय कर सकती है कि उपयोगकर्ता किसी आइटम पर टैप करके उसे चालू करने की कोशिश कर रहा है या किसी आइटम या चुने गए आइटम के सेट को खींचने की कोशिश कर रहा है. इन बातों पर अपनी प्रतिक्रिया दें. इसके लिए, सही लिसनर को रजिस्टर करें. ज़्यादा जानकारी के लिए, SelectionTracker.Builder देखें.

6. SelectionTracker.Builder का इस्तेमाल करके, सभी चीज़ों को इकट्ठा करें.

यहां दिए गए उदाहरण में, इन हिस्सों को एक साथ जोड़ने का तरीका बताया गया है:

Kotlin

    var tracker = SelectionTracker.Builder(
        "my-selection-id",
        recyclerView,
        StableIdKeyProvider(recyclerView),
        MyDetailsLookup(recyclerView),
        StorageStrategy.createLongStorage())
            .withOnItemActivatedListener(myItemActivatedListener)
            .build()
    

Java

    SelectionTracker tracker = new SelectionTracker.Builder<>(
            "my-selection-id",
            recyclerView,
            new StableIdKeyProvider(recyclerView),
            new MyDetailsLookup(recyclerView),
            StorageStrategy.createLongStorage())
            .withOnItemActivatedListener(myItemActivatedListener)
            .build();
    

SelectionTracker इंस्टेंस बनाने के लिए, आपके ऐप्लिकेशन को वही RecyclerView.Adapter देना होगा जिसका इस्तेमाल आपने RecyclerView को SelectionTracker.Builder में शुरू करने के लिए किया था. इस वजह से, SelectionTracker इंस्टेंस बनाने के बाद, उसे अपने RecyclerView.Adapter में इंजेक्ट करें. ऐसा न करने पर, onBindViewHolder() तरीके से किसी आइटम के चुने गए स्टेटस को नहीं देखा जा सकता.

7. गतिविधि के लाइफ़साइकल इवेंट में, चुने गए आइटम शामिल करें.

गतिविधि के लाइफ़साइकल इवेंट में, चुने गए आइटम की स्थिति को बनाए रखने के लिए, आपके ऐप्लिकेशन को गतिविधि के onSaveInstanceState() और onRestoreInstanceState() मैथड से, चुने गए आइटम के ट्रैकर के onSaveInstanceState() और onRestoreInstanceState() मैथड को कॉल करना होगा. आपके ऐप्लिकेशन को SelectionTracker.Builder कन्स्ट्रक्टर को एक यूनीक सिलेक्शन आईडी भी देना होगा. यह आईडी ज़रूरी है, क्योंकि किसी ऐक्टिविटी या फ़्रैगमेंट में एक से ज़्यादा अलग-अलग सूचियां हो सकती हैं. इनमें से किसी भी सूची को चुना जा सकता है. साथ ही, इन सभी सूचियों को सेव की गई स्थिति में बनाए रखना ज़रूरी है.

अन्य संसाधन

ज़्यादा जानकारी के लिए, यहां दिए गए रेफ़रंस देखें.

• Sunflower का डेमो ऐप्लिकेशन, जो RecyclerView का इस्तेमाल करता है.
• स्क्रोल की जा सकने वाली सूची दिखाने के लिए, RecyclerView का इस्तेमाल करना कोडलैब.
• Android के लिए Kotlin की बुनियादी बातें: RecyclerView की बुनियादी बातें कोडलैब.