萬盛學電腦網

您现在的位置: 萬盛學電腦網 >> 程式設計 >  >> 網路程式設計 >> Android 開發

Android ListPreference 完整使用指南(含陣列資源與 XML 設定)

前言

ListPreference 讓使用者從單選清單選取值,並自動將選取值以字串存入 SharedPreferences。本文完整示範陣列資源定義、XML 宣告、程式碼監聽與預設值處理。

1. 定義陣列資源 (res/values/arrays.xml)

<resources>
    <!-- 顯示給使用者看的標籤 -->
    <string-array name="auto_logout_time_labels">
        <item>10 分鐘</item>
        <item>20 分鐘</item>
        <item>30 分鐘</item>
        <item>60 分鐘</item>
    </string-array>

    <!-- 實際存入 SharedPreferences 的值 -->
    <string-array name="auto_logout_time_values">
        <item>600000</item>      <!-- 10 min in ms -->
        <item>1200000</item>     <!-- 20 min -->
        <item>1800000</item>     <!-- 30 min -->
        <item>3600000</item>     <!-- 60 min -->
    </string-array>
</resources>

2. Preference XML 宣告 (res/xml/preferences.xml)

<PreferenceScreen xmlns:android="https://schemas.android.com/apk/res/android">
    <PreferenceCategory android:title="登錄設定">
        <ListPreference
            android:key="auto_logout_time"
            android:title="自動登出時間"
            android:dialogTitle="選擇在線時間"
            android:entries="@array/auto_logout_time_labels"
            android:entryValues="@array/auto_logout_time_values"
            android:defaultValue="600000"
            android:summary="目前: %s" />
    </PreferenceCategory>
</PreferenceScreen>

3. Fragment 載入與監聽變更

public class SettingsFragment extends PreferenceFragmentCompat {
    @Override
    public void onCreatePreferences(Bundle savedInstanceState, String rootKey) {
        setPreferencesFromResource(R.xml.preferences, rootKey);

        ListPreference lp = findPreference("auto_logout_time");
        lp.setOnPreferenceChangeListener((preference, newValue) -> {
            // newValue 為字串,對應 entryValues 中的值
            Log.d("Pref", "登出時間變更: " + newValue);
            return true; // 允許變更
        });
    }
}

關鍵屬性對照

屬性說明
android:entries顯示標籤陣列 (string-array)
android:entryValues實際儲存值陣列 (string-array),長度必須與 entries 相同
android:defaultValue預設值,需與 entryValues 中某項一致
android:summary偏好項下方說明,%s 會自動替換為目前選取的 entry 標籤

進階技巧

  1. 動態更新項目:在 onResume() 中根據伺服器回傳資料重新 setEntries()/setEntryValues()。
  2. 自訂對話框佈局:繼承 ListPreference 覆寫 onPrepareDialogBuilder()。
  3. 搭配 DataStore:新專案建議改用 Preferences DataStore,以 Flow 觀察值變化。

常見坑點

Q: 選取後 summary 不更新?
A: 確認 android:summary 含 %s,且 entryValues 型別為字串(即使是數字也要寫在 string-array)。
Q: 重複定義相同 key?
A: 每個 Preference key 在整個 PreferenceScreen 必須唯一,否則存取會衝突。

掌握 ListPreference 完整流程,即可快速建立單選設定項目並正確持久化使用者選擇。

copyright © 萬盛學電腦網 all rights reserved