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