ใช้มุมมองการดำเนินการและผู้ให้บริการการดำเนินการ

ลองใช้วิธีแบบ Compose

Jetpack Compose เป็นชุดเครื่องมือ UI ที่แนะนำสำหรับ Android ดูวิธีเพิ่มคอมโพเนนต์ใน Compose

แถบแอป →

หมายเหตุ: เพื่อแนวทางและประสบการณ์ของผู้ใช้ที่ดียิ่งขึ้น ให้พิจารณาย้ายข้อมูลโปรเจ็กต์ ไปยัง Jetpack Compose ทีละน้อย

ไลบรารี AndroidX Toolbar มี วิธีต่างๆ ให้ผู้ใช้โต้ตอบกับแอป เพิ่มและจัดการการดำเนินการอธิบายวิธี กำหนดการดำเนินการ ซึ่งอาจเป็นปุ่มหรือรายการเมนู เอกสารนี้อธิบายวิธีเพิ่มคอมโพเนนต์อเนกประสงค์ 2 รายการต่อไปนี้

• มุมมองการดำเนินการคือการดำเนินการที่มีฟังก์ชันการทำงานที่หลากหลายภายในแถบแอป ตัวอย่างเช่น มุมมองการดำเนินการค้นหาช่วยให้ผู้ใช้พิมพ์ข้อความค้นหาในแถบแอปได้โดยไม่ต้องเปลี่ยนกิจกรรมหรือ Fragment
• ผู้ให้บริการการดำเนินการคือการดำเนินการที่มีเลย์เอาต์ที่กำหนดเอง การดำเนินการจะปรากฏเป็นปุ่มหรือรายการเมนูในตอนแรก เมื่อผู้ใช้แตะการดำเนินการ ผู้ให้บริการการดำเนินการจะควบคุม ลักษณะการทำงานของการดำเนินการตามที่คุณกำหนด เช่น ผู้ให้บริการการดำเนินการอาจตอบสนองต่อการแตะโดยแสดงเมนู

AndroidX มีวิดเจ็ตมุมมองการดำเนินการและวิดเจ็ตผู้ให้บริการการดำเนินการเฉพาะทางหลายรายการ เช่น SearchViewวิดเจ็ต จะใช้มุมมองการดำเนินการเพื่อป้อนคำค้นหา วิดเจ็ต ShareActionProvider จะใช้ผู้ให้บริการการดำเนินการเพื่อแชร์ข้อมูลกับแอปอื่นๆ นอกจากนี้ คุณยังกำหนด มุมมองการดำเนินการและผู้ให้บริการการดำเนินการของคุณเองได้ด้วย

เพิ่มมุมมองการดำเนินการ

หากต้องการเพิ่มมุมมองการดำเนินการ ให้สร้างองค์ประกอบ <item> ในทรัพยากรเมนูของแถบเครื่องมือตามที่อธิบายไว้ใน เพิ่มและจัดการการดำเนินการ เพิ่มแอตทริบิวต์ต่อไปนี้อย่างใดอย่างหนึ่งลงในองค์ประกอบ <item>

• actionViewClass: คลาสของวิดเจ็ตที่ใช้การดำเนินการ
• actionLayout: ทรัพยากรเลย์เอาต์ที่อธิบายคอมโพเนนต์ของการดำเนินการ

ตั้งค่าแอตทริบิวต์ showAsAction เป็น "ifRoom|collapseActionView" หรือ "never|collapseActionView" แฟล็ก collapseActionView จะระบุวิธี แสดงวิดเจ็ตเมื่อผู้ใช้ไม่ได้โต้ตอบกับวิดเจ็ต หากวิดเจ็ตอยู่ในแถบแอป แอปจะแสดงวิดเจ็ตเป็นไอคอน หากวิดเจ็ตอยู่ในเมนูรายการเพิ่มเติม แอปจะแสดงวิดเจ็ต เป็นรายการเมนู เมื่อผู้ใช้โต้ตอบกับมุมมองการดำเนินการ มุมมองจะขยายเพื่อเติมเต็มแถบแอป

ตัวอย่างเช่น โค้ดต่อไปนี้จะเพิ่มSearchViewวิดเจ็ตลงในแถบแอป

<item android:id="@+id/action_search"
     android:title="@string/action_search"
     android:icon="@drawable/ic_search"
     app:showAsAction="ifRoom|collapseActionView"
     app:actionViewClass="androidx.appcompat.widget.SearchView" />

หากผู้ใช้ไม่ได้โต้ตอบกับวิดเจ็ต แอปจะแสดงวิดเจ็ตเป็นไอคอนตามที่ระบุโดย android:icon หากไม่มีที่ว่างในแถบแอป แอปจะเพิ่มการดำเนินการลงในเมนูรายการเพิ่มเติม

รูปที่ 1 แถบค้นหาที่มีไอคอนนำหน้าและไอคอนต่อท้าย

เมื่อผู้ใช้แตะไอคอนหรือรายการเมนู วิดเจ็ตจะขยายเพื่อเติมแถบเครื่องมือ ทำให้ผู้ใช้โต้ตอบกับวิดเจ็ตได้

รูปที่ 2 มุมมองการค้นหาจะเปิดขึ้นเมื่อโฟกัสที่แถบค้นหา

หากต้องการกําหนดค่าการกระทํา ให้ทําใน onCreateOptionsMenu() การเรียกกลับของกิจกรรม คุณรับการอ้างอิงออบเจ็กต์ของมุมมองการดำเนินการได้โดยการเรียกใช้เมธอด getActionView() ตัวอย่างเช่น โค้ดต่อไปนี้จะรับการอ้างอิงออบเจ็กต์สำหรับวิดเจ็ต SearchView ที่กำหนดไว้ในตัวอย่างโค้ดก่อนหน้า

Kotlin

override fun onCreateOptionsMenu(menu: Menu?): Boolean {
    menuInflater.inflate(R.menu.main_activity_actions, menu)

    val searchItem = menu?.findItem(R.id.action_search)
    val searchView = searchItem?.actionView as SearchView

    // Configure the search info and add any event listeners.

    return super.onCreateOptionsMenu(menu)
}

Java

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    getMenuInflater().inflate(R.menu.main_activity_actions, menu);

    MenuItem searchItem = menu.findItem(R.id.action_search);
    SearchView searchView =
            (SearchView) searchItem.getActionView();

    // Configure the search info and add any event listeners.

    return super.onCreateOptionsMenu(menu);
}

หมายเหตุ: หากต้องการปรับปรุงรูปลักษณ์และความรู้สึกสำหรับ SearchView โปรดดู คอมโพเนนต์การค้นหาใน Material Design 3

ตอบสนองต่อการขยายมุมมองการดำเนินการ

หากองค์ประกอบ <item> ของการดำเนินการมีแฟล็ก collapseActionView แอปจะแสดงมุมมองการดำเนินการเป็นไอคอนจนกว่าผู้ใช้จะโต้ตอบกับมุมมองการดำเนินการ เมื่อผู้ใช้ แตะไอคอน ตัวแฮนเดิลในตัวสำหรับ onOptionsItemSelected() จะขยายมุมมองการดำเนินการ หากคลาสย่อยของกิจกรรมแทนที่เมธอด onOptionsItemSelected() เมธอดแทนที่ต้องเรียกใช้ super.onOptionsItemSelected() เพื่อให้คลาสหลักขยายมุมมองการดำเนินการได้

หากต้องการทำบางอย่างเมื่อขยายหรือยุบการดำเนินการ คุณสามารถกำหนดคลาสที่ ใช้ MenuItem.OnActionExpandListener และส่งสมาชิกของคลาสนั้นไปยัง setOnActionExpandListener() เช่น คุณอาจต้องการอัปเดตกิจกรรมตามว่ามุมมองการดำเนินการขยายหรือยุบอยู่ ข้อมูลโค้ดต่อไปนี้แสดงวิธีกำหนดและส่ง Listener

Kotlin

override fun onCreateOptionsMenu(menu: Menu?): Boolean {
    menuInflater.inflate(R.menu.options, menu)

    // Define the listener.
    val expandListener = object : MenuItem.OnActionExpandListener {
        override fun onMenuItemActionCollapse(item: MenuItem): Boolean {
            // Do something when the action item collapses.
            return true // Return true to collapse the action view.
        }

        override fun onMenuItemActionExpand(item: MenuItem): Boolean {
            // Do something when it expands.
            return true // Return true to expand the action view.
        }
    }

    // Get the MenuItem for the action item.
    val actionMenuItem = menu?.findItem(R.id.myActionItem)

    // Assign the listener to that action item.
    actionMenuItem?.setOnActionExpandListener(expandListener)

    // For anything else you have to do when creating the options menu,
    // do the following:

    return true
}

Java

@Override
public boolean onCreateOptionsMenu(Menu menu) {
    getMenuInflater().inflate(R.menu.options, menu);

    // Define the listener.
    OnActionExpandListener expandListener = new OnActionExpandListener() {
        @Override
        public boolean onMenuItemActionCollapse(MenuItem item) {
            // Do something when the action item collapses.
            return true;  // Return true to collapse action view.
        }

        @Override
        public boolean onMenuItemActionExpand(MenuItem item) {
            // Do something when it expands.
            return true;  // Return true to expand the action view.
        }
    };

    // Get the MenuItem for the action item.
    MenuItem actionMenuItem = menu.findItem(R.id.myActionItem);

    // Assign the listener to that action item.
    MenuItemCompat.setOnActionExpandListener(actionMenuItem, expandListener);

    // For anything else you have to do when creating the options menu,
    // do the following:

    return true;
}

เพิ่มผู้ให้บริการการดำเนินการ

หากต้องการประกาศผู้ให้บริการการดำเนินการ ให้สร้างองค์ประกอบ <item> ในเมนูของแถบเครื่องมือ ทรัพยากร ตามที่อธิบายไว้ในเพิ่มและจัดการการดำเนินการ เพิ่มแอตทริบิวต์ actionProviderClass แล้วตั้งค่าเป็นชื่อคลาสที่มีคุณสมบัติครบถ้วนสำหรับ คลาสผู้ให้บริการการดำเนินการ

ตัวอย่างเช่น โค้ดต่อไปนี้ประกาศ ShareActionProvider ซึ่งเป็นวิดเจ็ต ที่กำหนดไว้ในไลบรารี AndroidX ซึ่งช่วยให้แอปแชร์ข้อมูลกับแอปอื่นๆ ได้

<item android:id="@+id/action_share"
    android:title="@string/share"
    app:showAsAction="ifRoom"
    app:actionProviderClass="androidx.appcompat.widget.ShareActionProvider"/>

ในกรณีนี้ ไม่จำเป็นต้องประกาศไอคอนสำหรับวิดเจ็ต เนื่องจาก ShareActionProvider มีกราฟิกของตัวเอง หากใช้การดำเนินการที่กำหนดเอง ให้ประกาศไอคอน

แหล่งข้อมูลเพิ่มเติม

• ดู ShareActionProvider ตัวอย่างการเพิ่มการดำเนินการแชร์ลงในแถบแอปด้านบน
• ดูข้อมูลเพิ่มเติมเกี่ยวกับการสร้างผู้ให้บริการการดำเนินการที่กำหนดเองได้ที่ ActionProvider