सूचियों की मदद से उपयोगकर्ता, Wear OS डिवाइसों पर आसानी से उपलब्ध विकल्पों में से कोई आइटम चुन सकते हैं.
पहने जाने वाले डिवाइस की यूज़र इंटरफ़ेस (यूआई) लाइब्रेरी में
WearableRecyclerView
क्लास, जो
RecyclerView
पहने जाने वाले डिवाइसों के लिए ऑप्टिमाइज़ की गई सूचियां बनाने के लिए लागू किया गया. आप इसका इस्तेमाल कर सकते हैं
इंटरफ़ेस करने के लिए एक नया WearableRecyclerView
कंटेनर बनाएं.
WearableRecyclerView
का इस्तेमाल करके
सामान्य आइटम की लंबी सूची, जैसे कि ऐप्लिकेशन लॉन्चर या संपर्कों की सूची. हर आइटम शायद
में एक छोटी स्ट्रिंग और एक आइकॉन होता है. इसके अलावा, हर आइटम के लिए सिर्फ़
या कोई आइकॉन शामिल करें.
ध्यान दें: जटिल लेआउट इस्तेमाल न करें. इस सुविधा का इस्तेमाल करने के लिए, लोगों को सिर्फ़ आपके आइटम की झलक देखनी चाहिए, यह समझना कि वह क्या है, खास तौर पर पहने जाने वाले डिवाइसों पर' सीमित स्क्रीन साइज़.
मौजूदा RecyclerView
क्लास को आगे बढ़ाने का मतलब है कि WearableRecyclerView
एपीआई, डिफ़ॉल्ट रूप से सीधी सूची में मौजूद आइटम की ऐसी सूची दिखाते हैं जिसे वर्टिकल तरीके से स्क्रोल किया जा सकता हो. Google आपके यूआरएल पैरामीटर को कैसे इस्तेमाल करेगा, यह तय करने के लिए
घुमावदार लेआउट के लिए ऑप्ट-इन करने के लिए WearableRecyclerView
एपीआई और
गोलाकार स्क्रोल करने का जेस्चर
आपके पहने जाने वाले ऐप्लिकेशन में.
![](https://developer.android.com/static/wear/images/06_uilib.png?authuser=8&hl=hi)
पहला डायग्राम. Wear OS पर डिफ़ॉल्ट सूची के तौर पर देखें.
इस गाइड में, WearableRecyclerView
क्लास इस्तेमाल करने का तरीका बताया गया है
Wear OS ऐप्लिकेशन में सूचियों की सूची, घुमावदार लेआउट के लिए ऑप्ट-इन करने का तरीका
और वे आइटम जिन्हें स्क्राेल किया जा सकता है, उनके रंग-रूप को
स्क्रोल करते समय बच्चों को दिखाया जा सकता है.
एक्सएमएल का इस्तेमाल करके, किसी गतिविधि में WearableRecyclerView को जोड़ना
यह लेआउट किसी गतिविधि में WearableRecyclerView
जोड़ता है:
<androidx.wear.widget.WearableRecyclerView xmlns:android="http://schemas.android.com/apk/res/android" xmlns:tools="http://schemas.android.com/tools" android:id="@+id/recycler_launcher_view" android:layout_width="match_parent" android:layout_height="match_parent" android:scrollbars="vertical" />
यहां दिए गए उदाहरण में, WearableRecyclerView
को दिखाया गया है
किसी गतिविधि पर लागू किया जाता है:
Kotlin
class MainActivity : Activity() { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) setContentView(R.layout.activity_main) } ... }
Java
public class MainActivity extends Activity { @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); setContentView(R.layout.activity_main); } ... }
घुमावदार लेआउट बनाना
![](https://developer.android.com/static/wear/images/wrv_new.gif?authuser=8&hl=hi)
पहने जाने वाले अपने ऐप्लिकेशन में, स्क्रोल किए जा सकने वाले आइटम का कर्व्ड लेआउट बनाने के लिए, यह तरीका अपनाएं:
-
का उपयोग करें
संबंधित एक्सएमएल लेआउट में, आपके मुख्य कंटेनर के तौर पर
WearableRecyclerView
को एक्सपोर्ट किया जा सकता है. -
सेट करें
true
के लिएsetEdgeItemsCenteringEnabled(boolean)
तरीका. यह सूची के पहले और आखिरी आइटम को वर्टिकल तौर पर सेंटर करता है. -
लेआउट सेट करने के लिए
WearableRecyclerView.setLayoutManager()
तरीके का इस्तेमाल करें आइटम.
Kotlin
wearableRecyclerView.apply { // To align the edge children (first and last) with the center of the screen. isEdgeItemsCenteringEnabled = true ... layoutManager = WearableLinearLayoutManager(this@MainActivity) }
Java
// To align the edge children (first and last) with the center of the screen. wearableRecyclerView.setEdgeItemsCenteringEnabled(true); ... wearableRecyclerView.setLayoutManager( new WearableLinearLayoutManager(this));
अगर आपके ऐप्लिकेशन में स्क्रोल करते समय बच्चों के रंग-रूप को पसंद के मुताबिक बनाने की कुछ खास शर्तें हैं—उदाहरण के लिए,
जब आइटम बीच से दूर स्क्रोल कर रहे हों, तब आइकॉन और टेक्स्ट को स्केल करना—बड़ा करें
WearableLinearLayoutManager.LayoutCallback
क्लास का इस्तेमाल करें और इसे बदलें
onLayoutFinished
तरीका.
नीचे दिए गए कोड स्निपेट, आइटम की स्क्रोलिंग को स्केल करने के लिए पसंद के मुताबिक बनाने का एक उदाहरण दिखाते हैं
केंद्र से दूर जाने के लिए
WearableLinearLayoutManager.LayoutCallback
क्लास:
Kotlin
/** How much icons should scale, at most. */ private const val MAX_ICON_PROGRESS = 0.65f class CustomScrollingLayoutCallback : WearableLinearLayoutManager.LayoutCallback() { private var progressToCenter: Float = 0f override fun onLayoutFinished(child: View, parent: RecyclerView) { child.apply { // Figure out % progress from top to bottom. val centerOffset = height.toFloat() / 2.0f / parent.height.toFloat() val yRelativeToCenterOffset = y / parent.height + centerOffset // Normalize for center. progressToCenter = Math.abs(0.5f - yRelativeToCenterOffset) // Adjust to the maximum scale. progressToCenter = Math.min(progressToCenter, MAX_ICON_PROGRESS) scaleX = 1 - progressToCenter scaleY = 1 - progressToCenter } } }
Java
public class CustomScrollingLayoutCallback extends WearableLinearLayoutManager.LayoutCallback { /** How much icons should scale, at most. */ private static final float MAX_ICON_PROGRESS = 0.65f; private float progressToCenter; @Override public void onLayoutFinished(View child, RecyclerView parent) { // Figure out % progress from top to bottom. float centerOffset = ((float) child.getHeight() / 2.0f) / (float) parent.getHeight(); float yRelativeToCenterOffset = (child.getY() / parent.getHeight()) + centerOffset; // Normalize for center. progressToCenter = Math.abs(0.5f - yRelativeToCenterOffset); // Adjust to the maximum scale. progressToCenter = Math.min(progressToCenter, MAX_ICON_PROGRESS); child.setScaleX(1 - progressToCenter); child.setScaleY(1 - progressToCenter); } }
Kotlin
wearableRecyclerView.layoutManager = WearableLinearLayoutManager(this, CustomScrollingLayoutCallback())
Java
CustomScrollingLayoutCallback customScrollingLayoutCallback = new CustomScrollingLayoutCallback(); wearableRecyclerView.setLayoutManager( new WearableLinearLayoutManager(this, customScrollingLayoutCallback));