ทรัพยากรรายการสถานะสี

ColorStateList คือออบเจ็กต์ที่คุณกำหนดได้ใน XML และใช้เป็นสีที่เปลี่ยนสีได้จริงโดยขึ้นอยู่กับสถานะของออบเจ็กต์ View ที่ใช้ ตัวอย่างเช่น Button วิดเจ็ตอาจอยู่ในสถานะใดสถานะหนึ่งจากหลายสถานะ เช่น ถูกกด ถูกโฟกัส หรือไม่ถูกกดหรือไม่ถูกโฟกัส การใช้รายการสถานะสีช่วยให้คุณระบุสีที่แตกต่างกันสำหรับแต่ละสถานะได้

คุณอธิบายรายการสถานะในไฟล์ XML แต่ละสีจะกำหนดไว้ในองค์ประกอบ <item> ภายในองค์ประกอบ <selector> เดียว <item> แต่ละรายการใช้แอตทริบิวต์ต่างๆ เพื่ออธิบายสถานะที่ใช้

ในระหว่างการเปลี่ยนสถานะแต่ละครั้ง ระบบจะสํารวจรายการสถานะจากบนลงล่าง และจะใช้รายการแรกที่ตรงกับสถานะปัจจุบัน การเลือกไม่ได้อิงตามรายการที่ตรงกัน "ที่สุด" แต่จะอิงตามรายการแรกที่ตรงตามเกณฑ์ขั้นต่ำของสถานะ

หมายเหตุ: หากต้องการระบุทรัพยากรสีแบบคงที่ ให้ใช้ค่า color แบบง่าย

ตำแหน่งไฟล์:
res/color/filename.xml
ระบบจะใช้ชื่อไฟล์เป็นรหัสทรัพยากร
ประเภทข้อมูลทรัพยากรที่คอมไพล์:
ตัวชี้ทรัพยากรไปยัง ColorStateList
ข้อมูลอ้างอิงทรัพยากร:
ใน Java: R.color.filename
ใน XML: @[package:]color/filename
ไวยากรณ์:
<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android" >
    <item
        android:color="hex_color"
        android:lStar="floating_point_value"
        android:state_pressed=["true" | "false"]
        android:state_focused=["true" | "false"]
        android:state_selected=["true" | "false"]
        android:state_checkable=["true" | "false"]
        android:state_checked=["true" | "false"]
        android:state_enabled=["true" | "false"]
        android:state_window_focused=["true" | "false"] />
</selector>
องค์ประกอบ
<selector>
ต้องระบุ นี่คือองค์ประกอบรูท มีองค์ประกอบ <item> อย่างน้อย 1 รายการ

แอตทริบิวต์:

xmlns:android
สตริง ต้องระบุ กำหนดเนมสเปซ XML ซึ่งก็คือ "http://schemas.android.com/apk/res/android"
<item>
กำหนดสีที่จะใช้ในบางสถานะตามที่อธิบายไว้ในแอตทริบิวต์ โดยเป็นองค์ประกอบย่อยขององค์ประกอบ <selector>

แอตทริบิวต์:

android:color
สีแบบเลขฐาน 16 ต้องระบุ สีจะระบุด้วยค่า RGB และช่องอัลฟ่า (ไม่บังคับ)

ค่าจะขึ้นต้นด้วยอักขระเครื่องหมายแฮช (#) เสมอ ตามด้วยข้อมูล Alpha-Red-Green-Blue ในรูปแบบใดรูปแบบหนึ่งต่อไปนี้

  • #RGB
  • #ARGB
  • #RRGGBB
  • #AARRGGBB
android:lStar
จุดลอยตัว ไม่บังคับ แอตทริบิวต์นี้จะปรับเปลี่ยนความสว่างที่รับรู้ได้ของสีพื้นฐาน โดยจะใช้ค่าจุดลอยตัวระหว่าง 0 ถึง 100 หรือแอตทริบิวต์ธีมที่แปลงค่าเป็นค่าดังกล่าว ระบบจะคำนวณสีโดยรวมของรายการโดยแปลงสีพื้นฐานเป็นขอบเขตสีที่เหมาะสำหรับการช่วยเหลือพิเศษ และตั้งค่า L* เป็นค่าที่ระบุในแอตทริบิวต์ lStar

ตัวอย่าง: android:lStar="50"

android:state_pressed
บูลีน "true" หากมีการใช้รายการนี้เมื่อแตะวัตถุ เช่น เมื่อแตะหรือคลิกปุ่ม "false" หากใช้รายการนี้ในสถานะเริ่มต้นที่ไม่ได้แตะ
android:state_focused
บูลีน "true" หากมีการใช้รายการนี้เมื่อโฟกัสออบเจ็กต์ เช่น เมื่อไฮไลต์ปุ่มโดยใช้แทร็กบอลหรือ D-pad ค่าจะเป็น "false" หากใช้รายการนี้ในสถานะเริ่มต้นที่ไม่มีการโฟกัส
android:state_selected
บูลีน "true" หากมีการใช้รายการนี้เมื่อเลือกออบเจ็กต์ เช่น เมื่อเปิดแท็บ ค่าจะเป็น "false" หากใช้รายการนี้เมื่อไม่ได้เลือกออบเจ็กต์
android:state_checkable
บูลีน "true" หากใช้รายการนี้เมื่อออบเจ็กต์เลือกได้ ค่าจะเป็น "false" หากมีการใช้รายการนี้เมื่อออบเจ็กต์ไม่สามารถเลือกได้ มีประโยชน์เฉพาะในกรณีที่ออบเจ็กต์สามารถเปลี่ยนระหว่างวิดเจ็ตที่เลือกได้และเลือกไม่ได้
android:state_checked
บูลีน "true" หากใช้รายการนี้เมื่อเลือกออบเจ็กต์ โดยจะมีค่าเป็น "false" หากใช้เมื่อยกเลิกการเลือกออบเจ็กต์
android:state_enabled
บูลีน "true" หากมีการใช้รายการนี้เมื่อเปิดใช้ออบเจ็กต์ ซึ่งสามารถรับกิจกรรมการแตะหรือการคลิกได้ โดยจะมีค่าเป็น "false" หากใช้เมื่อปิดใช้ออบเจ็กต์
android:state_window_focused
บูลีน "true" หากใช้รายการนี้เมื่อหน้าต่างแอปพลิเคชันอยู่ในโฟกัส ซึ่งหมายความว่าแอปพลิเคชันทำงานอยู่เบื้องหน้า โดยจะมีค่าเป็น "false" หากมีการใช้รายการนี้เมื่อหน้าต่างแอปพลิเคชันไม่ได้โฟกัส เช่น หากมีการดึงหน้าต่างแจ้งเตือนลงมาหรือมีกล่องโต้ตอบปรากฏขึ้น

หมายเหตุ: ระบบจะใช้รายการแรกในรายการสถานะที่ตรงกับสถานะปัจจุบันของออบเจ็กต์ ดังนั้น หากรายการแรกในลิสต์ไม่มีแอตทริบิวต์สถานะก่อนหน้า ระบบจะใช้รายการนั้นทุกครั้ง ด้วยเหตุนี้ ให้วางค่าเริ่มต้นไว้เป็นค่าสุดท้าย ดังที่แสดงในตัวอย่างต่อไปนี้

ตัวอย่าง:
ไฟล์ XML ที่บันทึกไว้ที่ res/color/button_text.xml:
<?xml version="1.0" encoding="utf-8"?>
<selector xmlns:android="http://schemas.android.com/apk/res/android">
    <item android:state_pressed="true"
          android:color="#ffff0000"/> <!-- pressed -->
    <item android:state_focused="true"
          android:color="#ff0000ff"/> <!-- focused -->
    <item android:color="#ff000000"/> <!-- default -->
</selector>

XML เลย์เอาต์ต่อไปนี้ใช้รายการสีกับ View

<Button
    android:layout_width="fill_parent"
    android:layout_height="wrap_content"
    android:text="@string/button_text"
    android:textColor="@color/button_text" />
ดูเพิ่มเติม: