拆解MaterialTextField源码:onFinishInflate动态搬运EditText与浮动Label的生成原理
拆解MaterialTextField源码:onFinishInflate动态搬运EditText与浮动Label的生成原理
MaterialTextField 是一款开源 Android 浮动输入框组件,让输入框拥有"卡片展开/收起"的动态效果。本文拆解 MaterialTextField 源码,深入讲清它是如何在 onFinishInflate 回调中动态搬运 XML 里写的 EditText,并自动生成浮动 Label 标签的 🔍
一、先认识 MaterialTextField:浮动输入框长什么样
MaterialTextField 的核心卖点是:输入框默认收缩成一条细细的"下划线"卡片,点击或聚焦后像 Material 卡片一样展开,同时顶部的 Label 标签会缩小上浮、左侧图标淡入——整个过程带平滑动画。
它的 XML 用法非常直观:只要在普通 EditText 外层套一层 MaterialTextField,并通过 mtf_image 指定一个图标:
<com.github.florent37.materialtextfield.MaterialTextField
android:layout_width="300dp"
android:layout_height="wrap_content"
app:mtf_image="@drawable/ic_mail_grey600_24dp">
<EditText
android:layout_width="match_parent"
android:layout_height="wrap_content"
android:hint="Password" />
</com.github.florent37.materialtextfield.MaterialTextField>
⚠️ 注意:开发者写的只有
EditText本身,而界面上的 Label 标签、卡片背景、图标容器全部是组件运行时生成的。这正是源码中最精彩的部分。
实际示例可参考 sample 模块的布局:activity_main.xml
二、为什么必须等 onFinishInflate 回调?
理解源码前先搞懂一个时机问题:
| 时机 | 说明 | 能否拿到子 View |
|---|---|---|
构造器(三个 MaterialTextField 构造函数) |
只是创建自定义 View 实例本身 | ❌ XML 子节点还没被解析 |
onFinishInflate() |
XML 中该 View 及它的所有子节点解析完毕 | ✅ 可以找到第一个 EditText 子节点 |
自定义 View 的构造器执行时,<MaterialTextField> 标签内的 EditText 还未被 LayoutInflater 创建。只有当整个标签(含子节点)解析完成,框架才会回调 onFinishInflate()。所以"搬运 EditText"这件事,必须放在 onFinishInflate 方法 中完成,早一秒都不行。
三、逐步拆解源码:动态搬运 EditText 与生成浮动 Label
核心逻辑集中在 MaterialTextField.java,整个 onFinishInflate 可以分为 6 个步骤。
3.1 第一步:找到 EditText 子节点
editText = findEditTextChild();
if (editText == null) {
return;
}
findEditTextChild 方法 只做一件事:检查第一个子 View 是不是 EditText 实例,是就返回,否则整个组件直接放弃初始化。这就规定了用法——MaterialTextField 的第一个子节点必须是 EditText。
3.2 第二步:inflate 内置的 mtf_layout.xml
addView(LayoutInflater.from(getContext()).inflate(R.layout.mtf_layout, this, false));
组件自带了一份布局 mtf_layout.xml,它定义了三个关键容器:
mtf_label(TextView,L6-L15):浮动标签,初始layout_marginTop=45dp,位于卡片上方;mtf_card(FrameLayout,L17-L43):展开后的白色卡片,背景是 card.xml 定义的圆角矩形;mtf_editTextLayout(FrameLayout,L35-L41):专门留给 EditText 的"插槽",左侧预留 50dp padding 给图标;mtf_image(ImageView,L25-L33):卡片内的图标位。
inflate(..., this, false) 表示把这份布局作为子 View 添加到 MaterialTextField 自己身上——此时界面里同时存在"你写的 EditText"和"组件生成的卡片结构",接下来就要动手术了。
3.3 第三步:"搬运"EditText 到内部容器
editTextLayout = (ViewGroup) findViewById(R.id.mtf_editTextLayout);
removeView(editText);
editTextLayout.addView(editText);
这是标题里"动态搬运"的精髓,三行代码完成了 View 树重排:
removeView(editText)—— 把用户写的 EditText 从 MaterialTextField 顶层摘除;editTextLayout.addView(editText)—— 再把它种进卡片内的插槽容器。
这样 EditText 就"住进"了白色卡片里,展开/收起动画只需变换卡片本身,文字自然跟着移动,无需单独处理。
3.4 第四步:从 hint 自动生成浮动 Label
label = (TextView) findViewById(R.id.mtf_label);
ViewCompat.setPivotX(label, 0);
ViewCompat.setPivotY(label, 0);
if (editText.getHint() != null) {
label.setText(editText.getHint());
editText.setHint("");
}
Label 的文案不是开发者额外配置的,而是直接"偷"了 EditText 的 hint:
setPivotX/Y(label, 0):把缩放轴心固定在左上角,后续缩小时标签会向左上收缩而不是居中缩小;label.setText(editText.getHint()):hint 文字上移到标签;editText.setHint(""):清空原 hint,避免同一文案出现两次。
这就是"浮动标签"零配置自动生成的原理——你写的 hint 就是 Label 的文字来源。
3.5 第五步:初始化"收起态"的卡片
reducedScale = (float) (reducedHeight * 1.0 / expandedHeight);
ViewCompat.setScaleY(card, reducedScale);
ViewCompat.setPivotY(card, expandedHeight);
高度参数来自 dimens.xml:
mtf_cardHeight_initial= 4dp(收起时卡片只剩一条缝)mtf_cardHeight_final= 55dp(完全展开的高度)
源码没有真的去改高度,而是算出缩放比 reducedScale = 4/55 ≈ 0.07,把卡片沿 Y 轴压扁,并用 setPivotY(card, expandedHeight) 把缩放支点钉在卡片底部——视觉上卡片就从底部"塌缩"成一条线。
同时对图标和输入框做初始隐藏:
ViewCompat.setAlpha(image, 0); // 图标透明度 0
ViewCompat.setAlpha(editText, 0f); // EditText 透明度 0
此时界面上只有一条细线 + 一个 Label,与演示图一致。
3.6 第六步:绑定点击与焦点逻辑
this.setOnClickListener(v -> toggle());
setHasFocus(hasFocus);
- 点击组件任意位置触发
toggle(),在expand()/reduce()之间切换; app:mtf_hasFocus属性可让组件初始就处于展开态(见 handleAttributes 方法 中的属性读取,以及 setHasFocus 方法)。
四、expand / reduce 动画如何驱动展开效果
展开(expand 方法)时四个 View 同步做动画:
| 元素 | 动画内容 | 视觉效果 |
|---|---|---|
card |
scaleY(1f) |
卡片从底部"长高"展开 |
label |
scaleX/Y(0.7f) + translationY(-labelTopMargin) + 透明度 0.4 |
标签缩小并上浮到卡片顶部 |
image |
透明度 0→1,缩放 0.4→1 | 图标淡入并放大 |
editText |
透明度 0→1 | 输入区域淡入 |
收起(reduce 方法)时还有一处巧妙细节:reduce() 里通过 setUpdateListener 监听 EditText 透明度变化,实时联动修改卡片真实高度(L91-L98),保证动画过程中布局与视觉严格同步;若输入框持有焦点,还会收起软键盘并清除焦点。
💡 所有动画时长由
app:mtf_animationDuration控制,默认 400ms。
五、MaterialTextField 自定义属性清单
全部属性声明见 attrs.xml,共 7 个:
| 属性名 | 类型 | 作用 |
|---|---|---|
mtf_cardCollapsedHeight |
dimension | 卡片收起时的高度(默认 4dp) |
mtf_labelColor |
color | 浮动 Label 的文字颜色 |
mtf_image |
reference | 卡片内显示的图标 |
mtf_hasFocus |
boolean | 初始是否处于展开/聚焦态 |
mtf_animationDuration |
integer | 展开/收起动画时长(ms) |
mtf_openKeyboardOnFocus |
boolean | 聚焦时是否自动弹出软键盘 |
mtf_backgroundColor |
color | 卡片背景色 |
这些属性在构造阶段由 handleAttributes() 存入成员变量,真正的生效(如设置 label 颜色、加载图标)则统一延迟到 onFinishInflate 末尾的 customizeFromAttributes 方法 中执行——因为那时子 View 才存在。
六、总结:MaterialTextField 的三个核心设计点
- 时机选择:利用
onFinishInflate这一"XML 子节点全部就绪"的回调,才有机会操作用户写的 EditText; - View 树重排:
removeView + addView两行代码完成 EditText 的"搬家",让外部动画可以整体驱动内部控件; - hint 复用:把 EditText 的 hint "偷"成浮动 Label 文案,实现零额外配置的标签效果。
整个组件不到 300 行代码,却完整演示了自定义复合控件的三种经典技巧:布局 inflate、子 View 动态重排、属性延迟生效。读懂了这份 MaterialTextField.java,你就掌握了开发类似"包装型"Android 控件的通用思路 ✅

