萬盛學電腦網

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

Android PreferenceScreen XML 宣告完整範例

前言

Android 設定畫面可透過 XML 宣告 PreferenceScreen 快速建構,無需大量 Java/Kotlin 程式碼。本文提供完整 XML 範例,涵巢狀分類、編輯文字、核取方塊等常見偏好元件。

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 讓某項目僅在另一核取方塊啟用時顯示。
  • 自訂 Layout:透過 android:layout 指定自訂 View。
  • 資料驗證:在 OnPreferenceChangeListener 中攔截並驗證輸入。

善用 XML 宣告偏好設定,能大幅減少樣板程式碼並提升維護性。

copyright © 萬盛學電腦網 all rights reserved