ListPreference 讓使用者從單選清單選取值,並自動將選取值以字串存入 SharedPreferences。本文完整示範陣列資源定義、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>
<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>
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 標籤 |
onResume() 中根據伺服器回傳資料重新 setEntries()/setEntryValues()。ListPreference 覆寫 onPrepareDialogBuilder()。Preferences DataStore,以 Flow 觀察值變化。android:summary 含 %s,且 entryValues 型別為字串(即使是數字也要寫在 string-array)。掌握 ListPreference 完整流程,即可快速建立單選設定項目並正確持久化使用者選擇。