फ़्रैगमेंट, उपयोगकर्ता के मॉड्यूलर हिस्से को दिखाता है का इस्तेमाल किया जा सकता है. फ़्रैगमेंट का अपना लाइफ़साइकल होता है और यह खुद के इनपुट इवेंट होते हैं और आपके पास फ़्रैगमेंट को जोड़ने या हटाने के लिए, गतिविधि चल रही है.
इस दस्तावेज़ में फ़्रैगमेंट बनाने और उसे किसी गतिविधि में शामिल करने का तरीका बताया गया है.
अपना एनवायरमेंट सेट अप करें
फ़्रैगमेंट को इस पर निर्भरता की ज़रूरत होती है:
AndroidX फ़्रैगमेंट लाइब्रेरी. आपको ये काम करने होंगे
Google Maven रिपॉज़िटरी जोड़ना
आपके प्रोजेक्ट की settings.gradle
फ़ाइल में जोड़ा जा सकता है, ताकि इस डिपेंडेंसी को शामिल किया जा सके.
ग्रूवी
dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() ... } }
Kotlin
dependencyResolutionManagement { repositoriesMode.set(RepositoriesMode.FAIL_ON_PROJECT_REPOS) repositories { google() ... } }
अपने प्रोजेक्ट में AndroidX फ़्रैगमेंट लाइब्रेरी शामिल करने के लिए, ये जोड़ें
आपके ऐप्लिकेशन की build.gradle
फ़ाइल पर डिपेंडेंसी:
Groovy
dependencies { def fragment_version = "1.8.2" // Java language implementation implementation "androidx.fragment:fragment:$fragment_version" // Kotlin implementation "androidx.fragment:fragment-ktx:$fragment_version" }
Kotlin
dependencies { val fragment_version = "1.8.2" // Java language implementation implementation("androidx.fragment:fragment:$fragment_version") // Kotlin implementation("androidx.fragment:fragment-ktx:$fragment_version") }
फ़्रैगमेंट क्लास बनाना
फ़्रैगमेंट बनाने के लिए, AndroidX बढ़ाएं
Fragment
क्लास, और बदलें
आपके ऐप्लिकेशन के लॉजिक को इंसर्ट करने के तरीके, वैसे ही जैसे
Activity
क्लास. मिनिमम
वह फ़्रैगमेंट जो अपने लेआउट को तय करता है, अपने फ़्रैगमेंट का लेआउट रिसॉर्स दें
को बेस कंस्ट्रक्टर से बदल दें, जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है:
Kotlin
class ExampleFragment : Fragment(R.layout.example_fragment)
Java
class ExampleFragment extends Fragment { public ExampleFragment() { super(R.layout.example_fragment); } }
फ़्रैगमेंट लाइब्रेरी में, खास तरह के फ़्रैगमेंट बेस क्लास भी उपलब्ध होती हैं:
DialogFragment
- फ़्लोटिंग डायलॉग बॉक्स दिखाता है. डायलॉग बनाने के लिए इस क्लास का इस्तेमाल करना अच्छा है
यह डायलॉग बॉक्स में डायलॉग हेल्पर के तरीके का इस्तेमाल करने के बजाय
फ़्रैगमेंट के तौर पर
Activity
क्लासDialog
की बनाने और क्लीनअप की प्रोसेस अपने-आप मैनेज करती है.DialogFragment
के साथ डायलॉग दिखाना देखें ज़्यादा जानकारी के लिए. PreferenceFragmentCompat
- इनका क्रम दिखाता है
Preference
ऑब्जेक्ट सूची.PreferenceFragmentCompat
का इस्तेमाल इन कामों के लिए किया जा सकता है अपने ऐप्लिकेशन के लिए, सेटिंग की स्क्रीन बनाएं.
किसी गतिविधि में कोई फ़्रैगमेंट जोड़ें
आम तौर पर, आपका फ़्रैगमेंट किसी AndroidX में एम्बेड होना चाहिए
FragmentActivity
से
यूज़र इंटरफ़ेस (यूआई) का कोई हिस्सा उस गतिविधि के लेआउट में जोड़ सकता है. FragmentActivity
अभी तक किसी भी व्यक्ति ने चेक इन नहीं किया है
यह इसकी बेस क्लास है:
AppCompatActivity
,
इसलिए, अगर आपने पुराना डेटा डालने के लिए पहले से ही AppCompatActivity
को सब-क्लास किया हुआ है
साथ काम करता है, तो आपको अपनी गतिविधि में बदलाव करने की ज़रूरत नहीं है
बेस क्लास.
आप चाहें, तो अपने फ़्रैगमेंट को ऐक्टिविटी के व्यू हैरारकी (व्यू और व्यू ग्रुप के लेआउट का क्रम) में या तो जोड़ दें
फ़्रैगमेंट की परिभाषा तय करके
फ़्रैगमेंट कंटेनर में और फिर
प्रोग्राम बनाकर अपनी गतिविधि में फ़्रैगमेंट जोड़ना. दोनों ही मामलों में, आपको
जोड़ें
FragmentContainerView
वह जगह तय करता है जहां फ़्रैगमेंट को
गतिविधि के व्यू हैरारकी (व्यू और व्यू ग्रुप के लेआउट का क्रम) के हिसाब से. हमारा सुझाव है कि आप हमेशा
फ़्रैगमेंट के कंटेनर के तौर पर FragmentContainerView
, जैसा
FragmentContainerView
में ऐसे फ़्रैगमेंट के सुधार शामिल हैं जिन्हें अन्य
FrameLayout
जैसे व्यू ग्रुप उपलब्ध नहीं कराते.
एक्सएमएल के ज़रिए फ़्रैगमेंट जोड़ें
अपनी गतिविधि के लेआउट के एक्सएमएल में, साफ़ तौर पर कोई फ़्रैगमेंट जोड़ने के लिए,
FragmentContainerView
एलिमेंट.
यहां ऐक्टिविटी लेआउट का एक उदाहरण दिया गया है, जिसमें एक
FragmentContainerView
:
<!-- res/layout/example_activity.xml -->
<androidx.fragment.app.FragmentContainerView
xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/fragment_container_view"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:name="com.example.ExampleFragment" />
android:name
एट्रिब्यूट, Fragment
की क्लास का नाम
इंस्टैंशिएट करें. जब गतिविधि का लेआउट इनफ़्लेट होता है, तो बताया गया फ़्रैगमेंट
इंस्टैंशिएट किया जाता है,
onInflate()
को नए इंस्टैंशिएट किए गए फ़्रैगमेंट पर कॉल किया जाता है और FragmentTransaction
FragmentManager
में फ़्रैगमेंट जोड़ने के लिए बनाया गया है.
प्रोग्राम के हिसाब से फ़्रैगमेंट जोड़ना
प्रोग्राम के हिसाब से अपनी गतिविधि के लेआउट में कोई फ़्रैगमेंट जोड़ने के लिए, लेआउट
फ़्रैगमेंट कंटेनर के तौर पर काम करने के लिए, इसमें FragmentContainerView
शामिल होना चाहिए,
जैसा कि नीचे दिए गए उदाहरण में दिखाया गया है:
<!-- res/layout/example_activity.xml -->
<androidx.fragment.app.FragmentContainerView
xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/fragment_container_view"
android:layout_width="match_parent"
android:layout_height="match_parent" />
एक्सएमएल वाले तरीके के उलट, android:name
एट्रिब्यूट का इस्तेमाल
FragmentContainerView
यहां है, इसलिए कोई भी खास फ़्रैगमेंट अपने-आप नहीं बदलता है
इंस्टैंशिएट किया हुआ. इसके बजाय,
FragmentTransaction
का इस्तेमाल किसी फ़्रैगमेंट को इंस्टैंशिएट करने और उसे गतिविधि के लेआउट में जोड़ने के लिए किया जाता है.
अपनी गतिविधि के दौरान, फ़्रैगमेंट ट्रांज़ैक्शन किए जा सकते हैं, जैसे कि
कोई फ़्रैगमेंट जोड़ना, हटाना या बदलना. अपने FragmentActivity
में, ये काम किए जा सकते हैं
उदाहरण के तौर पर,
FragmentManager
, जो
FragmentTransaction
बनाने के लिए इस्तेमाल किया जा सकता है. इसके बाद, इंस्टैंशिएट किया जा सकता है
फ़्रैगमेंट, इसका इस्तेमाल करके आपकी गतिविधि के onCreate()
तरीके में
FragmentTransaction.add()
,
आपके लेआउट और फ़्रैगमेंट में कंटेनर का ViewGroup
आईडी पास कर रहे हैं
क्लास को जोड़ना चाहते हैं और फिर लेन-देन करना चाहते हैं, जैसा कि
नीचे दिया गया उदाहरण:
Kotlin
class ExampleActivity : AppCompatActivity(R.layout.example_activity) { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) if (savedInstanceState == null) { supportFragmentManager.commit { setReorderingAllowed(true) add<ExampleFragment>(R.id.fragment_container_view) } } } }
Java
public class ExampleActivity extends AppCompatActivity { public ExampleActivity() { super(R.layout.example_activity); } @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); if (savedInstanceState == null) { getSupportFragmentManager().beginTransaction() .setReorderingAllowed(true) .add(R.id.fragment_container_view, ExampleFragment.class, null) .commit(); } } }
पिछले उदाहरण में, ध्यान दें कि फ़्रैगमेंट ट्रांज़ैक्शन सिर्फ़ बनाया गया है
जब savedInstanceState
, null
हो. इससे यह पक्का होता है कि फ़्रैगमेंट
गतिविधि पहली बार बनाने पर, इसे सिर्फ़ एक बार जोड़ा जाता है. जब
कॉन्फ़िगरेशन में बदलाव होता है और गतिविधि को फिर से बनाया जाता है,
savedInstanceState
अब null
नहीं है, और फ़्रैगमेंट को इसकी ज़रूरत नहीं है
दूसरी बार जोड़ा जाना चाहिए, क्योंकि फ़्रैगमेंट अपने-आप पहले जैसा हो जाता है
savedInstanceState
से मिला डेटा.
अगर आपके फ़्रैगमेंट को कुछ शुरुआती डेटा की ज़रूरत है, तो FragmentTransaction.add()
को कॉल करते समय Bundle
देकर, आपके फ़्रैगमेंट में आर्ग्युमेंट पास किए जा सकते हैं, जैसा कि यहां दिखाया गया है:
Kotlin
class ExampleActivity : AppCompatActivity(R.layout.example_activity) { override fun onCreate(savedInstanceState: Bundle?) { super.onCreate(savedInstanceState) if (savedInstanceState == null) { val bundle = bundleOf("some_int" to 0) supportFragmentManager.commit { setReorderingAllowed(true) add<ExampleFragment>(R.id.fragment_container_view, args = bundle) } } } }
Java
public class ExampleActivity extends AppCompatActivity { public ExampleActivity() { super(R.layout.example_activity); } @Override protected void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); if (savedInstanceState == null) { Bundle bundle = new Bundle(); bundle.putInt("some_int", 0); getSupportFragmentManager().beginTransaction() .setReorderingAllowed(true) .add(R.id.fragment_container_view, ExampleFragment.class, bundle) .commit(); } } }
इसके बाद तर्क Bundle
आपके फ़्रैगमेंट में से इसके ज़रिए वापस लाए जा सकते हैं
कॉल किया जा रहा है
requireArguments()
,
साथ ही, डेटा वापस पाने के लिए सही Bundle
गेटर तरीकों का इस्तेमाल किया जा सकता है
का इस्तेमाल करें.
Kotlin
class ExampleFragment : Fragment(R.layout.example_fragment) { override fun onViewCreated(view: View, savedInstanceState: Bundle?) { val someInt = requireArguments().getInt("some_int") ... } }
Java
class ExampleFragment extends Fragment { public ExampleFragment() { super(R.layout.example_fragment); } @Override public void onViewCreated(@NonNull View view, Bundle savedInstanceState) { int someInt = requireArguments().getInt("some_int"); ... } }
यह भी देखें:
फ़्रैगमेंट ट्रांज़ैक्शन और FragmentManager
के बारे में ज़्यादा जानकारी दी गई है
फ़्रैगमेंट मैनेजर गाइड में जाएं.