基于AndroidX的ListPreference最简自定义方案

实现步骤 #

Android官方并未将带图标的单选Preference纳入核心API，但可以通过复用系统逻辑+轻量自定义来实现，尽量减少冗余代码：

• 1. 自定义列表项布局
  复制系统默认的单选列表项布局（select_dialog_singlechoice_item.xml），替换为ImageView+TextView+RadioButton的组合，保留系统ID以复用原有逻辑：

  <!-- res/layout/custom_preference_item.xml -->
  <LinearLayout xmlns:android="http://schemas.android.com/apk/res/android"
      android:layout_width="match_parent"
      android:layout_height="wrap_content"
      android:gravity="center_vertical"
      android:minHeight="?android:attr/listPreferredItemHeightSmall"
      android:paddingStart="16dp"
      android:paddingEnd="16dp">
  
      <ImageView
          android:id="@+id/item_icon"
          android:layout_width="24dp"
          android:layout_height="24dp"
          android:marginEnd="16dp"/>
  
      <TextView
          android:id="@android:id/text1"
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:textAppearance="?android:attr/textAppearanceListItemSmall"/>
  
      <RadioButton
          android:id="@android:id/radio"
          android:layout_width="wrap_content"
          android:layout_height="wrap_content"
          android:layout_marginStart="auto"
          android:clickable="false"
          android:focusable="false"/>
  </LinearLayout>
  

• 2. 轻量自定义ListPreference
  通过自定义属性传入图标数组，重写对话框视图的适配器绑定图标数据，不用完全从零实现适配器：
  首先添加自定义属性：

  <!-- res/values/attrs.xml -->
  <declare-styleable name="IconListPreference">
      <attr name="entryIcons" format="reference"/>
  </declare-styleable>
  

  然后实现自定义Preference类：

  class IconListPreference(context: Context, attrs: AttributeSet) : ListPreference(context, attrs) {
      private val entryIcons: IntArray
  
      init {
          val ta = context.obtainStyledAttributes(attrs, R.styleable.IconListPreference)
          entryIcons = ta.getResourceId(R.styleable.IconListPreference_entryIcons, 0).let {
              context.resources.obtainTypedArray(it).run {
                  val icons = IntArray(length())
                  for (i in 0 until length()) {
                      icons[i] = getResourceId(i, 0)
                  }
                  recycle()
                  icons
              }
          }
          ta.recycle()
      }
  
      override fun onCreateDialogView(): View {
          val listView = super.onCreateDialogView() as ListView
          listView.adapter = object : ArrayAdapter<CharSequence>(context, R.layout.custom_preference_item, entries) {
              override fun getView(position: Int, convertView: View?, parent: ViewGroup): View {
                  val view = super.getView(position, convertView, parent)
                  // 绑定图标
                  view.findViewById<ImageView>(R.id.item_icon).setImageResource(entryIcons[position])
                  // 同步选中状态
                  view.findViewById<RadioButton>(android.R.id.radio).isChecked = (value == entryValues[position])
                  return view
              }
          }
          return listView
      }
  }
  

• 3. 在偏好设置中使用
  直接在preferences.xml中引用自定义Preference，指定条目、值和图标数组：

  <com.yourpackage.IconListPreference
      android:key="example_preference"
      android:title="选择选项"
      android:entries="@array/preference_entries"
      android:entryValues="@array/preference_entry_values"
      app:entryIcons="@array/preference_entry_icons"/>
  

  对应的数组资源示例：

  <!-- res/values/arrays.xml -->
  <string-array name="preference_entries">
      <item>选项1</item>
      <item>选项2</item>
      <item>选项3</item>
  </string-array>
  
  <string-array name="preference_entry_values">
      <item>value1</item>
      <item>value2</item>
      <item>value3</item>
  </string-array>
  
  <array name="preference_entry_icons">
      <item>@drawable/icon1</item>
      <item>@drawable/icon2</item>
      <item>@drawable/icon3</item>
  </array>
  

补充说明 #

Android的Preference组件主打通用基础场景，带图标的单选属于个性化需求，官方未做内置支持，但上述方案已经复用了系统的对话框、单选逻辑，仅新增图标绑定部分，代码量已尽可能精简。

内容的提问来源于stack exchange，提问作者Rutherford Le Blang