如何获取Android Preference自定义布局内的TextView引用

你无法直接在Fragment生命周期回调中通过findViewById()获取自定义布局内的TextView，本质是因为Preference的视图由内部RecyclerView按需延迟加载：onCreatePreferences、onViewCreated等回调执行时，对应Preference的item视图还未被inflate挂载，此时查找控件必然返回null。

以下两种方案均适配当前AndroidX Preference稳定版，不存在API过时问题：

方案1：轻量实现（无需自定义Preference类） #

适合仅在当前页面单次使用的场景，代码改动最小：

class PrimaryFragment : PreferenceFragmentCompat() {
    // 持有目标TextView的引用，避免重复查找
    private var myTextView: TextView? = null

    override fun onCreatePreferences(savedInstanceState: Bundle?, rootKey: String?) {
        setPreferencesFromResource(R.xml.primary, rootKey)

        findPreference<Preference>("pref_key")?.apply {
            // 监听视图绑定事件，此时Preference的item视图已经完成初始化
            setOnPreferenceBindListener { viewHolder, _, _ ->
                myTextView = viewHolder.itemView.findViewById(R.id.my_text_view)
            }

            setOnPreferenceClickListener {
                Log.d("debug", "onClick working!")
                // 点击时切换TextView显隐
                myTextView?.let {
                    it.visibility = if (it.visibility == View.VISIBLE) View.GONE else View.VISIBLE
                }
                true
            }
        }
    }
}

注意：setOnPreferenceBindListener是AndroidX Preference 1.1.0及以上版本提供的公开API，属于官方稳定接口，不存在兼容问题。

方案2：自定义Preference类（适合复用场景） #

如果这个带自定义TextView的Preference需要在多个页面复用，推荐封装为独立类，逻辑更解耦：

1. 新建自定义Preference类：

class CustomTogglePreference @JvmOverloads constructor(
    context: Context,
    attrs: AttributeSet? = null
) : Preference(context, attrs) {
    private var targetTextView: TextView? = null

    // 对外暴露切换TextView显隐的方法
    fun toggleTextShow() {
        targetTextView?.let {
            it.visibility = if (it.visibility == View.VISIBLE) View.GONE else View.VISIBLE
        }
    }

    override fun onBindViewHolder(holder: PreferenceViewHolder) {
        super.onBindViewHolder(holder)
        // 视图绑定时拿到TextView引用
        targetTextView = holder.findViewById(R.id.my_text_view) as TextView
    }
}

2. 修改primary.xml中的Preference标签为自定义类的全路径：

<PreferenceScreen>
    <PreferenceCategory>
        <!--替换成你自己的类包名路径-->
        <com.your.app.package.CustomTogglePreference
            android:key="pref_key"
            android:layout="@layout/custom_layout"
            />
    </PreferenceCategory>
</PreferenceScreen>

3. 在Fragment中直接调用公开方法即可：

findPreference<CustomTogglePreference>("pref_key")?.apply {
    setOnPreferenceClickListener {
        toggleTextShow()
        true
    }
}

• 不要尝试在onCreateView、onViewCreated等Fragment生命周期方法中直接调用findViewById(R.id.my_text_view)，此时Preference列表的item尚未渲染，必然获取不到控件
• 不要使用已废弃的Preference.getView()方法获取视图，该接口在新版本系统上返回值不稳定，极易触发空指针
• 列表滚动时Preference视图会被回收重建，不要长期持有脱离生命周期的控件引用，上述两种方案都在视图绑定时更新引用，不存在内存泄漏或引用失效问题

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