萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android Menu 功能選單設計完整實作指南

選單類型概覽

  • Options Menu (選項選單):主 Activity 工具列/溢出選單,由 onCreateOptionsMenu 建立,onOptionsItemSelected 處理點擊。
  • Context Menu (上下文選單):長按 View 觸發,registerForContextMenu、onCreateContextMenu、onContextItemSelected。
  • Popup Menu (彈出選單):任意 View 錨點彈出,PopupMenu 類別,API 11+。

Options Menu 完整實作 (Kotlin)

class MainActivity : AppCompatActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContentView(R.layout.activity_main)
    }

    // 1. 膨脹選單資源
    override fun onCreateOptionsMenu(menu: Menu): Boolean {
        menuInflater.inflate(R.menu.main_menu, menu)
        return true
    }

    // 2. 處理點擊
    override fun onOptionsItemSelected(item: MenuItem): Boolean {
        return when (item.itemId) {
            R.id.action_about -> { showAboutDialog(); true }
            R.id.action_settings -> { startActivity(Intent(this, SettingsActivity::class.java)); true }
            R.id.action_logout -> { authRepository.logout(); true }
            else -> super.onOptionsItemSelected(item)
        }
    }
}

選單資源檔 (res/menu/main_menu.xml)

<menu xmlns:android="https://schemas.android.com/apk/res/android"
    xmlns:app="https://schemas.android.com/apk/res-auto">

    <item
        android:id="@+id/action_about"
        android:title="@string/about"
        android:icon="@drawable/ic_info"
        app:showAsAction="never" />

    <item
        android:id="@+id/action_settings"
        android:title="@string/settings"
        android:icon="@drawable/ic_settings"
        app:showAsAction="ifRoom" />

    <item
        android:id="@+id/action_logout"
        android:title="@string/logout"
        android:icon="@drawable/ic_logout"
        app:showAsAction="never" />
</menu>

關鍵屬性說明

屬性說明
android:id唯一識別碼,R.id.xxx 供程式碼引用
android:title顯示文字,支援字串資源引用
android:icon圖示 (可選)
app:showAsActionnever (溢出選單)、ifRoom (有空間顯示於 Toolbar)、always (強制顯示)、withText (顯示文字)
android:enabled是否啟用
android:visible是否可見
android:checkable可勾選 (單選/多選)
android:actionLayout自定義 Action View (如 SearchView、Spinner)

動態修改選單

override fun onPrepareOptionsMenu(menu: Menu): Boolean {
    val loginItem = menu.findItem(R.id.action_login)
    val logoutItem = menu.findItem(R.id.action_logout)
    val isLoggedIn = authRepository.isLoggedIn()
    loginItem.isVisible = !isLoggedIn
    logoutItem.isVisible = isLoggedIn
    return super.onPrepareOptionsMenu(menu)
}

// 需要立即刷新時呼叫
invalidateOptionsMenu()

Context Menu 實作要點

override fun onCreate(savedInstanceState: Bundle?) {
    super.onCreate(savedInstanceState)
    registerForContextMenu(recyclerView)  // 為 View 註冊
}

override fun onCreateContextMenu(menu: ContextMenu, v: View, menuInfo: ContextMenu.ContextMenuInfo) {
    super.onCreateContextMenu(menu, v, menuInfo)
    menuInflater.inflate(R.menu.context_menu, menu)
    // 可根據 menuInfo (如 AdapterContextMenuInfo.position) 動態調整
}

override fun onContextItemSelected(item: MenuItem): Boolean {
    val info = item.menuInfo as AdapterView.AdapterContextMenuInfo
    val position = info.position
    return when (item.itemId) {
        R.id.action_edit -> { editItem(position); true }
        R.id.action_delete -> { deleteItem(position); true }
        else -> super.onContextItemSelected(item)
    }
}

Material Design 3 時代建議

  • 使用 MaterialToolbar + NavigationView (抽屜導航) 取代傳統 Options Menu。
  • 底部導航欄 (NavigationBarView) 承載主要目的地。
  • 選單項圖示採用 MaterialIcons (Outlined/Filled/Rounded/Sharp) 保持視覺一致性。
  • 啟用 MenuHost/MenuProvider (Lifecycle 2.5+) 在 Fragment 中獨立管理選單生命週期,避免 Activity 單體膨脹。

掌握選單資源宣告、生命週期回呼、動態更新與現代架構整合,打造直覺好用的導覽體驗。

copyright © 萬盛學電腦網 all rights reserved