ปรับแต่งค่ากำหนด UI ของรถ

หน้านี้จะอธิบายวิธีใช้และปรับแต่งองค์ประกอบในแพ็กเกจ com.android.car.ui.preference ซึ่งประกอบด้วยองค์ประกอบ UI ที่ใช้แสดงค่ากําหนดสําหรับแอปได้

องค์ประกอบส่วนใหญ่เป็นคลาสย่อยของcom.androidx.preferenceที่คุณเพิ่มการปรับแต่ง CarUi ในกรณีส่วนใหญ่ คุณสามารถใช้องค์ประกอบในแพ็กเกจ com.android.car.ui.preferences โดยใช้ com.android.car.PreferenceFragment PreferenceFragment จะแทนที่องค์ประกอบ androidx.preference ทั้งหมดด้วยองค์ประกอบที่เทียบเท่าใน car.ui.preferences หากต้องการดูฟังก์ชันเหล่านี้ในการใช้งานจริง โปรดดูแอปอ้างอิง car-ui-lib Paintbooth ตัวอย่างเช่น

รูปที่ 1 เลย์เอาต์ค่ากำหนด UI ของรถ

ประเภทค่ากําหนดที่ใช้ได้

ส่วนนี้จะอธิบายประเภทค่ากำหนด UI ของรถยนต์

PreferenceFragment

PreferenceFragment เป็นคลาสย่อยของ androidx.preference.PreferenceFragmentCompat และเป็นคลาสพื้นฐานที่ไคลเอ็นต์ควรใช้ ในระหว่างการเรียกใช้ setPreferenceScreen คลาสนี้จะแทนที่องค์ประกอบจาก androidx.preference ด้วยองค์ประกอบที่เทียบเท่าจาก car.ui.preference โดยอัตโนมัติ

<style name="PreferenceFragment.CarUi">
        <item name="android:divider">?android:attr/listDivider</item>
        <item name="android:layout">@layout/car_ui_preference_fragment_with_toolbar</item>
</style>

CarUiPreference

คลาสนี้เทียบเท่ากับคลาส androidx.preference.Preference ของ CarUi ที่รองรับแอตทริบิวต์ต่อไปนี้ ซึ่งปรับแต่งได้โดยใช้การวางซ้อนทรัพยากรรันไทม์ (RRO) องค์ประกอบ CarUi อื่นๆ ทั้งหมดที่ใช้รูปแบบ CarUiPreference รูปแบบต่างๆ รองรับแอตทริบิวต์ต่อไปนี้ด้วย

<declare-styleable name="CarUiPreference">
      <!-- Toggle for showing chevron -->
      <attr name="showChevron" format="boolean" />
      <!-- Show ripple when disabled preference is clicked -->
      <attr name="showRippleOnDisabledPreference" format="boolean" />
</declare-styleable>

ต่อไปนี้คือรูปแบบพื้นฐานของ com.android.car.ui.preference ซึ่งขยายธีม androidx.Preference มีการกําหนด chevron drawable ใน car_ui_preference_icon_chevron.xml

<selector xmlns:android="http://schemas.android.com/apk/res/android">
  <item android:state_enabled="false" android:drawable="@drawable/car_ui_preference_icon_chevron_disabled"/>
  <item android:state_enabled="true" android:drawable="@drawable/car_ui_preference_icon_chevron_enabled"/>
</selector>

ripple ได้รับการกําหนดไว้ใน car_ui_recyclerview_button_ripple_background

<ripple
    xmlns:android="http://schemas.android.com/apk/res/android"
    android:color="@color/car_ui_ripple_color" />

<style name="Preference.C>arUi"<;
        item name="all>owDiv<iderB>elow"<;false/item
        item name>=&quo<t;all>owDivider<Above"false/item
    >    item name="andro<id:la>y<out&qu>ot;@layout/car_ui_preference/item
/style

หากมีการวางซ้อนเลย์เอาต์ในสไตล์ด้านบน ลูกค้าต้องตรวจสอบว่าเลย์เอาต์ใหม่ระบุรหัสที่คลาสandroidxที่เกี่ยวข้องคาดหวังไว้เป็นอย่างน้อย ซึ่งมีผลกับองค์ประกอบอื่นๆ ที่ใช้สไตล์พื้นฐานนี้ด้วย

CarUiDropDownPreference

รายการนี้เทียบเท่ากับคลาส androidx.preference.DropDownPreference ใน CarUi และใช้รูปแบบต่อไปนี้

<style name="Preference.CarUi.Drop>Down"<;
        item name=">android:layout"@layout/car_ui<_pref>e<rence_>dropdown/item
/style

CarUiRadioButtonPreference

คลาสย่อยของ androidx.preference.TwoStatePreference นี้จะขยายเลย์เอาต์ car_ui_radio_button_preference_widget ในระหว่างการเริ่มต้น หากวางเลย์เอาต์นี้ซ้อนกันใน RRO เลย์เอาต์ใหม่ต้องมีองค์ประกอบประเภท android.widget.RadioButton ที่มีรหัส R.id.radio_button และต้องมีองค์ประกอบและรหัสอื่นๆ ที่คลาสพื้นฐานกำหนด

CarUiSwitchPreference

ค่านี้เทียบเท่ากับคลาส androidx.preference.SwitchPreference ใน CarUi ความแตกต่างคือเมื่อไม่ได้เปิดใช้องค์ประกอบนี้ ระบบจะแสดงข้อความแบบเป็นแถบสั้นๆ คุณปรับแต่งข้อความของข้อความแจ้งได้ด้วยการเรียกใช้เมธอด setMessageToShowWhenDisabledPreferenceClicked ใน Android 10 และ Android 11 องค์ประกอบนี้ใช้สไตล์ต่อไปนี้

<style name="Preference.CarUi.SwitchPrefer>ence"<;
        item name="androi>d:widgetLayout"@layout/car_ui_pref<erenc>e_widget_<switch/item
        item name=&q>uot;android:switchTextOn"@stri<ng/ca>r_ui_pref<erence_switch_on/item
        ite>m name="android:switchTextOff&q<uot;@>s<tring/>car_ui_preference_switch_off/item
/style

CarUiTwoActionPreference

ซับคลาสของ CarUiPreference ที่เปิดใช้การดําเนินการรอง แอตทริบิวต์ที่สามารถใช้ปรับแต่งองค์ประกอบนี้มีดังนี้

<declare-styleable name="CarUiTwoActionPrefer>ence"<;
        !-- Determines if the secondary action is initiall>y shown -<-
        attr name="actionShown&quo>t<; format="boo>lean"/
/declare-styleable

องค์ประกอบนี้ใช้สไตล์เดียวกับคลาสพื้นฐาน และต้องใช้ R.id.action_widget_container และ android.R.id.widget_frame

CarUiDialogFragment

คลาสนี้ยืมมาจาก androidx.preference.PreferenceDialogFragmentCompat แบบที่เป็นอยู่ โดยมีการเพิ่มบางอย่างสำหรับ CarUi โดยเฉพาะ ลูกค้าควรใช้คลาสย่อยของคลาสนี้เพื่อนำเสนอแพลตฟอร์มธีม AlertDialog

PreferenceDialogFragment

คลาสย่อยโดยตรงของ CarUiDialogFragment ลูกค้าควรสร้างคลาสย่อยของคลาสนี้เพื่อนำเสนอแพลตฟอร์มที่มีธีม AlertDialog

CarUiEditTextPreference

รายการต่อไปนี้คือ CarUi ที่เทียบเท่าandroidx.preference.EditTextPreference คลาส

<style name="Preference.CarUi.DialogPreference.EditTextPrefer>ence"<;
        item name="androi>d:dialogLayout"@layout/car_ui_prefer<ence_>d<ialog_>edittext/item
/style

หากมีการวางซ้อนเลย์เอาต์ในสไตล์ด้านบน ลูกค้าต้องตรวจสอบว่าเลย์เอาต์ใหม่ระบุรหัสที่คลาส androidx.preference.EditTextPreference คาดไว้

EditTextPreferenceDialogFragment

คลาสย่อยโดยตรงของ PreferenceDialogFragment และ CarUi ที่เทียบเท่าของคลาส androidx.preference.PreferenceDialogFragments ลูกค้าควรใช้คลาสนี้เพื่อนำเสนอแพลตฟอร์มธีมใดก็ได้ AlertDialog

CarUiSeekBarDialogPreference

การใช้งานคลาส androidx.preference.DialogPreference ซึ่งมีฟังก์ชันการทำงานSeekBar

<style name="Preference.CarUi.SeekBarPrefer>ence"<;
        item name=">android:layout"@layout/car_ui_prefe<rence>_widget_s<eekbar/item
        it>em n<ame=&>quot;adju<stable"true/item
      >  ite<m nam>e<=">;showSeekBarValue"false/item
/style

SeekBarPreferenceDialogFragment

ส่วนที่ระบุเลย์เอาต์ที่มีแถบเลื่อนหาตำแหน่งในกล่องโต้ตอบ

CarUiListPreference

CarUi ที่เทียบเท่าคลาส androidx.preference.ListPreference

ListPreferenceFragment

ส่วนที่ระบุเลย์เอาต์ที่มี androidx.preference.ListPreference

CarUiMultiSelectListPreference

CarUi ที่เทียบเท่าของคลาส androidx.preference.Preference

MultiSelectListPreferenceFragment

ส่วนที่ระบุเลย์เอาต์ที่มี com.android.car.ui.CarUiMultiSelectListPreference