一手遮天 Android - view(导航类): ToolBar 基础
示例如下:
/view/navigation/ToolBarDemo1.java
/**
* Toolbar - 工具栏(导航栏)
* 本例用于演示 Toolbar 的基础知识,以及如何通过 Toolbar 右侧的按钮弹出 OptionMenu 菜单,以及如何在 Toolbar 上显示 OptionMenu 菜单中的选项
*
* 左侧按钮一般用于“返回键”
* 这个左侧按钮我们称之为 navigation button
* 右侧按钮一般用于弹出 OptionMenu 菜单(通过点击设备的“menu”键也会弹出 OptionMenu 菜单)
* 这个右侧按钮以及在 Toolbar 上显示的 OptionMenu 菜单中的选项我们称之为 action menu
*
* 关于 OptionMenu 菜单的基础知识和样式修改可以参见 PopupMenu 的相关说明(请参见 view/flyout/PopupMenuDemo1, view/flyout/PopupMenuDemo2)
* 注:如果觉得 OptionMenu 实现不了需求,就用 PopupWindow 吧
*
*
* 另:Toolbar 替代了 ActionBar
*/
package com.webabcd.androiddemo.view.navigation;
import androidx.appcompat.app.AppCompatActivity;
import android.os.Bundle;
import androidx.appcompat.widget.Toolbar;
import android.view.Menu;
import android.view.MenuItem;
import android.view.View;
import android.widget.Toast;
import com.webabcd.androiddemo.R;
public class ToolBarDemo1 extends AppCompatActivity {
private Toolbar mToolbar1;
@Override
protected void onCreate(Bundle savedInstanceState) {
super.onCreate(savedInstanceState);
setContentView(R.layout.activity_view_navigation_toolbardemo1);
mToolbar1 = findViewById(R.id.toolbar1);
sample();
}
private void sample() {
// 点击 navigationIcon(左侧按钮的图标)的回调
mToolbar1.setNavigationOnClickListener(new View.OnClickListener() {
@Override
public void onClick(View v) {
Toast.makeText(ToolBarDemo1.this, "点击了左侧按钮", Toast.LENGTH_SHORT).show();
}
});
// 设置右侧用于弹出 OptionMenu 的按钮的图标,不指定的话会使用默认图标
// 注:只有当 toolbar.getMenu() 有数据时,Toolbar 才会显示右侧的图标
mToolbar1.setOverflowIcon(getResources().getDrawable(R.drawable.img_sample_son, null));
// 从 xml 中加载 OptionMenu 的数据
mToolbar1.inflateMenu(R.menu.menu_view_navigation_toolbardemo1);
// 上面通过 toolbar.inflateMenu() 加载的 OptionMenu 数据会被自动同步到 toolbar.getMenu() 中
// 只有当 toolbar.getMenu() 有数据时,Toolbar 才会显示右侧的图标
// 支持将 OptionMenu 中的选项显示在 Toolbar 上,即支持 MenuItem 的 icon 和 showAsAction(参见 res/menu/menu_view_navigation_toolbardemo1.xml 中的说明)
final Menu menu = mToolbar1.getMenu();
// 可以在 java 中对 menu 做增删操作,类似 PopupMenu(参见 view/flyout/PopupMenuDemo1)
// OptionMenu 也支持显示多级菜单,类似 PopupMenu(参见 view/flyout/PopupMenuDemo1)
// 不同于 PopupMenu 的是,Toolbar 的 OptionMenu 的 menuItem.setIcon(), menuItem.setShowAsAction() 是有效果的,即支持将 OptionMenu 中的选项显示在 Toolbar 上(参见 res/menu/menu_view_navigation_toolbardemo1.xml 中的说明)
// MenuItem menuItem = menu.add("item");
// 弹出的 OptionMenu 中的选项被单击后的回调
mToolbar1.setOnMenuItemClickListener(new Toolbar.OnMenuItemClickListener() {
@Override
public boolean onMenuItemClick(MenuItem item) {
// item.getItemId() - 选项的 id
// item.getTitle() - 选项的 title
Toast.makeText(ToolBarDemo1.this, String.format("id:%d, title:%s", item.getItemId(), item.getTitle()), Toast.LENGTH_SHORT).show();
// 如果 item 数据来自 xml 的话,则可以通过此方式来判断用户点击的是哪个 item
if (item.getItemId() == menu.getItem(1).getItemId()) {
}
return true;
}
});
}
// 如果点击了设备的“menu”键,就会调用此方法来构造 OptionMenu 的数据
@Override
public boolean onCreateOptionsMenu(Menu menu) {
getMenuInflater().inflate(R.menu.menu_view_flyout_contextmenudemo1, menu);
return true;
}
// 点击了设备的“menu”键,弹出 OptionMenu 后,其选项被单击后的回调
@Override
public boolean onOptionsItemSelected(MenuItem item) {
Toast.makeText(ToolBarDemo1.this, String.format("id:%d, title:%s", item.getItemId(), item.getTitle()), Toast.LENGTH_SHORT).show();
return true;
}
}
/layout/activity_view_navigation_toolbardemo1.xml
<?xml version="1.0" encoding="utf-8"?>
<LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto"
android:layout_width="match_parent"
android:layout_height="match_parent"
android:orientation="vertical">
<!--
Toolbar - 工具栏(导航栏)
layout_height - 高度
background - 背景
navigationIcon - 左侧按钮的图标
logo - 显示在 navigationIcon 右边的图标
title, titleTextColor, subtitle, subtitleTextColor - 标题,标题颜色,副标题,副标题颜色
theme - 指定 Toolbar 的主题
注:本例中的 Toolbar 来自 androidx 包,如果要使用自定义属性,则要引入 xmlns:app="http://schemas.android.com/apk/res-auto"
-->
<androidx.appcompat.widget.Toolbar
android:id="@+id/toolbar1"
android:layout_width="match_parent"
android:layout_height="?attr/actionBarSize"
android:background="@color/green"
app:navigationIcon="@drawable/img_sample_son"
app:logo="@mipmap/ic_launcher"
app:title="title"
app:titleTextColor="@color/white"
app:subtitle="subtitle"
app:subtitleTextColor="@color/white"
android:theme="@style/Base.Theme.AppCompat.Light" />
</LinearLayout>
/menu/menu_view_navigation_toolbardemo1.xml
<?xml version="1.0" encoding="utf-8"?>
<!--
用于构造 OptionMenu 的选项数据,参见 view/navigation/ToolBarDemo1.java
showAsAction - 在 Toolbar 上显示的逻辑
never - 永远不在 Toolbar 上显示,默认值
always - 总是在 Toolbar 上显示(默认只显示 icon 指定的图标)
ifRoom - 如果 Toolbar 上有地方则在 Toolbar 上显示(默认只显示 icon 指定的图标)
-->
<menu xmlns:android="http://schemas.android.com/apk/res/android"
xmlns:app="http://schemas.android.com/apk/res-auto">
<item android:id="@+id/item1" android:title="菜单 1"
android:icon="@drawable/ic_expand_less"
app:showAsAction="ifRoom" />
<item android:id="@+id/item2" android:title="菜单 2"
android:icon="@drawable/ic_expand_more"
app:showAsAction="ifRoom" />
<item android:id="@+id/item3" android:title="菜单 3" />
<item android:id="@+id/item4" android:title="菜单 4" />
<item android:id="@+id/item5" android:title="菜单 5" />
</menu>
/menu/menu_view_flyout_contextmenudemo1.xml
<?xml version="1.0" encoding="utf-8"?>
<!--
用于构造 ContextMenu 的选项数据,参见 view/flyout/ContextMenuDemo1.java
-->
<menu xmlns:android="http://schemas.android.com/apk/res/android">
<item android:id="@+id/menu0" android:title="menu 0">
<menu>
<group>
<item android:id="@+id/menu0_0" android:title="menu 0_0"/>
<item android:id="@+id/menu0_1" android:title="menu 0_1"/>
<item android:id="@+id/menu0_2" android:title="menu 0_2"/>
</group>
</menu>
</item>
<item android:id="@+id/menu1" android:title="menu 1"/>
<item android:id="@+id/menu2" android:title="menu 2" android:enabled="false"/>
</menu>