रीफ़्रेश करने के अनुरोध का जवाब देना

'लिखें' सुविधा आज़माएं

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

लिखने के लिए इस्तेमाल होने वाले टूल में, नीचे की ओर खींचकर रीफ़्रेश करें →

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

रीफ़्रेश करने के जेस्चर का जवाब देना

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

अपने ऐप्लिकेशन में रीफ़्रेश जेस्चर का जवाब देने के लिए, SwipeRefreshLayout.OnRefreshListener इंटरफ़ेस और उसका onRefresh() तरीका लागू करें. जब उपयोगकर्ता स्वाइप जेस्चर करता है, तो onRefresh() तरीका चालू होता है.

अपडेट करने के लिए किए जाने वाले असली ऑपरेशन का कोड, किसी अलग तरीके में डालें. आम तौर पर, इसे ViewModel में डालें. साथ ही, अपडेट करने के उस तरीके को अपने onRefresh() लागू करने से कॉल करें. इस तरह, जब उपयोगकर्ता ऐक्शन बार से रीफ़्रेश को ट्रिगर करता है, तो अपडेट करने के लिए उसी तरीके का इस्तेमाल किया जा सकता है.

डेटा अपडेट होने के बाद, अपडेट करने के तरीके में setRefreshing(false) को कॉल करें. इस तरीके को कॉल करने से, SwipeRefreshLayout को प्रोग्रेस इंडिकेटर हटाने और व्यू के कॉन्टेंट को अपडेट करने का निर्देश मिलता है.

उदाहरण के लिए, यहां दिया गया कोड onRefresh() को लागू करता है और ListView से दिखाए गए डेटा को अपडेट करने के लिए, myUpdateOperation() तरीके को लागू करता है:

Kotlin

// Sets up a SwipeRefreshLayout.OnRefreshListener that invokes when
// the user performs a swipe-to-refresh gesture.

mySwipeRefreshLayout.setOnRefreshListener {
    Log.i(LOG_TAG, "onRefresh called from SwipeRefreshLayout")

    // This method performs the actual data-refresh operation and calls
    // setRefreshing(false) when it finishes.
    myUpdateOperation()
}

Java

// Sets up a SwipeRefreshLayout.OnRefreshListener that is invoked when
// the user performs a swipe-to-refresh gesture.

mySwipeRefreshLayout.setOnRefreshListener(() -> {
    Log.i(LOG_TAG, "onRefresh called from SwipeRefreshLayout");

    // This method performs the actual data-refresh operation and calls
    // setRefreshing(false) when it finishes.
    myUpdateOperation();
  }
);

रीफ़्रेश करने की कार्रवाई का जवाब देना

अगर उपयोगकर्ता ऐक्शन बार का इस्तेमाल करके रीफ़्रेश करने का अनुरोध करता है, तो सिस्टम onOptionsItemSelected() तरीके को कॉल करता है. आपका ऐप्लिकेशन इस कॉल का जवाब, प्रोग्रेस इंडिकेटर दिखाकर और ऐप्लिकेशन का डेटा रीफ़्रेश करके देता है.

रीफ़्रेश करने की कार्रवाई का जवाब देने के लिए, onOptionsItemSelected() को बदलें. अपने बदलाव करने के तरीके में, true वैल्यू के साथ setRefreshing() को कॉल करके, SwipeRefreshLayout प्रोग्रेस इंडिकेटर को ट्रिगर करें. इसके बाद, अपडेट करने का ऑपरेशन करें. असल अपडेट को किसी अलग तरीके से करें, ताकि उपयोगकर्ता स्वाइप करके अपडेट ट्रिगर करे या ऐक्शन बार का इस्तेमाल करे, तो एक ही तरीका इस्तेमाल किया जा सके. अपडेट पूरा होने के बाद, रीफ़्रेश की प्रोग्रेस दिखाने वाला इंडिकेटर हटाने के लिए setRefreshing(false) को कॉल करें.

नीचे दिए गए कोड में, अनुरोध कार्रवाई का जवाब देने का तरीका बताया गया है:

Kotlin

// Listen for option item selections to receive a notification when the user
// requests a refresh by selecting the refresh action bar item.

override fun onOptionsItemSelected(item: MenuItem): Boolean {
    when (item.itemId) {

        // Check whether the user triggers a refresh:
        R.id.menu_refresh -> {
            Log.i(LOG_TAG, "Refresh menu item selected")

            // Signal SwipeRefreshLayout to start the progress indicator.
            mySwipeRefreshLayout.isRefreshing = true

            // Start the refresh background task. This method calls
            // setRefreshing(false) when it finishes.
            myUpdateOperation()

            return true
        }
    }

    // User doesn't trigger a refresh. Let the superclass handle this action.
    return super.onOptionsItemSelected(item)
}

Java

// Listen for option item selections to receive a notification when the user
// requests a refresh by selecting the refresh action bar item.

@Override
public boolean onOptionsItemSelected(MenuItem item) {
    switch (item.getItemId()) {

        // Check whether the user triggers a refresh:
        case R.id.menu_refresh:
            Log.i(LOG_TAG, "Refresh menu item selected");

            // Signal SwipeRefreshLayout to start the progress indicator.
            mySwipeRefreshLayout.setRefreshing(true);

            // Start the refresh background task. This method calls
            // setRefreshing(false) when it finishes.
            myUpdateOperation();

            return true;
    }

    // User doesn't trigger a refresh. Let the superclass handle this action.
    return super.onOptionsItemSelected(item);
}