一、先搞懂:为什么 Tab 文字默认会全大写?
你有没有发现,哪怕你在代码里设置的是 "首页""Home",运行后 Tab 上的文字总会变成 "首页"(中文不变)、"HOME"(英文全大写)?这不是你的代码写错了,而是 TabLayout
有个 "隐藏的样式规则" 在起作用。
根源:Material Design 的默认文本样式
TabLayout
是 Material Design 组件库的一部分,它内部给 Tab 文字用了一个默认的文本样式(TextAppearance
),这个样式里有个属性叫 textAllCaps
,默认被设置为 true
。
textAllCaps
就像一个 "强制转换开关":
-
当它为
true
时,所有英文文字会被自动转换成大写(中文不受影响,因为中文没有大小写); -
当它为
false
时,文字会保持你设置的原始大小写。
所以问题的核心就是:默认的 textAllCaps="true"
导致英文全大写,我们要做的就是把这个开关关掉。
二、解决方案:关掉 "全大写开关"
有两种简单的方式可以实现,本质都是修改 textAllCaps
属性:
方法一:直接在自定义 Tab 布局中设置(推荐)
如果你已经在用自定义布局(比如之前设置 Tab 宽度时创建的 tab_custom.xml
),直接在布局的 TextView
里加一行 android:textAllCaps="false"
即可:
xml
<!-- res/layout/tab_custom.xml -->
<TextView xmlns:android="http://schemas.android.com/apk/res/android"
android:id="@+id/tab_text"
android:layout_width="wrap_content"
android:layout_height="match_parent"
android:gravity="center"
android:textSize="14sp"
android:textAllCaps="false" <!-- 关键:关掉全大写 -->
android:paddingHorizontal="8dp"/>
然后在代码中给 Tab 设置这个布局(和之前一样):
kotlin
val tab = tabLayout.newTab()
val tabView = LayoutInflater.from(this).inflate(R.layout.tab_custom, tabLayout, false) as TextView
tabView.text = "Home" // 现在会显示"Home"而不是"HOME"
tab.customView = tabView
tabLayout.addTab(tab)
方法二:通过主题样式全局修改(适合所有 Tab)
如果你的整个 App 里所有 TabLayout
都不想用全大写,可以在主题中统一设置。步骤如下:
- 在
res/values/styles.xml
里定义一个自定义样式,继承Widget.MaterialComponents.TabLayout
,并指定文字样式:
xml
<style name="MyTabLayout" parent="Widget.MaterialComponents.TabLayout">
<!-- 引用一个自定义的文字样式 -->
<item name="tabTextAppearance">@style/MyTabTextAppearance</item>
</style>
<!-- 自定义文字样式,关掉全大写 -->
<style name="MyTabTextAppearance" parent="TextAppearance.MaterialComponents.Button">
<item name="textAllCaps">false</item> <!-- 关键:关掉全大写 -->
<item name="android:textSize">14sp</item> <!-- 可选:设置文字大小 -->
</style>
- 在布局的
TabLayout
中使用这个自定义样式:
xml
<com.google.android.material.tabs.TabLayout
android:id="@+id/tabLayout"
android:layout_width="wrap_content"
android:layout_height="wrap_content"
style="@style/MyTabLayout" <!-- 使用自定义样式 -->
.../>
这样设置后,即使不自定义 Tab 布局,直接用默认方式添加 Tab,文字也不会全大写了:
kotlin
tabLayout.addTab(tabLayout.newTab().setText("Home")) // 显示"Home"
三、底层原理:为什么这两种方法能生效?
本质是 "样式优先级" 在起作用:
-
TabLayout
的默认行为:- 它内部会给每个 Tab 创建一个
TextView
,并应用默认样式(TextAppearance.MaterialComponents.Tab
)。 - 这个默认样式里有
textAllCaps="true"
,所以文字会被强制大写。
- 它内部会给每个 Tab 创建一个
-
我们的修改逻辑:
-
方法一(自定义布局) :相当于我们自己创建了
TextView
并设置了textAllCaps="false"
,这会直接覆盖默认样式的设置(自己的布局优先级更高)。 -
方法二(主题样式) :通过
tabTextAppearance
指定了新的文字样式,新样式里textAllCaps="false"
会覆盖默认样式的对应属性(自定义主题优先级高于系统默认主题)。
-
打个比方:系统默认给 Tab 文字 "穿了一件全大写的外套",我们要么直接给文字 "换一件不大写的外套"(自定义布局),要么告诉系统 "以后所有 Tab 都别穿那件大写外套了"(主题样式)。
四、注意事项
-
中文无需担心:中文没有大小写,所以
textAllCaps
对中文无效,设置后中文会保持原样。 -
样式继承要正确:自定义文字样式时,建议继承
TextAppearance.MaterialComponents.Button
或TextAppearance.MaterialComponents.Tab
,这样能保留 Material Design 的其他默认样式(如文字颜色、间距等),只修改我们关心的textAllCaps
。 -
避免冲突:如果同时用了自定义布局和主题样式,以自定义布局中的设置为准(布局里的属性优先级最高)。
通过以上方法,就能让 Tab 文字保持你设置的原始大小写了。