onCreateOptionsMenu 建立,onOptionsItemSelected 處理點擊。registerForContextMenu、onCreateContextMenu、onContextItemSelected。PopupMenu 類別,API 11+。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)
}
}
}
<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:showAsAction | never (溢出選單)、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()
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)
}
}
MaterialToolbar + NavigationView (抽屜導航) 取代傳統 Options Menu。NavigationBarView) 承載主要目的地。MaterialIcons (Outlined/Filled/Rounded/Sharp) 保持視覺一致性。MenuHost/MenuProvider (Lifecycle 2.5+) 在 Fragment 中獨立管理選單生命週期,避免 Activity 單體膨脹。掌握選單資源宣告、生命週期回呼、動態更新與現代架構整合,打造直覺好用的導覽體驗。