แสดงการนำทางกลับที่กำหนดเอง

การนำทางย้อนกลับคือวิธีที่ผู้ใช้ย้อนกลับไปยังประวัติหน้าจอที่เคยเข้าชมก่อนหน้านี้ อุปกรณ์ Android ทั้งหมดมีปุ่มย้อนกลับสำหรับการไปยังส่วนต่างๆ ประเภทนี้ ดังนั้นอย่าเพิ่มปุ่มย้อนกลับลงใน UI ของแอป ปุ่มนี้อาจเป็นปุ่มจริงหรือปุ่มซอฟต์แวร์ก็ได้ ทั้งนี้ขึ้นอยู่กับอุปกรณ์ที่ใช้ Android ของผู้ใช้

Android จะเก็บรักษา Back Stack ของปลายทางไว้ขณะที่ผู้ใช้ไปยังส่วนต่างๆ ของแอปพลิเคชัน ซึ่งจะช่วยให้ Android นำทางไปยังปลายทางก่อนหน้าได้อย่างถูกต้องเมื่อกดปุ่มย้อนกลับ อย่างไรก็ตาม มีบางกรณีที่แอปอาจต้องใช้ลักษณะการทำงานของปุ่มย้อนกลับของตนเองเพื่อมอบประสบการณ์การใช้งานที่ดีที่สุดแก่ผู้ใช้

ตัวอย่างเช่น เมื่อใช้ WebView คุณอาจต้องการลบล้างลักษณะการทำงานของปุ่มย้อนกลับเริ่มต้นเพื่อให้ผู้ใช้ไปยังส่วนต่างๆ ย้อนกลับผ่านประวัติการท่องเว็บแทนหน้าจอก่อนหน้าในแอป

Android 13 ขึ้นไปมีท่าทางสัมผัสการย้อนกลับที่คาดการณ์ได้สำหรับอุปกรณ์ Android ดูข้อมูลเพิ่มเติมเกี่ยวกับฟีเจอร์นี้ได้ที่เพิ่มการรองรับท่าทางสัมผัสการย้อนกลับที่คาดการณ์ได้

ใช้การนำทางย้อนกลับที่กำหนดเอง

ComponentActivity ซึ่งเป็นคลาสพื้นฐานสำหรับ FragmentActivity และ AppCompatActivity ช่วยให้คุณควบคุมลักษณะการทำงานของปุ่มย้อนกลับได้โดยใช้ OnBackPressedDispatcher ซึ่งคุณสามารถเรียกข้อมูลได้โดยการเรียกใช้ getOnBackPressedDispatcher()

OnBackPressedDispatcher จะควบคุมวิธีส่งเหตุการณ์ปุ่มย้อนกลับไปยังออบเจ็กต์ OnBackPressedCallback อย่างน้อย 1 รายการ ตัวสร้างสำหรับ OnBackPressedCallback จะใช้บูลีนสำหรับสถานะเปิดใช้เริ่มต้น เมื่อเปิดใช้ Callback (นั่นคือ isEnabled แสดงผลเป็น true) Dispatcher จะเรียกใช้ handleOnBackPressed ของ Callback เพื่อจัดการเหตุการณ์ปุ่มย้อนกลับ คุณเปลี่ยนสถานะการเปิดใช้ได้โดยเรียกใช้ setEnabled

ระบบจะเพิ่ม Callback โดยใช้เมธอด addCallback เราขอแนะนำให้ใช้เมธอด addCallback() ซึ่งใช้ LifecycleOwner ซึ่งจะช่วยให้มั่นใจได้ว่าระบบจะเพิ่ม OnBackPressedCallback ก็ต่อเมื่อ LifecycleOwner มีค่าเป็น Lifecycle.State.STARTED เท่านั้น นอกจากนี้ กิจกรรมยังนำ Callback ที่ลงทะเบียนไว้ออกเมื่อ LifecycleOwner ที่เชื่อมโยงถูกทำลาย ซึ่งจะช่วยป้องกันหน่วยความจำรั่วไหลและทำให้ LifecycleOwner เหมาะสำหรับการใช้งานใน Fragment หรือเจ้าของวงจรอื่นๆ ที่มีอายุการใช้งานสั้นกว่ากิจกรรม

ตัวอย่างการใช้งาน Callback มีดังนี้

Kotlin

class MyFragment : Fragment() {

    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)

        // This callback is only called when MyFragment is at least started
        val callback = requireActivity().onBackPressedDispatcher.addCallback(this) {
            // Handle the back button event
        }

        // The callback can be enabled or disabled here or in the lambda
    }
    ...
}

Java

public class MyFragment extends Fragment {

    @Override
    public void onCreate(@Nullable Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);

        // This callback is only called when MyFragment is at least started
        OnBackPressedCallback callback = new OnBackPressedCallback(true /* enabled by default */) {
            @Override
            public void handleOnBackPressed() {
                // Handle the back button event
            }
        };
        requireActivity().getOnBackPressedDispatcher().addCallback(this, callback);

        // The callback can be enabled or disabled here or in handleOnBackPressed()
    }
    ...
}

คุณระบุ Callback ได้หลายรายการโดยใช้ addCallback() เมื่อดำเนินการดังกล่าว ระบบจะเรียกใช้ Callback ตามลำดับย้อนกลับจากลำดับที่คุณเพิ่ม Callback โดย Callback ที่เพิ่มล่าสุดจะเป็น Callback แรกที่ได้รับโอกาสในการจัดการเหตุการณ์ปุ่มย้อนกลับ ตัวอย่างเช่น หากคุณเพิ่ม Callback 3 รายการชื่อ one, two และ three ตามลำดับ ระบบจะเรียกใช้ Callback ตามลำดับ three, two, one

Callback จะเป็นไปตามรูปแบบ Chain of Responsibility ระบบจะเรียกใช้ Callback แต่ละรายการในเชนก็ต่อเมื่อไม่ได้เปิดใช้ Callback ก่อนหน้า ซึ่งหมายความว่าในตัวอย่างก่อนหน้านี้ ระบบจะเรียกใช้ Callback two ก็ต่อเมื่อไม่ได้เปิดใช้ Callback three และจะเรียกใช้ Callback one ก็ต่อเมื่อไม่ได้เปิดใช้ Callback two

โปรดทราบว่าเมื่อเพิ่ม Callback โดยใช้ addCallback() ระบบจะไม่เพิ่ม Callback ลงในเชนความรับผิดชอบจนกว่า LifecycleOwner จะเข้าสู่สถานะ Lifecycle.State.STARTED

เราขอแนะนำให้เปลี่ยนสถานะที่เปิดใช้ใน OnBackPressedCallback สำหรับการเปลี่ยนแปลงชั่วคราว เนื่องจากการดำเนินการดังกล่าวจะคงลำดับที่อธิบายไว้ข้างต้น ซึ่งสำคัญอย่างยิ่งหากคุณมี Callback ที่ลงทะเบียนไว้ในเจ้าของวงจรที่ซ้อนกันหลายราย

ในกรณีที่ต้องการนำ OnBackPressedCallback ออกทั้งหมด คุณสามารถโทรหา remove() ได้ โดยปกติแล้วขั้นตอนนี้ไม่จำเป็น เนื่องจากระบบจะนำ Callback ออกโดยอัตโนมัติเมื่อLifecycleOwnerที่เชื่อมโยงถูกทำลาย

Activity onBackPressed()

หากคุณใช้ onBackPressed() เพื่อจัดการเหตุการณ์ปุ่มย้อนกลับ เราขอแนะนำให้ใช้ OnBackPressedCallback แทน อย่างไรก็ตาม หากคุณไม่สามารถทำการเปลี่ยนแปลงนี้ได้ จะมีกฎต่อไปนี้บังคับใช้

  • ระบบจะประเมิน Callback ทั้งหมดที่ลงทะเบียนโดยใช้ addCallback เมื่อคุณเรียกใช้ super.onBackPressed()
  • ใน Android 12 (ระดับ API 32) และต่ำกว่า ระบบจะเรียกใช้ onBackPressed เสมอ ไม่ว่าจะมีอินสแตนซ์ที่ลงทะเบียนของ OnBackPressedCallback หรือไม่ก็ตาม