Google ใช้เทคโนโลยี AI เพื่อแปลเนื้อหาเป็นภาษาที่คุณต้องการ การแปลโดย AI อาจมีข้อผิดพลาด
ทรัพยากรรายการสถานะสี
จัดทุกอย่างให้เป็นระเบียบอยู่เสมอด้วยคอลเล็กชัน
บันทึกและจัดหมวดหมู่เนื้อหาตามค่ากำหนดของคุณ
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" />
- ดูเพิ่มเติม:
-
ตัวอย่างเนื้อหาและโค้ดในหน้าเว็บนี้ขึ้นอยู่กับใบอนุญาตที่อธิบายไว้ในใบอนุญาตการใช้เนื้อหา Java และ OpenJDK เป็นเครื่องหมายการค้าหรือเครื่องหมายการค้าจดทะเบียนของ Oracle และ/หรือบริษัทในเครือ
อัปเดตล่าสุด 2026-11-19 UTC
[[["เข้าใจง่าย","easyToUnderstand","thumb-up"],["แก้ปัญหาของฉันได้","solvedMyProblem","thumb-up"],["อื่นๆ","otherUp","thumb-up"]],[["ไม่มีข้อมูลที่ฉันต้องการ","missingTheInformationINeed","thumb-down"],["ซับซ้อนเกินไป/มีหลายขั้นตอนมากเกินไป","tooComplicatedTooManySteps","thumb-down"],["ล้าสมัย","outOfDate","thumb-down"],["ปัญหาเกี่ยวกับการแปล","translationIssue","thumb-down"],["ตัวอย่าง/ปัญหาเกี่ยวกับโค้ด","samplesCodeIssue","thumb-down"],["อื่นๆ","otherDown","thumb-down"]],["อัปเดตล่าสุด 2026-11-19 UTC"],[],[]]