คอมโพเนนต์ Switch
ช่วยให้ผู้ใช้สลับระหว่างสถานะ 2 สถานะ ได้แก่ เลือกและไม่เลือก ใช้สวิตช์เพื่อให้ผู้ใช้ดำเนินการอย่างใดอย่างหนึ่งต่อไปนี้
- เปิดหรือปิดการตั้งค่า
- เปิดหรือปิดใช้ฟีเจอร์
- เลือกตัวเลือก
คอมโพเนนต์นี้ประกอบด้วย 2 ส่วน ได้แก่ ภาพปกและแทร็ก โดยนิ้วหัวแม่มือคือส่วนที่ลากได้ของสวิตช์ ส่วนแทร็กคือพื้นหลัง ผู้ใช้สามารถลากปุ่มเปิด/ปิดไปทางซ้ายหรือขวาเพื่อเปลี่ยนสถานะของสวิตช์ นอกจากนี้ ยังแตะสวิตช์เพื่อตรวจสอบและล้างข้อมูลได้ด้วย
ความเข้ากันได้ของเวอร์ชัน
การใช้งานนี้กำหนดให้โปรเจ็กต์ของคุณตั้งค่า minSDK เป็น API ระดับ 21 ขึ้นไป
ทรัพยากร Dependency
ติดตั้งใช้งานสวิตช์
ตัวอย่างต่อไปนี้เป็นการใช้งานแบบขั้นต่ำของคอมโพสิเบิล Switch
ผลลัพธ์
![สวิตช์พื้นฐานที่ไม่ได้เลือก](https://developer.android.com/static/develop/ui/compose/images/components/switch-deactivated.png?hl=th)
![สวิตช์พื้นฐานที่เลือกไว้](https://developer.android.com/static/develop/ui/compose/images/components/switch.png?hl=th)
สร้างภาพปกที่กำหนดเอง
คุณสามารถส่งคอมโพสิเบิลใดก็ได้สำหรับพารามิเตอร์ thumbContent
เพื่อสร้างภาพปกที่กำหนดเอง ต่อไปนี้คือตัวอย่างสวิตช์ที่ใช้ไอคอนที่กำหนดเองสำหรับภาพขนาดย่อ
ผลลัพธ์
ลักษณะที่เลือกไม่ได้จะเหมือนกับตัวอย่างในส่วนก่อนหน้า อย่างไรก็ตาม เมื่อเลือกแล้ว การใช้งานนี้จะปรากฏดังนี้
![สวิตช์ที่ใช้พารามิเตอร์ thumbContent เพื่อแสดงไอคอนที่กำหนดเองเมื่อเลือก](https://developer.android.com/static/develop/ui/compose/images/components/switch-icon.png?hl=th)
ใช้สีที่กำหนดเอง
ใช้พารามิเตอร์ colors
เพื่อเปลี่ยนสีปุ่มเปิด/ปิดและรางของปุ่ม โดยพิจารณาว่ามีการเลือกปุ่มเปิด/ปิดหรือไม่
ผลลัพธ์
![สวิตช์ที่ใช้พารามิเตอร์ colors เพื่อแสดงสวิตช์ที่มีสีที่กำหนดเองสำหรับทั้งปุ่มกดและหมุด](https://developer.android.com/static/develop/ui/compose/images/components/switch-colors.png?hl=th)
ข้อมูลสำคัญ
พารามิเตอร์พื้นฐาน
checked
: สถานะเริ่มต้นของสวิตช์onCheckedChange
: ฟังก์ชันการเรียกกลับที่เรียกใช้เมื่อสถานะของสวิตช์มีการเปลี่ยนแปลงenabled
: เปิดหรือปิดใช้สวิตช์colors
: สีที่ใช้สำหรับสวิตช์
พารามิเตอร์ขั้นสูง
thumbContent
: ใช้เพื่อปรับแต่งลักษณะที่ปรากฏของภาพขนาดย่อเมื่อเลือกcolors
: ใช้เพื่อปรับแต่งสีของแทร็กและภาพปก
คอลเล็กชันที่มีคู่มือนี้
คู่มือนี้เป็นส่วนหนึ่งของคอลเล็กชันคู่มือฉบับย่อที่มีการดูแลจัดการ ซึ่งครอบคลุมเป้าหมายการพัฒนา Android ที่กว้างขึ้น ดังนี้
![](https://developer.android.com/static/images/quick-guides/collection-illustration.png?hl=th)