Android 开发顶部标题栏ActionBar详解

封面图 • 2025-10-28 • Android开发

在 Android 开发中，**ActionBar** 是一个非常重要的 UI 组件，用于提供应用程序的导航和操作功能。它通常位于应用的顶部，显示应用的标题、图标、菜单项等。

不过需要注意的是，从 **Android 5.0（API 21）** 开始，Google 推出了 **AppCompat 库** 和 **Toolbar** 控件来替代传统的 ActionBar，因为 ActionBar 在某些设备上可能不兼容或存在限制。但为了全面了解，我们先介绍传统的 ActionBar，再介绍现代推荐的 Toolbar 方案。

---

## 一、传统 ActionBar（适用于 API < 21）

### 1.1 ActionBar 的作用

- 显示应用标题
- 提供返回按钮（如果启用了导航）
- 显示操作菜单（OptionsMenu）
- 支持 Tab 导航（Tabbed Navigation）
- 显示进度条（如加载状态）

### 1.2 启用 ActionBar

在 `AndroidManifest.xml` 中为 Activity 设置主题：

```xml
<activity
    android:name=".MainActivity"
    android:theme="@style/AppTheme.NoActionBar" />
```

或者使用默认的 `Theme.AppCompat.Light.NoActionBar`，然后手动添加 ActionBar。

### 1.3 使用 ActionBar

#### （1）在 Activity 中获取 ActionBar

```java
getSupportActionBar().setTitle("我的标题");
getSupportActionBar().setDisplayHomeAsUpEnabled(true); // 显示返回按钮
```

#### （2）创建菜单（OptionsMenu）

在 `res/menu/` 目录下创建 XML 文件，例如 `main_menu.xml`：

```xml
<menu xmlns:android="http://schemas.android.com/apk/res/android">
    <item
        android:id="@+id/action_settings"
        android:title="设置"
        android:showAsAction="never" />
</menu>
```

在 Activity 中重写 `onCreateOptionsMenu`：

```java
@Override
public boolean onCreateOptionsMenu(Menu menu) {
    getMenuInflater().inflate(R.menu.main_menu, menu);
    return true;
}
```

#### （3）处理菜单点击事件

```java
@Override
public boolean onOptionsItemSelected(MenuItem item) {
    int id = item.getItemId();
    if (id == R.id.action_settings) {
        // 处理设置点击
        return true;
    }
    return super.onOptionsItemSelected(item);
}
```

---

## 二、现代推荐：使用 Toolbar 替代 ActionBar（适用于 API >= 21）

从 Android 5.0 开始，Google 推荐使用 **Toolbar** 来实现类似 ActionBar 的功能，并且可以兼容低版本设备（通过 AppCompat 库）。

### 2.1 添加依赖（Gradle）

```gradle
implementation 'com.google.android.material:material:1.9.0'
implementation 'androidx.appcompat:appcompat:1.6.1'
```

### 2.2 在布局中添加 Toolbar

```xml
<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/AppTheme.PopupOverlay" />
```

### 2.3 在 Activity 中设置 Toolbar 为 ActionBar

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

Toolbar toolbar = findViewById(R.id.toolbar);
    setSupportActionBar(toolbar);
    getSupportActionBar().setTitle("我的标题");
    getSupportActionBar().setDisplayHomeAsUpEnabled(true);
}
```

### 2.4 创建菜单（OptionsMenu）

与之前相同，只是需要确保在 `onCreateOptionsMenu` 中正确加载菜单。

---

## 三、ActionBar 的高级功能

### 3.1 设置图标

```java
getSupportActionBar().setLogo(R.drawable.logo);
```

### 3.2 设置导航模式（Tab 或 Up）

```java
getSupportActionBar().setNavigationMode(ActionBar.NAVIGATION_MODE_TABS);
```

### 3.3 设置进度条（加载状态）

```java
getSupportActionBar().setProgress(50); // 0~100
```

---

## 四、ActionBar 和 Toolbar 的区别

| 特性 | ActionBar | Toolbar |
|------|-----------|---------|
| 兼容性 | 只支持 API 11+ | 支持 API 7+（通过 AppCompat） |
| 灵活性 | 较差 | 更灵活，可自定义样式 |
| 推荐 | 已淘汰 | 推荐使用 |

---

## 五、总结

- **ActionBar** 是 Android 早期的顶部导航组件，现在已被 **Toolbar** 取代。
- **Toolbar** 更加灵活，适合现代 Android 开发。
- 使用 **AppCompat** 库可以让 Toolbar 在旧设备上也能正常运行。
- 如果你正在开发新项目，建议直接使用 **Toolbar + AppCompat** 的组合。

---

如果你有具体问题，比如如何自定义 ActionBar 的样式、如何添加菜单项、如何实现底部导航栏等，欢迎继续提问！

Android 开发 顶部标题栏ActionBar详解

Android 开发顶部标题栏ActionBar详解