Android中TextInputLayout的endIcon与passwordToggle区别解析

核心关系 #

passwordToggle其实是endIcon体系下的特定功能分支——早期Material组件为密码可见性切换单独做了一套配置，后来组件升级时把这类尾部图标功能统一整合到了endIcon的模式管理中，所以两种写法本质都是实现密码切换，但配置逻辑和扩展性有区别。

具体差异 #

• 配置逻辑不同
  • passwordToggleEnabled="true"是旧版专属配置：专门针对密码切换场景，所有相关配置（比如passwordToggleDrawable）都只服务于这个功能，逻辑单一直接。
  • endIconMode="password_toggle"是新版统一配置：endIcon支持多种模式（清除文本、自定义图标等），密码切换只是其中一种，这套写法是组件的标准统一配置方案。
• 功能扩展性不同
  • passwordToggle写法只能固定用于密码切换：如果后续要把尾部图标改成清除输入内容的按钮，得完全替换布局里的配置项，没法动态切换。
  • endIcon写法支持动态切换功能：代码里直接修改endIconMode就能切换成其他功能，比如til_password.endIconMode = TextInputLayout.END_ICON_CLEAR_TEXT，不用改动布局。
• 默认行为一致但适配逻辑不同
  • 两种写法如果不指定自定义图标，都会默认使用Material Design的标准密码切换图标。但passwordToggle的图标配置只绑定密码切换功能，而endIcon的图标可以随着模式切换对应调整。

代码示例 #

1. endIcon实现方式

<com.google.android.material.textfield.TextInputLayout
        android:id="@+id/til_password"
        app:endIconDrawable="@drawable/password_icon"
        app:endIconMode="password_toggle">

2. passwordToggle实现方式

<com.google.android.material.textfield.TextInputLayout
        android:id="@+id/til_password"
        app:passwordToggleEnabled="true"
        app:passwordToggleDrawable="@drawable/password_icon">

选型建议 #

• 要是只需要单纯的密码切换功能，两种写法都能用，老项目可能更习惯passwordToggle的写法。
• 要是后续可能需要扩展尾部图标的其他功能，优先选endIconMode的写法，灵活性更高。

内容的提问来源于stack exchange，提问作者Super Hoang