ViewPager 2 - पुराने आवरण में नई कार्यक्षमता

ViewPager Android सपोर्ट लाइब्रेरी के सबसे प्रसिद्ध और व्यापक रूप से उपयोग किए जाने वाले घटकों में से एक है। सभी सरलतम हिंडोला, जहाज पर और स्लाइडर्स इस पर बने हैं। फरवरी 2019 में, AndroidX विकास टीम ने ViewPager2 जारी किया। आइए देखें कि ये पूर्वापेक्षाएँ क्या थीं और घटक के अद्यतन संस्करण के क्या फायदे हैं।

देखें पेजर २

पोस्ट लिखने के समय (जुलाई 2019), ViewPager2 का एक बीटा संस्करण उपलब्ध है , जिसका अर्थ है कि नीचे बताई गई समस्याओं को ठीक किया जा सकता है और कार्यक्षमता में सुधार और विस्तार हुआ है। डेवलपर्स भविष्य में टैबलैयूट के लिए समर्थन जोड़ने का वादा करते हैं (जबकि यह केवल पहले संस्करण के साथ काम कर सकता है), एडेप्टर के प्रदर्शन को अनुकूलित करें, कई मामूली सुधार करें और प्रलेखन को अंतिम रूप दें।

एकीकरण

घटक को मानक पैकेज के साथ आपूर्ति नहीं की जाती है, लेकिन अलग से जुड़ा हुआ है। ऐसा करने के लिए, अपने मॉड्यूल की श्रेणी स्क्रिप्ट में निर्भरता ब्लॉक में निम्नलिखित पंक्ति जोड़ें:

implementation "androidx.viewpager2:viewpager2:1.0.0-beta02" 

कार्यान्वयन

आइए अच्छी खबर से शुरू करते हैं: पहली से दूसरे संस्करण तक संक्रमण जितना संभव हो उतना सरल है और आयात में बदलाव के लिए उबलता है। अच्छे पुराने सिंटैक्स को नहीं छुआ गया था: getCurrentItem () विधि वर्तमान पृष्ठ को वापस करती है, ViewPager2.onPageChangeCallback आपको पेजर राज्य की सदस्यता लेने की अनुमति देता है, एडेप्टर अभी भी setAdapter () के माध्यम से इंस्टॉल किया गया है ।

---

यह गहरी खुदाई के लायक है, क्योंकि यह स्पष्ट हो जाता है कि पहले और दूसरे पेजर्स में इंटरफेस के अलावा कुछ भी सामान्य नहीं है। सेट एडेप्टर के कार्यान्वयन के साथ परिचित () विधि संदेह के लिए कोई जगह नहीं छोड़ती है:

 public final void setAdapter(@Nullable Adapter adapter) { mRecyclerView.setAdapter(adapter); } 

हां, ViewPager2 RecyclerView पर सिर्फ एक आवरण है। एक तरफ, यह एक बड़ा प्लस है, दूसरे पर - यह एक सिरदर्द जोड़ता है। एक पत्रक के रूप में RecyclerView को छिपाने PagerSnapHelper के आगमन के साथ संभव हो गया। यह वर्ग स्क्रॉल के भौतिकी को बदलता है। जब उपयोगकर्ता अपनी उंगली जारी करता है, PagerSnapHelper गणना करता है कि कौन सी सूची आइटम सूची की केंद्र रेखा के सबसे करीब है, और चिकनी एनीमेशन के साथ यह केंद्र में बिल्कुल संरेखित करता है। इस प्रकार, यदि स्वाइप पर्याप्त तेज था, तो सूची अगले तत्व पर स्क्रॉल करती है, अन्यथा - एनीमेशन के साथ अपनी मूल स्थिति में वापस आ जाती है।

 new PagerSnapHelper().attachToRecyclerView(mRecyclerView); 

PagerSnapHelper का उपयोग करते समय, सुनिश्चित करें कि RecyclerView की चौड़ाई और ऊंचाई, साथ ही इसके सभी ViewHolders, MATCH_PARENT पर सेट हैं। अन्यथा, SnapHelper का व्यवहार अप्रत्याशित होगा, कीड़े पूरी तरह से अप्रत्याशित स्थानों में हो सकते हैं। यह सब समय-खपत के बजाय छोटी ऊंचाई के तत्वों के एक हिंडोला का निर्माण करता है, हालांकि संभव है।

उपरोक्त सभी को देखते हुए, लेआउट में विजेट इस तरह दिखेगा:

 <androidx.viewpager2.widget.ViewPager2 android:id="@+id/main_pager" android:layout_width="match_parent" android:layout_height="match_parent" /> 

ViewPager2 के समान पैकेज में , हम स्क्रॉलएवेंट एडेप्टर वर्ग भी पा सकते हैं, जो वाक्यविन्यास निरंतरता बनाए रखने में मदद करता है। स्क्रॉलएवेंट एडेप्टर RecyclerView.OnScrollListener को लागू करता है और स्क्रॉल घटनाओं को OnPageChangeCallback घटनाओं में बदल देता है।

 @Override public void onScrollStateChanged(@NonNull RecyclerView recyclerView, int newState) { if (mAdapterState != STATE_IN_PROGRESS_MANUAL_DRAG && newState == RecyclerView.SCROLL_STATE_DRAGGING) { ... dispatchStateChanged(SCROLL_STATE_DRAGGING); return; } ... } 

अब OnPageChangeCallback को एक इंटरफ़ेस द्वारा नहीं बल्कि एक अमूर्त वर्ग द्वारा दर्शाया जाता है, जो आपको केवल आवश्यक विधियों को ओवरराइड करने की अनुमति देता है (ज्यादातर मामलों में, आपको केवल o nPageSelected (Int) की आवश्यकता होती है , जो तब काम करता है जब कोई विशिष्ट पृष्ठ चुना जाता है):

 main_pager.registerOnPageChangeCallback( object : ViewPager2.OnPageChangeCallback() { override fun onPageSelected(position: Int) { //do your stuff } } ) 

विशेषताएं

ध्यान देने योग्य सेटपेजट्रांसफॉर्मर () विधि है, जो पैरामीटर के रूप में ViewPager2.PageTransformer लेती है। यह प्रत्येक पृष्ठ चयन घटना के लिए एक कॉलबैक सेट करता है और इस पृष्ठ के लिए अपना स्वयं का एनीमेशन सेट करने का कार्य करता है। कॉलबैक को वर्तमान पृष्ठ का दृश्य इनपुट और उसकी संख्या प्राप्त होती है। इस विधि का सबसे निकटतम एनालॉग RecyclerView का आइटमएनीमेटर है।

पुस्तकालय के नए संस्करणों में, ट्रांसफार्मर के दो कार्यान्वयन जोड़े गए:

कम्पोजिटपेजट्रांसफॉर्मर और मार्जिनपेज ट्रांसफॉर्मर । एक में एक पेजर के लिए कई परिवर्तनों को लागू करने के लिए ट्रांसफॉर्मर के संयोजन के लिए पहला जिम्मेदार है, और दूसरा पृष्ठों के बीच इंडेंट करने के लिए:



इसके अलावा, नया विजेट अभिविन्यास परिवर्तन का समर्थन करता है: बस सेटऑरिनेशन () विधि को कॉल करके, आप अपने पेजर को ऊपर से नीचे तक स्वाइप के साथ एक ऊर्ध्वाधर सूची में बदल सकते हैं:

 main_pager.setOrientation(ViewPager2.ORIENTATION_VERTICAL) 

यह पुनर्नवीनीकरण दृश्य में संक्रमण के लिए फिर से धन्यवाद के कारण होता है: हुड के तहत, लेआउटमैनेजर के अभिविन्यास में परिवर्तन को कहा जाता है , जो सूची वस्तुओं को प्रदर्शित करने के लिए जिम्मेदार है। यह ध्यान दिया जाना चाहिए कि बड़ी संख्या में कार्यों को अन्य वर्गों को सौंपने से नए घटक को फायदा हुआ है: इसकी लिस्टिंग बहुत अधिक कॉम्पैक्ट और पठनीय बन गई है।

यह मस्ती का अंत नहीं है। एक अद्यतन में, ViewPager2 को ItemDecoration के लिए समर्थन मिला: बच्चे को देखने के लिए एक सहायक वर्ग। इस तंत्र का उपयोग तत्वों, सीमाओं, सेल हाइलाइटिंग के बीच विभाजकों को खींचने के लिए किया जा सकता है।

डेकोरेटर्स के पहले से ही बहुत सारे तैयार किए गए कार्यान्वयन हैं, क्योंकि कई सालों से सामान्य रिसाइकल व्यू के साथ काम करते समय उनका सफलतापूर्वक उपयोग किया जाता है। सभी विकास अब पेजर पर लागू होते हैं। बॉक्स से बाहर, पेजर विभाजकों का एक मानक कार्यान्वयन उपलब्ध है:

 main_pager.addItemDecoration( DividerItemDecoration(this, RecyclerView.HORIZONTAL) ) 

मई 2019 में अगले अपडेट के साथ, ViewPager2 ने एक और महत्वपूर्ण तरीका जोड़ा: setOffscreenPageLimit (Int) । वह इस बात के लिए जिम्मेदार है कि केंद्रीय के दाएं और बाएं कितने तत्वों को पेजर में आरंभीकृत किया जाएगा। हालाँकि RecyclerView कैशिंग के लिए ज़िम्मेदार है और डिफ़ॉल्ट रूप से दृश्य प्रदर्शित करने के लिए, इस पद्धति का उपयोग करके आप स्पष्ट रूप से लोड करने के लिए वांछित संख्या सेट कर सकते हैं।

अनुकूलक

पहले पेजर एडाप्टर के वैचारिक उत्तराधिकारी FragmentStateAdapter है : इंटरैक्शन इंटरफेस और क्लास नामकरण लगभग समान हैं। परिवर्तन केवल कुछ विधियों के नामकरण को प्रभावित करते हैं। यदि पहले यह आवश्यक था कि अमूर्त फ़ंक्शन getItem (स्थिति) को लागू किया जाए, तो दिए गए स्थान के लिए वांछित फ़्रैग्मेंट इंस्टेंस को वापस करने के लिए, और इस नामकरण की दो तरह से व्याख्या की जा सकती है, अब इस फ़ंक्शन का नाम बदलकर फ़्रेग्मेंटेशन (स्थिति) बना दिया गया है। गेटकाउंट () फ़ंक्शन द्वारा कुल टुकड़ों की आपूर्ति पहले की तरह की जाती है।

इंटरफ़ेस में महत्वपूर्ण संरचनात्मक परिवर्तनों में से, यह भी ध्यान दिया जाना चाहिए कि एडेप्टर में अब अपने तत्वों के जीवन चक्र को नियंत्रित करने की क्षमता है, इसलिए, कंस्ट्रक्टर में FragmentManager के साथ मिलकर, यह एक जीवनचक्र या किसी गतिविधि या फ्रेगमेंट को स्वीकार करता है। इस वजह से, सुरक्षा के लिए, saveState () और RestoreState () विधियों को अंतिम घोषित किया गया और विरासत के लिए बंद कर दिया गया।
FragmentViewHolder वर्ग RecyclerView के अंदर टुकड़ों को संग्रहीत करने के लिए जिम्मेदार है। OnCreateViewHolder () FragmentStateAdapter की विधि FragmentViewHolder.create () कॉल करती है।

 static FragmentViewHolder create(ViewGroup parent) { FrameLayout container = new FrameLayout(parent.getContext()); container.setLayoutParams( new ViewGroup.LayoutParams( ViewGroup.LayoutParams.MATCH_PARENT, ViewGroup.LayoutParams.MATCH_PARENT ) ); container.setId(ViewCompat.generateViewId()); container.setSaveEnabled(false); return new FragmentViewHolder(container); } 

जब onBindViewHolder () विधि को कॉल किया जाता है , तो वर्तमान स्थिति में तत्व की पहचानकर्ता और ViewHolder पहचानकर्ता जुड़े हुए हैं, इसके टुकड़े को और संलग्न करने के लिए:

 final long itemId = holder.getItemId(); final int viewHolderId = holder.getContainer().getId(); final Long boundItemId = itemForViewHolder(viewHolderId); ... mItemIdToViewHolder.put(itemId, viewHolderId); ensureFragment(position); //   

और अंत में, जब ViewHolder से दृश्य पदानुक्रम में एक कंटेनर संलग्न करते हैं, तो एक FragmentTransaction निष्पादित होता है, कंटेनर में एक Fragment जोड़ते हुए:

 void placeFragmentInViewHolder(@NonNull final FragmentViewHolder holder) { Fragment fragment = mFragments.get(holder.getItemId()); ... scheduleViewAttach(fragment, container); mFragmentManager.beginTransaction() .add(fragment, "f" + holder.getItemId()) .setMaxLifecycle(fragment, STARTED) .commitNow(); ... } 

इस प्रकार, ViewPager2 के दो उपयोग सामने आते हैं : एडेप्टर वर्ग के माध्यम से, या तो सीधे RecyclerView.Adcape से या FragmentStateAdapter से ।

---

निश्चित रूप से आपके पास एक सवाल होगा: फ्रैगमेंट्स के साथ दूसरे पेजर का उपयोग क्यों करें और उनके लिए एक एडेप्टर जब सामान्य रूप से पहले संस्करण में काम करना हो? बड़ी गतिशील डेटा सूचियों के साथ काम करने पर ViewPager "सिल्वर बुलेट" से बहुत दूर है। यह चित्रों या बैनर के स्थिर सेट के साथ हिंडोला बनाने के लिए बहुत अच्छा है, लेकिन विज्ञापन पोस्टों को लोड करने के साथ पृष्ठांकित समाचार फ़ीड करता है, फ़िल्टर हार्ड-सपोर्टेड और बदसूरत राक्षसों को जन्म देता है। जल्दी या बाद में, आप निश्चित रूप से RecyclerView पर सब कुछ फिर से लिखने की एक जलती हुई इच्छा में आ जाएंगे। अब आपको ऐसा करने की ज़रूरत नहीं है, क्योंकि पेजर स्वयं में बदल गया, सामान्य सूचियों में उन्हें लपेटते हुए, गतिशील सूचियों के साथ काम करने के लिए अपनी शक्तिशाली क्षमताओं को उधार लेते हुए।

केवल एक चीज जो पेजर एडेप्टर हमें ऑफर कर सकती है वह है नोटिफाइडडसेटचेंज्ड () विधि, जो व्यूपेजर को सभी प्रदान की गई सूची आइटम को फिर से तैयार करने के लिए मजबूर करती है। आप यथोचित नोटिस कर सकते हैं कि कोई भी हमें मौजूदा तत्वों के लिए पदों की एक सूची संग्रहीत करने और POSITION_UNCHANGED को getItemPosition () विधि से उनके लिए वापस करने से रोक रहा है, बस। हालांकि, इस समाधान को सुंदर नहीं कहा जा सकता है, यह बल्कि बोझिल है, इसके अलावा, उन मामलों पर विस्तार करना मुश्किल है जब सूची में तत्व लगातार बदल रहे हैं, और न केवल क्रमिक रूप से अंत में जोड़ा गया है। FragmentStateAdapter में RecyclerView.Adcape विधियों का पूर्ण शस्त्रागार है, इसलिए तत्वों को फिर से जोड़ने के तर्क को बहुत अधिक लचीले ढंग से कॉन्फ़िगर किया जा सकता है। इसके अलावा, FragmentStateAdapter के साथ , आप डिफ्यूटिल का उपयोग कर सकते हैं, जो आपको परिवर्तनों की अधिसूचना के काम को लगभग पूरी तरह से स्वचालित करने की अनुमति देता है।

चेतावनी! नोटिफ़िकेशन के लिए ... सही तरीके से काम करने के लिए (InformDataSetChanged को छोड़कर), getItemId (Int) और c ontainsItem (लॉन्ग) तरीकों को फिर से परिभाषित किया जाना चाहिए। ऐसा इसलिए किया जाता है क्योंकि डिफ़ॉल्ट कार्यान्वयन केवल पृष्ठ संख्या पर दिखता है, और यदि, उदाहरण के लिए, आप वर्तमान के बाद एक नया तत्व जोड़ते हैं, तो इसे जोड़ा नहीं जाएगा, क्योंकि getItemId अपरिवर्तित रहेगा। Int के तत्वों की सूची के आधार पर इन दोनों विधियों को ओवरराइड करने का एक उदाहरण:

 override fun getItemId(position: Int): Long { return items[position].toLong() } override fun containsItem(itemId: Long): Boolean { return items.contains(itemId.toInt()) } 

---

ViewPager2 की उपस्थिति का मुख्य कारण पहिया को सुदृढ़ करने की अनिच्छा है। एक ओर, AndroidX विकास टीम अप्रचलित ViewPager को छोड़ने के लिए स्पष्ट रूप से तैयार है और निश्चित रूप से अपनी कार्यक्षमता का विस्तार करने के लिए निवेश नहीं करने जा रही है। हाँ, और क्यों? सब के बाद, RecyclerView पहले से ही सब कुछ जानता है जो आवश्यक है। दूसरी ओर, इस तरह के एक व्यापक रूप से इस्तेमाल किए गए घटक के लिए समर्थन को हटाना और समाप्त करना स्पष्ट रूप से सामुदायिक वफादारी को नहीं बढ़ाएगा।

संक्षेप में: ViewPager2 निश्चित रूप से ध्यान देने योग्य है, हालांकि फिलहाल यह गंभीर खामियों के बिना नहीं है।

विपक्ष

• नमी और कीड़े की एक बड़ी संख्या (बीटा संस्करण के लिए बहाना);
• निकटता। RecyclerView ViewPager2 का एक निजी क्षेत्र है, जो हमें कई अवसरों से वंचित करता है: स्वाइप-टू-बर्खास्त करना या ड्रैग-एन-ड्रॉप को लागू करना असंभव है ( ItemTouchHelper सीधे RecyclerView से जुड़ता है), आप किसी भी तरह से ItemAnimator को फिर से परिभाषित नहीं कर सकते हैं, लेआउटमैन का सीधे उपयोग न करें और पुनर्नवीनीकरण दृश्य का उपयोग करें। हालांकि, घटक के नए संस्करणों की रिहाई के साथ, RecyclerView से विरासत में मिली इंटरफ़ेस विधियों की संख्या बढ़ रही है (उदाहरण के लिए, आइटमडेक्यूलेशन ), और हम भविष्य में लापता तरीकों को जोड़ने की उम्मीद कर सकते हैं।

आकर्षण आते हैं

• RecyclerView के सभी फायदों के लिए समर्थन। एडेप्टर : एक सूची में विभिन्न प्रकार के तत्वों का संयोजन, स्वाइप के दौरान तत्वों को सीधे जोड़ने और हटाने के लिए, बदलते समय सूची की सामग्री का अनुप्रेक्षण;
• अधिसूचित के पूर्ण स्पेक्ट्रम के लिए समर्थन ... विवर्तनिक का उपयोग करके परिवर्तनों की विधियाँ और स्वचालित गणना;
• वाक्य रचना की निरंतरता के कारण संक्रमण में आसानी;
• ऊर्ध्वाधर और क्षैतिज अभिविन्यास के लिए समर्थन "बॉक्स से बाहर";
• RTL समर्थन;
• सपोर्ट आइटम ;
• नकली स्क्रॉल के माध्यम से सॉफ़्टवेयर स्क्रॉलिंग के लिए समर्थन () ;
• मैन्युअल रूप से लोड की गई वस्तुओं की संख्या निर्धारित करने की क्षमता;
• बॉयलरप्लेट कोड को कम करने के लिए किसी भी तैयार-ओपन-सोर्स समाधान का उपयोग करने की क्षमता, जो कस्टम RecyclerView.Adcape लिखते समय अपरिहार्य है। उदाहरण के लिए, EasyAdapter ।

सारांश के रूप में, मैं कहना चाहता हूं कि ViewPager2 वास्तव में एक करीब से देखने लायक है। यह एक आशाजनक, एक्स्टेंसिबल और कार्यात्मक समाधान है। और यद्यपि उत्पादन में एक नया विजेट लॉन्च करना बहुत जल्दी है, यह कहना सुरक्षित है कि पूर्ण रिलीज के बाद यह अपने पूर्वजों को पूरी तरह से दबा सकता है और करना चाहिए।

उन साहसी और निर्णायक, जिनके लिए प्रयोग करने के लिए प्रेरित लेख, PagerSnapHelper समर्थन लाइब्रेरी के 28 वें संस्करण में दिखाई दिया, जिसका अर्थ है कि आप ViewPager2 को स्वयं बनाकर अपने RecyclerView के साथ मिलकर इसका उपयोग कर सकते हैं।

ViewPager2 और FragmentStateAdapter का नमूना संचालन।

आधिकारिक रिलीज़-नोट्स ViewPager2