本文详解如何在 kivy 中自定义圆角 textinput 的文字颜色（foreground color）和背景区域颜色（roundedrectangle 背景），避免因半透明遮罩导致文字不可见的问题。
在 Kivy 中，TextInput 默认的 foreground_color（即文字颜色）由其内部绘制逻辑控制，不会受 canvas.before 中的 Color 指令影响——后者仅作用于背景图层。因此，当你在 RoundedTextInput@TextInput 的 canvas.before 中设置 rgba: .4, .2, .8, .5 时，该颜色仅填充圆角矩形背景，而文字仍使用默认的黑色（或主题色），在深色/半透明背景上极易难以辨识；若盲目提高 alpha 值（如设为 1），又可能因 background_color: 0,0,1,0（完全透明）导致文字被底层内容干扰或视觉混淆。
正确解法是：分离关注点——将圆角背景绘制与文字渲染解耦，利用 canvas.after 在 TextInput 上层（或同级容器）独立绘制背景，并显式设置 TextInput 的 foreground_color 属性控制文字颜色。
以下是推荐的结构化实现方案：
✅ 正确做法：用 BoxLayout 容器承载圆角背景 + 独立 TextInput
# test.kv
Manager:
Screeen:
<RoundedTextInput@TextInput>
# 关键：显式设置文字颜色（RGBA），确保高对比度
foreground_color: 1, 1, 1, 1 # 白色文字（可按需调整）
background_color: 0, 0, 0, 0 # 完全透明背景，避免双层遮罩
padding: [12, 8, 12, 8] # 可选：增加内边距提升可读性
font_size: 16
<Screeen>:
name: "Screeen"
FloatLayout:
size: root.width, root.height
# 使用 BoxLayout 作为圆角背景容器（位置与尺寸与 TextInput 一致）
BoxLayout:
size_hint: (.45, .1)
pos: root.width * 1 / 4, root.height * 1 / 2
# 绘制不透明圆角背景（置于 TextInput 下方）
canvas.before:
Color:
rgba: .4, .2, .8, 1 # 纯色背景，无透明度干扰
RoundedRectangle:
size: self.size
pos: self.pos
radius: [24]
# TextInput 置于上方，文字颜色独立可控
RoundedTextInput:
size_hint: (.45, .1)
pos: root.width * 1 / 4, root.height * 1 / 2⚠️ 注意事项：
- 不要在 TextInput 的 canvas.before 中绘制背景：这会与 foreground_color 渲染顺序冲突，且无法隔离文字图层。
- foreground_color 必须显式声明：默认值为 [1, 1, 1, 1]（白色），但若主题或父容器影响了颜色继承，务必覆盖。
- background_color 应设为完全透明（0,0,0,0）：避免与外部圆角背景叠加产生意外灰阶或模糊。
- 若需响应式交互（如聚焦变色），可结合 on_focus 事件动态修改 foreground_color 或 canvas.before 的 Color.rgba。
✅ 进阶提示：支持焦点状态样式
<RoundedTextInput@TextInput>
foreground_color: (1, 1, 1, 1) if self.focus else (.8, .8, .8, 1)
# … 其他属性保持不变通过这种容器分离 + 属性显式控制的方式，你既能获得美观的圆角 UI，又能确保文字始终清晰可读，彻底规避透明度叠加导致的显示异常问题。
