【Android】【UI】Menu

XML代码&＃xff1a;

上面的代码实现了一个三级子菜单结构。理论上来说&＃xff0c;子菜单的层级是没有限制的。但是在实际应用中&＃xff0c;由于移动设备的显示特点&＃xff0c;建议菜单层级不要超过两层&＃xff0c;否则会给用户的操作带来诸多不便。

效果截图&＃xff1a;

Activity&＃43;Fragment构建的选项菜单

在前面&＃xff0c;我们都是在Activity中加载Menu资源&＃xff0c;实际上在Fragment中同样也可以做到这一点。如果Activity和Fragment都加载了Menu资源&＃xff0c;那么这些菜单项将合并到一起。系统将首先显示Activity加载的菜单项&＃xff0c;随后按每个Fragment添加到Activity中的顺序显示各Fragment的菜单项。如果有必要&＃xff0c;可以使用的orderInCategory属性&＃xff0c;对菜单项重新排序。

实际上&＃xff0c;在Fragment中加载Menu的方式和Activity几乎一致&＃xff0c;同样需要重写onCreateOptionsMenu和onOptionsItemSelected方法。当然&＃xff0c;Fragment中的onCreateOptionsMenu方法有所不同&＃xff0c;如下所示&＃xff1a;

&＃64;Override
public onCreateOptionsMenu(Menu menu, MenuInflater inflater) {inflater.inflate(R.menu.option_menu_fragment_2,menu);
}

还需要注意&＃xff0c;要让Fragment中的菜单项显示出来&＃xff0c;还需要在Fragment中调用setHasOptionsMenu(true)方法。传入true作为参数表明Fragment需要加载菜单项。建议在Fragment的onCreate方法中调用这个方法&＃xff0c;如下所示&＃xff1a;

&＃64;Override
public onCreate(&＃64;Nullable Bundle savedInstanceState) {super.onCreate(savedInstanceState);setHasOptionsMenu();
}

当菜单项发生点击事件时&＃xff0c;如果Activity包括Fragment&＃xff0c;则系统将依次为Activity和每个Fragment&＃xff08;按照每个Fragment的添加顺序&＃xff09;调用onOptionsItemSelected方法&＃xff0c;直到有一个返回结果为true或所有Fragment都调用完毕为止。因此&＃xff0c;无论是Activity还是Fragment&＃xff0c;onOptionsItemSelected方法中的switch语句块中的default分支都不要直接返回true&＃xff0c;而应该使用return super.onOptionsItemSelected(item)&＃xff0c;避免截断了菜单项的点击事件。

说明&＃xff1a;详细代码可以参考下文提供的demo。

在运行时修改的选项菜单

系统调用onCreateOptionsMenu方法后&＃xff0c;将保留创建的Menu实例。除非菜单由于某些原因而失效&＃xff0c;否则不会再次调用onCreateOptionsMenu。因此&＃xff0c;我们只应该使用onCreateOptionsMenu来创建初始菜单状态&＃xff0c;而不应使用它在Activity生命周期中对菜单执行任何更改。

如果需要根据在Activity生命周期中发生的某些事件修改选项菜单&＃xff0c;则应该通过onPrepareOptionsMenu方法实现。这个方法的参数中有一个Menu对象&＃xff08;即旧的Menu对象&＃xff09;&＃xff0c;我们可以使用它对菜单执行修改&＃xff0c;如添加、移除、启用或禁用菜单项。&＃xff08;Fragment同样提供onPrepareOptionsMenu方法&＃xff0c;只是不需要提供返回值&＃xff09;

需要注意&＃xff0c;在Android 3.0及更高版本中&＃xff0c;当菜单项显示在应用栏中时&＃xff0c;选项菜单被视为始终处于打开状态。发生事件时&＃xff0c;如果要执行菜单更新&＃xff0c;则必须调用 invalidateOptionsMenu来请求系统调用onPrepareOptionsMenu方法。

下面我们提供一个简单的例子。在这个例子中&＃xff1a;点击下一步后&＃xff0c;上一步会被启用&＃xff0c;下一步会被禁用&＃xff1b;点击上一步后&＃xff0c;下一步会被启用&＃xff0c;上一步会被禁用。这是许多应用中常见的场景&＃xff0c;代码如下&＃xff1a;

XML代码&＃xff1a;

我们在XML中定义了两个菜单项&＃xff0c;默认启用下一步&＃xff0c;禁用上一步。

Java代码&＃xff1a;

private boolean isShowNext&＃61;;//当前是否显示[下一步]
......
&＃64;Override
public boolean onCreateOptionsMenu(Menu menu) {getMenuInflater().inflate(R.menu.option_menu_change,menu);return ;
}&＃64;Override
public boolean onPrepareOptionsMenu(Menu menu) {(isShowNext){//根据标识值判断当前应该启用哪个菜单项menu.findItem(R.id.option_menu_next).setEnabled();menu.findItem(R.id.option_menu_previous).setEnabled(false);}{menu.findItem(R.id.option_menu_previous).setEnabled();menu.findItem(R.id.option_menu_next).setEnabled(false);}return ;
}&＃64;Override
public boolean onOptionsItemSelected(MenuItem item) {switch (item.getItemId()){R.id.option_menu_next:isShowNext&＃61;false;invalidateOptionsMenu();//通知系统刷新Menureturn ;R.id.option_menu_previous:isShowNext&＃61;;invalidateOptionsMenu();//通知系统刷新Menureturn ;default:return super.onOptionsItemSelected(item);}
}

在代码中&＃xff0c;我们使用isShowNext这个布尔值标识当前可用的菜单项。在onOptionsItemSelected方法中&＃xff0c;每次菜单项被点击后&＃xff0c;我们会更改isShowNext&＃xff0c;同时调用invalidateOptionsMenu通知系统刷新Menu。之后&＃xff0c;onPrepareOptionsMenu会被调用。在这个方法中&＃xff0c;我们根据isShowNext的值启用、禁用菜单项。可以看到&＃xff0c;这里使用了Menu的findItem方法&＃xff0c;它可以根据的id获取对应的MenuItem对象&＃xff0c;方法原型如下&＃xff1a;

public MenuItem findItem( id);

此外&＃xff0c;还可以使用Menu的add方法添加新的菜单项&＃xff08;有多个重载方法&＃xff09;。

效果截图&＃xff1a;

使用公有父类构建选项菜单

如果应用包含多个Activity&＃xff0c;且其中某些Activity具有相同的选项菜单&＃xff0c;则可考虑创建一个仅实现onCreateOptionsMenu和 onOptionsItemSelected方法的Activity。然后&＃xff0c;将这个Activity作为每个具有相同选项菜单的Activity的父类。通过这种方式&＃xff0c;每个子类均会继承父类的菜单行为。下面给出一个简单的例子&＃xff1a;

父类Activity中的XML代码&＃xff1a;

父类Activity中的Java代码&＃xff1a;

&＃64;Override
public boolean onCreateOptionsMenu(Menu menu) {getMenuInflater().inflate(R.menu.option_menu_parent,menu);return ;
}&＃64;Override
public boolean onOptionsItemSelected(MenuItem item) {switch (item.getItemId()){R.id.option_menu_parent:Toast.makeText(,"父类菜单项",Toast.LENGTH_SHORT).show();return ;default:return super.onOptionsItemSelected(item);}
}

子类Activity中的XML代码&＃xff1a;

子类Activity中的Java代码&＃xff1a;

&＃64;Override
public boolean onCreateOptionsMenu(Menu menu) {super.onCreateOptionsMenu(menu);//调用这一句保证父类的菜单项可以正常加载getMenuInflater().inflate(R.menu.option_menu_child,menu);//加载子类自己的菜单项return ;
}&＃64;Override
public boolean onOptionsItemSelected(MenuItem item) {switch (item.getItemId()){R.id.option_menu_child:Toast.makeText(,"子类菜单项",Toast.LENGTH_SHORT).show();return ;default:return super.onOptionsItemSelected(item);}
}

可以看到&＃xff0c;大部分代码都和创建普通的选项菜单一致。需要注意&＃xff0c;在子类Activity的onCreateOptionsMenu方法中&＃xff0c;我们首先调用了super.onCreateOptionsMenu(menu)&＃xff0c;保证父类的菜单项可以正常加载。然后&＃xff0c;才对子类自己的菜单项进行加载。最终的效果就是在子类Activity中&＃xff0c;既有父类的菜单项&＃xff0c;也有自己的菜单项。

需要注意&＃xff0c;在子类的onOptionsItemSelected方法的default分支中&＃xff0c;我们调用了父类的方法super.onOptionsItemSelected(item)。这是为了保证父类菜单项的点击行为可以被正确执行。当然&＃xff0c;如果我们想要改变父类菜单项的行为&＃xff0c;也可以在switch语句块中添加case进行重写。

效果截图&＃xff1a;

上下文菜单及上下文操作模式

上下文菜单

通常上下文菜单是以浮动菜单的形式呈现的&＃xff0c;用户长按&＃xff08;按住&＃xff09;一个支持上下文菜单的View时&＃xff0c;菜单将以浮动列表的形式出现&＃xff08;类似于对话框&＃xff09;。 通常用户一次可对一个项目执行上下文操作&＃xff08;比如一个单独的控件或列表中的一项&＃xff09;。

要提供浮动上下文菜单&＃xff0c;可以参照以下步骤&＃xff1a;

1. 在Activity或Fragment中调用registerForContextMenu(View v)方法&＃xff0c;注册需要和上下文菜单关联的View。如果将ListView或GridView作为参数传入&＃xff0c;那么每个列表项将会有相同的浮动上下文菜单。
2. 在Activity或Fragment中重写onCreateContextMenu方法&＃xff0c;加载Menu资源。
3. 在Activity或Fragment中重写onContextItemSelected方法&＃xff0c;实现菜单项的点击逻辑。

下面&＃xff0c;我们演示如何为ListView设置浮动上下文菜单&＃xff1a;

XML代码&＃xff1a;

Java代码&＃xff1a;

&＃64;Override
protected onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_context_menu);//初始化ListViewListView listView&＃61; (ListView) findViewById(R.id.list_context_menu);ArrayAdapter adapter&＃61; ArrayAdapter(,android.R.layout.simple_list_item_1,createDataList());listView.setAdapter(adapter);//为ListView注册上下文浮动菜单registerForContextMenu(listView);
}//生成测试数据List
private List createDataList(){List list&＃61; ArrayList<>();( i&＃61;;i<;i&＃43;&＃43;){list.add("测试条目"&＃43;i);}return list;
}&＃64;Override
public onCreateContextMenu(ContextMenu menu, View v, ContextMenu.ContextMenuInfo menuInfo) {super.onCreateContextMenu(menu, v, menuInfo);MenuInflater inflater&＃61;getMenuInflater();inflater.inflate(R.menu.context_menu,menu);
}&＃64;Override
public boolean onContextItemSelected(MenuItem item) {switch (item.getItemId()){R.id.context_option_add:Toast.makeText(,,Toast.LENGTH_SHORT).show();return ;R.id.context_option_save:Toast.makeText(,,Toast.LENGTH_SHORT).show();return ;R.id.context_option_delete:Toast.makeText(,,Toast.LENGTH_SHORT).show();return ;default:return super.onContextItemSelected(item);}
}

在onCreateContextMenu方法中&＃xff0c;方法参数包括用户所选的View&＃xff0c;以及一个提供有关所选项目的附加信息的ContextMenu.ContextMenuInfo对象。如果需要为多个View设置不同的上下文菜单&＃xff0c;则可使用这些参数确定要加载的上下文菜单资源。

在onContextItemSelected方法中&＃xff0c;成功处理菜单项的监听事件后&＃xff0c;系统将返回true。需要注意在default分支中&＃xff0c;应该调用super.onContextItemSelected(item)。如果Activity包括Fragment&＃xff0c;则系统将依次为Activity和每个Fragment&＃xff08;按照每个Fragment的添加顺序&＃xff09;调用onContextItemSelected方法&＃xff0c;直到有一个返回结果为true或所有Fragment都调用完毕为止。

效果截图&＃xff1a;

上下文操作模式

上下文操作模式是ActionMode的系统实现&＃xff0c;它将在屏幕顶部&＃xff08;菜单栏区域&＃xff09;显示上下文操作栏&＃xff0c;其中包括影响所选项目的多种菜单项&＃xff08;通过加载Menu资源&＃xff09;。当启动这个模式时&＃xff0c;用户可以同时对多个项目执行操作&＃xff08;批处理&＃xff09;。

当用户取消选择所有项目、按“返回”按钮或选择操作栏左侧的“完成”操作时&＃xff0c;该操作模式将会结束&＃xff0c;同时上下文操作栏会消失。

上下文操作模式的使用很灵活&＃xff0c;既可以为单个View配置&＃xff0c;也可以为ListView或GridView配置&＃xff08;允许用户选择多个项目并针对所有项目执行相应操作&＃xff09;。下面我们给出两个例子来说明上下文操作模式的使用。

1.为ListView设置上下文操作模式

简单来说&＃xff0c;为ListView设置上下文操作模式可以分为两步&＃xff1a;

1. 使用CHOICE_MODE_MULTIPLE_MODAL参数调用ListView的setChoiceMode方法。
2. 实现AbsListView.MultiChoiceModeListener接口&＃xff0c;并调用ListView的setMultiChoiceModeListener方法为ListView设置该接口。在这个接口的回调方法中&＃xff0c;可以为上下文操作栏加载Menu资源&＃xff0c;也可以响应操作项目的点击事件&＃xff0c;还可以处理其他需要的操作。

下面给出相应的关键代码&＃xff1a;

XML代码&＃xff1a;

Java代码&＃xff1a;

&＃64;Override
protected onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_context_mode);//初始化ListViewfinal ListView listView&＃61; (ListView) findViewById(R.id.list_context_menu);ArrayAdapter adapter&＃61; ArrayAdapter(,android.R.layout.simple_list_item_1,createDataList());listView.setAdapter(adapter);//为ListView配置上下文操作模式listView.setChoiceMode(ListView.CHOICE_MODE_MULTIPLE_MODAL);listView.setMultiChoiceModeListener( AbsListView.MultiChoiceModeListener() {&＃64;Overridepublic onItemCheckedStateChanged(ActionMode mode, position, id, boolean checked) {//当列表中的项目选中或取消勾选时&＃xff0c;这个方法会被触发//可以在这个方法中做一些更新操作&＃xff0c;比如更改上下文操作栏的标题//这里显示已选中的项目数mode.setTitle("已选中&＃xff1a;"&＃43;listView.getCheckedItemCount()&＃43;);}&＃64;Overridepublic boolean onCreateActionMode(ActionMode mode, Menu menu) {MenuInflater inflater&＃61;mode.getMenuInflater();inflater.inflate(R.menu.context_mode_menu,menu);return ;}&＃64;Overridepublic boolean onActionItemClicked(ActionMode mode, MenuItem item) {switch (item.getItemId()){R.id.context_mode_email:Toast.makeText(ContextModeActivity.,"email",Toast.LENGTH_SHORT).show();mode.finish();//关闭上下文操作栏return ;R.id.context_mode_key:Toast.makeText(ContextModeActivity.,"key",Toast.LENGTH_SHORT).show();mode.finish();return ;default:return false;}}&＃64;Overridepublic boolean onPrepareActionMode(ActionMode mode, Menu menu) {//可以对上下文操作栏做一些更新操作&＃xff08;会被ActionMode的invalidate方法触发&＃xff09;return false;}&＃64;Overridepublic onDestroyActionMode(ActionMode mode) {//在上下文操作栏被移除时会触发&＃xff0c;可以对Activity做一些必要的更新//默认情况下&＃xff0c;此时所有的选中项将会被取消选中}});
}//生成测试数据List
private List createDataList(){List list&＃61; ArrayList<>();( i&＃61;;i<;i&＃43;&＃43;){list.add("测试条目"&＃43;i);}return list;
}

在AbsListView.MultiChoiceModeListener接口中&＃xff0c;最重要的就是onCreateActionMode和onActionItemClicked两个方法。前者用于加载上下文操作模式的Menu资源&＃xff0c;后者则实现菜单项的点击逻辑。需要注意&＃xff0c;在onActionItemClicked中处理完相应的逻辑后&＃xff0c;应该调用mode.finish&＃xff0c;以便关闭上下文操作栏。

效果截图&＃xff1a;

2.为单个View设置上下文操作模式

为单个View设置上下文操作模式同样可以分为两步&＃xff1a;

1. 实现ActionMode.Callback接口。在这个接口的回调方法中&＃xff0c;可以为上下文操作栏加载Menu资源&＃xff0c;也可以响应操作项目的点击事件&＃xff0c;还可以处理其他需要的操作。
2. 当需要显示操作栏时&＃xff08;例如&＃xff0c;用户长按视图&＃xff09;&＃xff0c;调用Activity的startActionMode方法&＃xff0c;并传入前面创建的Callback对象作为参数。

下面给出相应的关键代码&＃xff1a;

private ActionMode actionMode;//在全局范围保存上下文操作模式实例&＃64;Override
protected onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_single_context_mode);//实现ActionMode.CallBack接口final ActionMode.Callback callback&＃61; ActionMode.Callback() {&＃64;Overridepublic boolean onCreateActionMode(ActionMode mode, Menu menu) {MenuInflater inflater&＃61;mode.getMenuInflater();inflater.inflate(R.menu.context_mode_menu,menu);return ;}&＃64;Overridepublic boolean onActionItemClicked(ActionMode mode, MenuItem item) {switch (item.getItemId()){R.id.context_mode_email:Toast.makeText(SingleContextModeActivity.,"email",Toast.LENGTH_SHORT).show();mode.finish();//关闭上下文操作栏return ;R.id.context_mode_key:Toast.makeText(SingleContextModeActivity.,"key",Toast.LENGTH_SHORT).show();mode.finish();return ;default:return false;}}&＃64;Overridepublic boolean onPrepareActionMode(ActionMode mode, Menu menu) {return false;}&＃64;Overridepublic onDestroyActionMode(ActionMode mode) {actionMode&＃61;;//取消保存的ActionMode实例&＃xff0c;避免影响下一次ActionMode的创建}};//为按钮配置上下文操作模式findViewById(R.id.context_mode_view).setOnLongClickListener( View.OnLongClickListener() {&＃64;Overridepublic boolean onLongClick(View v) {(actionMode!&＃61;){return false;}actionMode&＃61;startActionMode(callback);v.setSelected();//设置View的状态为选中return ;}});
}

上面的大部分代码都和为ListView设置上下文操作模式一致。只是在onDestroyActionMode方法中&＃xff0c;执行了actionMode&＃61;null&＃xff0c;这是为了避免影响下一次ActionMode的创建。此外&＃xff0c;我们为目标View设置了OnLongClickListener&＃xff0c;在回调方法中为全局范围的ActionMode赋值&＃xff0c;并调用setSelected(true)方法设置View的状态为选中。

需要说明的是&＃xff0c;ListView中的项目在选中后呈现的状态&＃xff08;一般会使用深色强调选中项&＃xff09;&＃xff0c;需要在Adapter中单独配置。在上面的例子中并没有实现这一步&＃xff0c;因此选中多项后ListView的外观并不会发生变化。

效果截图&＃xff1a;

PopupMenu是依赖View存在的模态菜单。如果空间足够&＃xff0c;它将显示在相应View的下方&＃xff0c;否则显示在其上方。可以将弹出菜单的使用拆分为以下四个步骤&＃xff1a;

1. 实例化PopupMenu&＃xff0c;它的构造方法需要两个参数&＃xff0c;分别为Context以及PopupMenu依赖的View对象。
2. 使用MenuInflater将Menu资源加载到PopupMenu.getMenu()返回的Menu对象中。
3. 调用setOnMenuItemClickListener方法为PopupMenu设置点击监听器。
4. 调用PopupMenu.show()将弹出菜单显示出来。

下面给出一个简单的例子&＃xff1a;

XML代码&＃xff1a;

Java代码&＃xff1a;

&＃64;Override
protected onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_popup_menu);findViewById(R.id.popup_menu_view).setOnClickListener( View.OnClickListener() {&＃64;Overridepublic onClick(View view) {PopupMenu popupMenu&＃61; PopupMenu(PopupMenuActivity.,view);//1.实例化PopupMenugetMenuInflater().inflate(R.menu.popup_menu,popupMenu.getMenu());//2.加载Menu资源//3.为弹出菜单设置点击监听popupMenu.setOnMenuItemClickListener( PopupMenu.OnMenuItemClickListener() {&＃64;Overridepublic boolean onMenuItemClick(MenuItem item) {switch (item.getItemId()){R.id.popup_add:Toast.makeText(PopupMenuActivity.,,Toast.LENGTH_SHORT).show();return ;R.id.popup_delete:Toast.makeText(PopupMenuActivity.,,Toast.LENGTH_SHORT).show();return ;R.id.popup_more:Toast.makeText(PopupMenuActivity.,,Toast.LENGTH_SHORT).show();return ;default:return false;}}});popupMenu.show();//4.显示弹出菜单}});
}

当用户选择菜单项或触摸菜单以外的区域时&＃xff0c;系统就会清除弹出菜单&＃xff0c;可以使用PopupMenu.OnDismissListener监听这一事件。

效果截图&＃xff1a;

我们在前面曾经提到过这种元素&＃xff0c;使用可以对菜单项进行分组。对于同一个中的&＃xff0c;可以通过menu执行以下操作&＃xff1a;

• 使用setGroupVisible显示或隐藏组内的所有项目
• 使用setGroupEnabled启用或禁用组内的所有项目
• 使用setGroupCheckable指定组内的所有项目是否可选中

这三个方法的原型如下&＃xff1a;

public setGroupVisible( group, boolean visible);
public setGroupEnabled( group, boolean enabled);
public setGroupCheckable( group, boolean checkable, boolean exclusive);

参数中的group指的是元素的id属性。此外&＃xff0c;setGroupCheckable方法中的exclusive用于设置菜单项的选择模式。如果exclusive为true&＃xff0c;代表菜单项为单选模式&＃xff0c;否则为多选模式。

需要注意&＃xff0c;只是一种逻辑上的分组&＃xff0c;并不会影响的外观和级别。此外&＃xff0c;系统也绝不会分离已分组的项目。例如&＃xff0c;如果为同一组内的每个声明android:showAsAction&＃61;"ifRoom"&＃xff0c;则它们会同时显示在操作栏或操作溢出菜单中。

下面是一个简单的例子&＃xff1a;

可选中的菜单项

如果为指定checkableBehavior属性&＃xff0c;则可以为组内项目实现单选或多选的选择模式。checkableBehavior有三种可选值&＃xff1a;

• single&＃xff1a;组中只有一个项目可以选中&＃xff08;单选按钮&＃xff09;
• all&＃xff1a;所有项目均可选中&＃xff08;复选框&＃xff09;
• none&＃xff1a;所有项目均无法选中

下面给出一个简单的例子&＃xff1a;

XML代码&＃xff1a;

Java代码&＃xff1a;

&＃64;Override
protected onCreate(Bundle savedInstanceState) {super.onCreate(savedInstanceState);setContentView(R.layout.activity_menu_group);//为按钮注册上下文菜单Button button&＃61; (Button) findViewById(R.id.group_menu_view);registerForContextMenu(button);
}&＃64;Override
public onCreateContextMenu(ContextMenu menu, View v, ContextMenu.ContextMenuInfo menuInfo) {super.onCreateContextMenu(menu, v, menuInfo);getMenuInflater().inflate(R.menu.group_menu,menu);
}&＃64;Override
public boolean onContextItemSelected(MenuItem item) {switch (item.getItemId()){R.id.group_menu_normal:R.id.group_menu_item_1:R.id.group_menu_item_2:R.id.group_menu_item_3:R.id.group_menu_item_4:(item.isChecked()){//更改菜单项的选中状态item.setChecked(false);}{item.setChecked();}Toast.makeText(,item.getTitle(),Toast.LENGTH_SHORT).show();return ;default:return super.onContextItemSelected(item);}
}

效果截图&＃xff1a;

项目demo

下载地址&＃xff1a;传送门

demo首页截图&＃xff1a;