Android 設定畫面可透過 XML 宣告 PreferenceScreen 快速建構,無需大量 Java/Kotlin 程式碼。本文提供完整 XML 範例,涵巢狀分類、編輯文字、核取方塊等常見偏好元件。
<?xml version="1.0" encoding="utf-8"?>
<PreferenceScreen
xmlns:android="https://schemas.android.com/apk/res/android"
android:id="@+id/prefs_screen"
android:key="preferencescreen">
<PreferenceCategory android:title="Assets">
<EditTextPreference
android:key="@string/prefs_assetname_friendslist_key"
android:title="Friends List"
android:summary="Please enter filename"
android:defaultValue="friends.txt" />
<EditTextPreference
android:key="@string/prefs_assetname_picture_key"
android:title="Picture"
android:summary="Please enter filename"
android:defaultValue="pict2.jpg" />
</PreferenceCategory>
<PreferenceCategory android:title="Auto Settings">
<CheckBoxPreference
android:key="@string/prefs_autodelete_key"
android:title="Delete at Startup"
android:summary="Check to clear at startup"
android:defaultValue="false" />
</PreferenceCategory>
</PreferenceScreen>
| 元件 | 用途 | 關鍵屬性 |
|---|---|---|
| PreferenceCategory | 分組標題 | android:title |
| EditTextPreference | 文字輸入框 | key, title, summary, defaultValue |
| CheckBoxPreference | 開關選項 | key, title, summary, defaultValue |
public class SettingsFragment extends PreferenceFragmentCompat {
@Override
public void onCreatePreferences(Bundle savedInstanceState, String rootKey) {
setPreferencesFromResource(R.xml.preferences, rootKey);
}
}
android:dependency 讓某項目僅在另一核取方塊啟用時顯示。android:layout 指定自訂 View。OnPreferenceChangeListener 中攔截並驗證輸入。善用 XML 宣告偏好設定,能大幅減少樣板程式碼並提升維護性。