Android 底部导航栏(TabHost + TabWidget)实现方案

TabHost + TabWidget 是 Android 早期的官方底部导航方案

一、核心概念

1. 三个必须有的组件

  • TabHost:整个标签页的总控制器
  • TabWidget:底部 / 顶部的标签按钮栏
  • FrameLayout(tabcontent):每个标签对应的内容区域

2. 三个系统固定 ID(不能改)

复制代码
@android:id/tabhost       → TabHost
@android:id/tabs          → TabWidget
@android:id/tabcontent    → 内容容器

二、完整布局写法

xml 复制代码
<?xml version="1.0" encoding="utf-8"?>
<TabHost
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:id="@android:id/tabhost"
    android:layout_width="match_parent"
    android:layout_height="match_parent">

    <!-- 1. 系统必须的内容容器 -->
    <FrameLayout
        android:id="@android:id/tabcontent"
        android:layout_width="match_parent"
        android:layout_height="match_parent">

        <!-- 这里可以放各个 tab 对应的布局 -->
    </FrameLayout>

    <!-- 2. 底部 Tab 栏 -->
    <TabWidget
        android:id="@android:id/tabs"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_gravity="bottom">  <!-- 放在底部 -->
    </TabWidget>

</TabHost>

三、Java 代码完整使用步骤

1. Activity 必须继承 TabActivity

java 复制代码
public class MainActivity extends TabActivity {
    @Override
    protected void onCreate(Bundle savedInstanceState) {
        super.onCreate(savedInstanceState);
        setContentView(R.layout.activity_main);

        // 1. 获取 TabHost
        TabHost tabHost = getTabHost();

        // 2. 创建 Tab1
        TabHost.TabSpec tab1 = tabHost.newTabSpec("tab1");
        tab1.setIndicator("首页");      // 标签文字
        tab1.setContent(R.id.tab1);     // 对应布局ID

        // 3. 创建 Tab2
        TabHost.TabSpec tab2 = tabHost.newTabSpec("tab2");
        tab2.setIndicator("我的");
        tab2.setContent(R.id.tab2);

        // 4. 添加到 TabHost
        tabHost.addTab(tab1);
        tabHost.addTab(tab2);

        // 5. 默认选中第一个
        tabHost.setCurrentTab(0);
    }
}

2. 每个 Tab 对应内容布局示例

在 @android:id/tabcontent 里放:

xml 复制代码
<LinearLayout
    android:id="@+id/tab1"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center">
    <TextView
        android:text="首页内容"
        android:textSize="24sp"/>
</LinearLayout>

<LinearLayout
    android:id="@+id/tab2"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    android:gravity="center">
    <TextView
        android:text="我的页面"
        android:textSize="24sp"/>
</LinearLayout>

四、监听 Tab 切换事件

java 复制代码
tabHost.setOnTabChangedListener(new TabHost.OnTabChangeListener() {
    @Override
    public void onTabChanged(String tabId) {
        if (tabId.equals("tab1")) {
            // 切换到首页
        } else if (tabId.equals("tab2")) {
            // 切换到我的
        }
    }
});

五、重点注意事项

  1. 三个 ID 必须严格使用系统 ID
  2. Activity 必须继承 TabActivity,如果不继承 TabActivity,TabHost 必须先 setup () 再用。
java 复制代码
TabHost tabHost = findViewById(R.id.tabhost);
tabHost.setup();
  1. TabWidget 默认在顶部,想放底部要加

    android:layout_gravity="bottom"

  2. 每个 TabSpec 的 tag 必须唯一,重复会导致切换错乱。

    newTabSpec("tab1")
    newTabSpec("tab2")

六、现代替代方案

Google 现在推荐:
BottomNavigationView (底部导航)
TabLayout + ViewPager2(可滑动顶部标签)

相关推荐
.Bryce.32 分钟前
在智能体中使用A2A工具:让大模型自己决定“该找谁帮忙“
android·java·服务器·redis·后端·agent·a2a
方舟小孩2 小时前
开源办公软件海豹办公 1.9.15 实战 从模板异常到 Android WebView 资源回归
android
用户2181697049302 小时前
Kotlin 语法四 协程
android
出师牛2 小时前
Android - 再探Handler
android
高晶2 小时前
Android 物联网组网实战:NFC 从零到落地
android·java
stevenzqzq2 小时前
android 维度和渠道
android
古法安卓2 小时前
Android-SystemUI ANR协程相关问题排查
android·java·android studio
xiaogai_gai3 小时前
生产汇报单查询同步实战:从金蝶云星空拉取到轻易云数据集成平台的工程化做法
android
释厄6234 小时前
错误无误公理——错误正确本同源都迭代定律——逆转有价值
android·开发语言·kotlin
wno7044 小时前
MYSQL 常用合并函数
android·数据库·mysql