动作栏 (ActionBar) 与工具栏 (Toolbar) 的基本使用

1. 概述 (Overview)

在 Android 应用开发中，动作栏 (ActionBar) 和 工具栏 (Toolbar) 是用于提供应用导航和操作选项的核心 UI 组件。它们为用户提供了直观的交互方式，使应用界面更加现代化和用户友好。

ActionBar：从 Android 3.0 (API level 11) 开始引入，是传统应用顶部的导航栏，提供应用标题、操作按钮和导航选项。
Toolbar：从 Android Support Library 21 (API level 21) 开始引入，是 ActionBar 的替代品，更加灵活，可以放在应用的任何布局中，而不仅限于顶部。

在现代 Android 开发中，Toolbar 已成为首选，因为它提供了更大的灵活性和更丰富的定制选项，同时保持了与旧版本 Android 的兼容性。

特性	ActionBar	Toolbar
引入版本	Android 3.0 (API level 11)	Android Support Library 21 (API level 21)
位置限制	仅能位于 Activity 的顶部	可放置在应用的任何布局中
灵活性	低，固定在 Activity 顶部	高，可自定义位置、大小和样式
兼容性	仅支持 Android 3.0+	通过 Support Library 支持所有 Android 版本
默认行为	自动处理菜单和操作	需要手动实现菜单和操作处理
UI 一致性	与系统主题一致	可完全自定义

结论：在现代 Android 开发中，Toolbar 是首选，因为它提供了更大的灵活性和更好的兼容性。

首先，需要在 Activity 的布局文件中添加 Toolbar 组件。

xml 复制代码

<!-- res/layout/activity_main.xml -->
<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 -->
    <androidx.appcompat.widget.Toolbar
        android:id="@+id/toolbar"
        android:layout_width="match_parent"
        android:layout_height="?attr/actionBarSize"
        android:background="?attr/colorPrimary"
        app:popupTheme="@style/ThemeOverlay.AppCompat.Light"
        app:theme="@style/ThemeOverlay.AppCompat.Dark.ActionBar" />

    <!-- 其他布局内容 -->
    <TextView
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:text="主内容区域"
        android:padding="16dp"/>
</LinearLayout>

关键属性说明:

android:layout_height="?attr/actionBarSize"：设置高度为系统 ActionBar 的标准高度。
android:background="?attr/colorPrimary"：设置背景色为应用主题的主色。
app:popupTheme：设置下拉菜单和弹出窗口的主题。
app:theme：设置 Toolbar 内部元素的主题（如文字颜色）。

在 Activity 的 onCreate 方法中，需要将 Toolbar 设置为 Activity 的 Action Bar。

java 复制代码

// Java
public class MainActivity extends AppCompatActivity {
    private Toolbar mToolbar;

    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 初始化 Toolbar
        mToolbar = findViewById(R.id.toolbar);
        setSupportActionBar(mToolbar); // 将 Toolbar 设置为 ActionBar

        // 可选：设置 Toolbar 标题
        getSupportActionBar().setTitle("主界面");
    }
}

注意：必须使用 setSupportActionBar(toolbar)，而不是 setActionBar(toolbar)，因为 setActionBar 是用于旧版 ActionBar 的方法。

与 ActionBar 类似，Toolbar 也需要在 XML 中定义菜单项，并在 Activity 中处理菜单项点击。

定义菜单资源文件 (res/menu/menu_main.xml):

xml 复制代码

<!-- res/menu/menu_main.xml -->
<menu xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto">
    
    <item
        android:id="@+id/action_search"
        android:icon="@drawable/ic_search"
        android:title="搜索"
        app:showAsAction="ifRoom" />
        
    <item
        android:id="@+id/action_settings"
        android:title="设置"
        app:showAsAction="never" />
</menu>

在 Activity 中加载菜单:

java 复制代码

// Java
@Override
public boolean onCreateOptionsMenu(Menu menu) {
    getMenuInflater().inflate(R.menu.menu_main, menu);
    return true;
}

处理菜单项点击:

java 复制代码

// Java
@Override
public boolean onOptionsItemSelected(MenuItem item) {
    int id = item.getItemId();
    
    if (id == R.id.action_search) {
        // 处理搜索操作
        performSearch();
        return true;
    } else if (id == R.id.action_settings) {
        // 处理设置操作
        openSettings();
        return true;
    }
    
    return super.onOptionsItemSelected(item);
}

4.1 添加导航图标

可以为 Toolbar 添加一个导航图标（如返回按钮），用于导航回上一级。

java 复制代码

// Java
// 在 onCreate 中设置导航图标
getSupportActionBar().setDisplayHomeAsUpEnabled(true);
getSupportActionBar().setHomeButtonEnabled(true);

// 处理导航图标点击
@Override
public boolean onOptionsItemSelected(MenuItem item) {
    if (item.getItemId() == android.R.id.home) {
        // 返回上一级
        onBackPressed();
        return true;
    }
    return super.onOptionsItemSelected(item);
}

可以自定义 Toolbar 的标题，包括使用自定义视图。

java 复制代码

// Java
// 设置标题
getSupportActionBar().setTitle("自定义标题");

// 设置标题的样式
getSupportActionBar().setTitle("自定义标题");
getSupportActionBar().setElevation(8); // 设置阴影

// 使用自定义视图作为标题
TextView titleView = new TextView(this);
titleView.setText("自定义标题");
titleView.setTextColor(Color.WHITE);
titleView.setTextSize(18);
titleView.setGravity(Gravity.CENTER);
getSupportActionBar().setCustomView(titleView);

可以在运行时动态修改 Toolbar 的内容，例如在不同 Fragment 之间切换时更新标题。

java 复制代码

// Java
public void updateToolbarTitle(String title) {
    getSupportActionBar().setTitle(title);
}

public void updateToolbarIcon(int iconRes) {
    getSupportActionBar().setIcon(iconRes);
}

5. 与 ActionBar 的兼容性处理

虽然 Toolbar 是推荐的替代方案，但在某些情况下，你可能需要同时支持旧版本的 ActionBar。

使用 AppCompat Activity :

继承自 AppCompatActivity 而不是 Activity，以确保在所有 Android 版本上都能使用 Toolbar。
java 复制代码
```
// Java
public class MainActivity extends AppCompatActivity {
    // ...
}
```

使用 AppCompat 主题 :

确保应用的主题基于 Theme.AppCompat。

xml 复制代码

<!-- res/values/styles.xml -->
<style name="AppTheme" parent="Theme.AppCompat.Light.NoActionBar">
    <!-- 自定义主题属性 -->
</style>

避免直接使用 ActionBar :

在代码中，始终使用 getSupportActionBar() 而不是 getActionBar()，因为 getActionBar() 在某些情况下可能会返回 null。

6. 最佳实践与注意事项

优先使用 Toolbar :
在所有新开发的应用中，优先使用 Toolbar 而不是 ActionBar，因为它提供了更大的灵活性和更好的兼容性。
保持一致性 :
为应用的所有 Activity 使用一致的 Toolbar 样式和主题，以提供统一的用户体验。
合理使用菜单项 :
限制菜单项的数量（通常不超过 4-5 个），避免菜单过于拥挤。使用 app:showAsAction="ifRoom" 来控制菜单项的显示方式。
考虑导航 :
为 Toolbar 添加适当的导航图标（如返回按钮），特别是在使用 Fragment 时。

7. 结论

ActionBar 和 Toolbar 是 Android 应用中用于提供导航和操作选项的关键 UI 组件。虽然 ActionBar 是早期版本中使用的标准组件，但 Toolbar 已成为现代 Android 开发的首选，因为它提供了更大的灵活性、更好的兼容性以及更丰富的定制选项。

通过遵循本文档中的最佳实践，开发者可以有效地为他们的 Android 应用添加功能丰富、用户友好的 Toolbar，从而提升应用的整体用户体验。

动作栏 (ActionBar) 与工具栏 (Toolbar) 的基本使用

1. 概述 (Overview)

2. ActionBar 与 Toolbar 的区别

3. Toolbar 的基本使用

3.1 在布局文件中添加 Toolbar

3.2 在 Activity 中初始化 Toolbar

3.3 为 Toolbar 添加菜单项

4. Toolbar 的高级功能

4.1 添加导航图标

4.2 自定义 Toolbar 标题

4.3 动态修改 Toolbar

5. 与 ActionBar 的兼容性处理

6. 最佳实践与注意事项

7. 结论