在Fragment中使用TabLayout搭配ViewPager时标签不显示的问题

问题描述 #

开发Android社区Fragment页面时，使用TabLayout+ViewPager搭建界面，已完成适配器配置，但运行后TabLayout的标签完全不显示，无任何报错信息。

相关代码 #

布局文件 fragment_bite_back_community.xml #

<RelativeLayout xmlns:android="http://schemas.android.com/apk/res/android"
    xmlns:app="http://schemas.android.com/apk/res-auto"
    xmlns:tools="http://schemas.android.com/tools"
    android:layout_width="match_parent"
    android:layout_height="match_parent"
    tools:context=".fragment.BiteBackCommunityFragment">

    <com.google.android.material.tabs.TabLayout
        android:id="@+id/communityTabLayout"
        android:layout_width="match_parent"
        android:layout_height="wrap_content"
        android:layout_alignParentBottom="true"
        app:tabGravity="fill"
        app:tabMode="fixed">

        <!-- Add TabItems for each tab -->
        <com.google.android.material.tabs.TabItem
            android:id="@+id/tabFeed"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@string/feed" />

        <com.google.android.material.tabs.TabItem
            android:id="@+id/tabExplore"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@string/explore" />

        <com.google.android.material.tabs.TabItem
            android:id="@+id/tabCreatePost"
            android:layout_width="wrap_content"
            android:layout_height="wrap_content"
            android:text="@string/create_post" />
    </com.google.android.material.tabs.TabLayout>

    <!-- ViewPager for managing fragments in tabs -->
    <androidx.viewpager.widget.ViewPager
        android:id="@+id/viewPager"
        android:layout_width="match_parent"
        android:layout_height="match_parent"
        android:layout_above="@id/communityTabLayout" />

</RelativeLayout>

适配器 CommunityPagerAdapter #

// CommunityPagerAdapter

package com.saurtech.biteback.adapter

import android.view.View
import android.view.ViewGroup
import androidx.fragment.app.Fragment
import androidx.fragment.app.FragmentManager
import androidx.viewpager.widget.PagerAdapter
import com.saurtech.biteback.fragment.CommunityCreatePostFragment
import com.saurtech.biteback.fragment.CommunityExploreFragment
import com.saurtech.biteback.fragment.CommunityFeedFragment

class CommunityPagerAdapter(private val fm: FragmentManager) : PagerAdapter() {

    override fun instantiateItem(container: ViewGroup, position: Int): Any {
        // Return the fragment based on the position
        val fragment: Fragment = when (position) {
            0 -> CommunityFeedFragment()
            1 -> CommunityExploreFragment()
            2 -> CommunityCreatePostFragment()
            else -> throw IllegalArgumentException("Invalid tab position")
        }

        val transaction = fm.beginTransaction()
        transaction.add(container.id, fragment)
        transaction.commitAllowingStateLoss()

        return fragment
    }

    override fun getCount(): Int {
        // Return the total number of tabs
        return 3
    }

    override fun isViewFromObject(view: View, `object`: Any): Boolean {
        return view == `object`
    }

    override fun getPageTitle(position: Int): CharSequence? {
        // Return tab title based on position
        return when (position) {
            0 -> "Community Feed"
            1 -> "Explore"
            2 -> "Create Post"
            else -> null
        }
    }

    override fun destroyItem(container: ViewGroup, position: Int, `object`: Any) {
        val transaction = fm.beginTransaction()
        transaction.remove(`object` as Fragment)
        transaction.commitAllowingStateLoss()
    }
}

Fragment代码 BiteBackCommunityFragment.kt #

package com.saurtech.biteback.fragment

import android.os.Bundle
import android.view.LayoutInflater
import android.view.View
import android.view.ViewGroup
import androidx.fragment.app.Fragment
import androidx.viewpager.widget.PagerAdapter
import androidx.viewpager.widget.ViewPager
import com.google.android.material.tabs.TabLayout
import com.saurtech.biteback.R
import com.saurtech.biteback.adapter.CommunityPagerAdapter

class BiteBackCommunityFragment : Fragment() {

    override fun onCreateView(
        inflater: LayoutInflater, container: ViewGroup?,
        savedInstanceState: Bundle?
    ): View? {
        val view = inflater.inflate(R.layout.fragment_bite_back_community, container, false)

        // Setup ViewPager
        val viewPager: ViewPager = view.findViewById(R.id.viewPager)

        val pagerAdapter: PagerAdapter = CommunityPagerAdapter(childFragmentManager)
        viewPager.adapter = pagerAdapter

        // Setup TabLayout
        val tabLayout: TabLayout = view.findViewById(R.id.communityTabLayout)
        tabLayout.setupWithViewPager(viewPager)

        return view
    }
}

显示效果 #

• 当前实际效果：
• 期望效果：

问题原因与修复方案 #

核心问题 #

你的CommunityPagerAdapter继承了**PagerAdapter，这是ViewPager的基础适配器，并不适配Fragment场景。当使用TabLayout.setupWithViewPager()时，需要配合专门用于Fragment的适配器——FragmentPagerAdapter或FragmentStatePagerAdapter**，否则TabLayout无法正确从适配器获取标签信息并渲染。

修改后的适配器代码 #

将适配器改为继承FragmentPagerAdapter（页面数量少推荐用这个；页面多或需要回收则用FragmentStatePagerAdapter）：

package com.saurtech.biteback.adapter

import androidx.fragment.app.Fragment
import androidx.fragment.app.FragmentManager
import androidx.fragment.app.FragmentPagerAdapter

class CommunityPagerAdapter(fm: FragmentManager) : FragmentPagerAdapter(fm, BEHAVIOR_RESUME_ONLY_CURRENT_FRAGMENT) {

    override fun getItem(position: Int): Fragment {
        return when (position) {
            0 -> com.saurtech.biteback.fragment.CommunityFeedFragment()
            1 -> com.saurtech.biteback.fragment.CommunityExploreFragment()
            2 -> com.saurtech.biteback.fragment.CommunityCreatePostFragment()
            else -> throw IllegalArgumentException("Invalid tab position")
        }
    }

    override fun getCount(): Int {
        return 3
    }

    override fun getPageTitle(position: Int): CharSequence? {
        return when (position) {
            0 -> "Community Feed"
            1 -> "Explore"
            2 -> "Create Post"
            else -> null
        }
    }
}

额外优化建议 #

1. 布局中的TabItem可以删除，因为setupWithViewPager()会自动从适配器的getPageTitle()方法获取标签文本，手动添加的TabItem可能会和适配器的标题冲突。
2. 如果想使用strings.xml中的资源，把getPageTitle()里的硬编码文本替换成context.getString(R.string.feed)等，记得给适配器传入Context或者在Fragment中设置标题。

内容的提问来源于stack exchange，提问作者Saurav Kumar