คอมโพเนนต์ Switch
ช่วยให้ผู้ใช้สลับระหว่างสถานะ 2 สถานะ ได้แก่ เลือกและไม่เลือก ใช้สวิตช์เพื่อให้ผู้ใช้ดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้
- เปิดหรือปิดการตั้งค่า
- เปิดหรือปิดใช้ฟีเจอร์
- เลือกตัวเลือก
คอมโพเนนต์นี้ประกอบด้วย 2 ส่วน ได้แก่ ภาพปกและแทร็ก โดยนิ้วหัวแม่มือคือส่วนที่ลากได้ของสวิตช์ ส่วนแทร็กคือพื้นหลัง ผู้ใช้สามารถลากปุ่มเปิด/ปิดไปทางซ้ายหรือขวาเพื่อเปลี่ยนสถานะของสวิตช์ นอกจากนี้ ยังแตะสวิตช์เพื่อตรวจสอบและล้างข้อมูลได้ด้วย
ความเข้ากันได้ของเวอร์ชัน
การใช้งานนี้กำหนดให้โปรเจ็กต์ของคุณตั้งค่า minSDK เป็น API ระดับ 21 ขึ้นไป
ทรัพยากร Dependency
ติดตั้งใช้งานสวิตช์
ตัวอย่างต่อไปนี้เป็นการใช้งานแบบขั้นต่ำของคอมโพสิเบิล Switch
ผลลัพธ์
สร้างภาพปกที่กำหนดเอง
คุณสามารถส่งคอมโพสิเบิลใดก็ได้สำหรับพารามิเตอร์ thumbContent
เพื่อสร้างภาพปกที่กำหนดเอง ต่อไปนี้คือตัวอย่างสวิตช์ที่ใช้ไอคอนที่กำหนดเองสำหรับภาพขนาดย่อ
ผลลัพธ์
ลักษณะที่เลือกไม่ได้จะเหมือนกับตัวอย่างในส่วนก่อนหน้า อย่างไรก็ตาม เมื่อเลือกแล้ว การใช้งานนี้จะปรากฏดังนี้
ใช้สีที่กำหนดเอง
ใช้พารามิเตอร์ colors
เพื่อเปลี่ยนสีปุ่มเปิด/ปิดและรางของปุ่ม โดยพิจารณาว่ามีการเลือกปุ่มเปิด/ปิดหรือไม่
ผลลัพธ์
ข้อมูลสำคัญ
พารามิเตอร์พื้นฐาน
checked
: สถานะเริ่มต้นของสวิตช์onCheckedChange
: ฟังก์ชันการเรียกกลับที่เรียกใช้เมื่อสถานะของสวิตช์มีการเปลี่ยนแปลงenabled
: เปิดหรือปิดใช้สวิตช์colors
: สีที่ใช้สำหรับสวิตช์
พารามิเตอร์ขั้นสูง
thumbContent
: ใช้เพื่อปรับแต่งลักษณะที่ปรากฏของภาพขนาดย่อเมื่อเลือกcolors
: ใช้เพื่อปรับแต่งสีของแทร็กและภาพปก
คอลเล็กชันที่มีคู่มือนี้
คู่มือนี้เป็นส่วนหนึ่งของคอลเล็กชันคู่มือฉบับย่อที่มีการดูแลจัดการ ซึ่งครอบคลุมเป้าหมายการพัฒนา Android ที่กว้างขึ้น ดังนี้