Button
ปุ่มเป็นคอมโพเนนต์พื้นฐานที่ช่วยให้ผู้ใช้ทริกเกอร์การดำเนินการที่กําหนดไว้ได้ ปุ่มมี 5 ประเภท ตารางต่อไปนี้อธิบายลักษณะของปุ่มแต่ละประเภท 5 ประเภท รวมถึงตําแหน่งที่คุณควรใช้ปุ่ม
ประเภท |
รูปลักษณ์ |
วัตถุประสงค์ |
---|---|---|
เติมพื้น |
พื้นหลังสีทึบที่มีข้อความตัดกัน |
ปุ่มที่เน้นสูง ไอคอนเหล่านี้มีไว้สําหรับการดําเนินการหลักในแอปพลิเคชัน เช่น "ส่ง" และ "บันทึก" เอฟเฟกต์เงาเน้นความสำคัญของปุ่ม |
โทนสีแบบทึบ |
สีพื้นหลังจะแตกต่างกันไปตามพื้นผิว |
และสำหรับการกระทำหลักหรือการกระทำที่สําคัญ ปุ่มแบบเต็มจะดูมีน้ำหนักมากขึ้นและเหมาะกับฟังก์ชันต่างๆ เช่น "เพิ่มลงในรถเข็น" และ "ลงชื่อเข้าใช้" |
สูงกว่าปกติ |
โดดเด่นด้วยเงา |
เหมาะกับบทบาทที่คล้ายกับปุ่มโทนสี เพิ่มระดับความสูงเพื่อให้ปุ่มปรากฏอย่างโดดเด่นยิ่งขึ้น |
เติมขอบ |
มีเส้นขอบที่ไม่มีสี |
ปุ่มที่เน้นระดับกลาง ซึ่งมีการดำเนินการที่สำคัญแต่ไม่สำคัญที่สุด ปุ่มเหล่านี้จับคู่กับปุ่มอื่นๆ ได้ดีเพื่อระบุว่ามีการดำเนินการสำรองอย่างอื่น เช่น "ยกเลิก" หรือ "กลับ" |
ข้อความ |
แสดงข้อความที่ไม่มีพื้นหลังหรือเส้นขอบ |
ปุ่มที่เน้นน้อย เหมาะสำหรับการดำเนินการที่ไม่สำคัญมาก เช่น ลิงก์การไปยังส่วนต่างๆ หรือฟังก์ชันรอง เช่น "ดูข้อมูลเพิ่มเติม" หรือ "ดูรายละเอียด" |
รูปภาพต่อไปนี้แสดงปุ่ม 5 ประเภทใน Material Design
แพลตฟอร์ม API
onClick
: ฟังก์ชันที่เรียกใช้เมื่อผู้ใช้กดปุ่มenabled
: เมื่อเป็นเท็จ พารามิเตอร์นี้จะทําให้ปุ่มปรากฏขึ้นโดยใช้งานไม่ได้และไม่ทำงานcolors
: อินสแตนซ์ของButtonColors
ที่ใช้กำหนดสีที่ใช้ในปุ่มcontentPadding
: ระยะห่างจากขอบภายในปุ่ม
ปุ่มแบบเติมสี
คอมโพเนนต์ปุ่มแบบเติมสีใช้คอมโพสิเบิล Button
พื้นฐาน โดยค่าเริ่มต้น รูปภาพจะเติมด้วยสีพื้น ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้คอมโพเนนต์
@Composable fun FilledButtonExample(onClick: () -> Unit) { Button(onClick = { onClick() }) { Text("Filled") } }
การติดตั้งใช้งานนี้จะปรากฏดังนี้
ปุ่มโทนสีแบบเติมสี
คอมโพเนนต์ปุ่มโทนสีแบบเติมใช้คอมโพสิเบิล FilledTonalButton
โดยค่าเริ่มต้น รูปภาพจะเติมด้วยสีโทน
ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้คอมโพเนนต์
@Composable fun FilledTonalButtonExample(onClick: () -> Unit) { FilledTonalButton(onClick = { onClick() }) { Text("Tonal") } }
การติดตั้งใช้งานนี้จะปรากฏดังนี้
ปุ่มแบบเติมขอบ
คอมโพเนนต์ปุ่มที่มีเส้นขอบใช้คอมโพสิเบิล OutlinedButton
โดยจะปรากฏขึ้นพร้อมเส้นขอบโดยค่าเริ่มต้น
ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้คอมโพเนนต์
@Composable fun OutlinedButtonExample(onClick: () -> Unit) { OutlinedButton(onClick = { onClick() }) { Text("Outlined") } }
การติดตั้งใช้งานนี้จะปรากฏดังนี้
ปุ่มแบบยกขึ้น
คอมโพเนนต์ปุ่มที่ยกระดับใช้คอมโพสิเบิล ElevatedButton
โดยจะมีเงาที่แสดงถึงเอฟเฟกต์ระดับความสูงโดยค่าเริ่มต้น โปรดทราบว่าปุ่มนี้มีลักษณะเป็นปุ่มที่มีเส้นขอบและมีเงา
ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้คอมโพเนนต์
@Composable fun ElevatedButtonExample(onClick: () -> Unit) { ElevatedButton(onClick = { onClick() }) { Text("Elevated") } }
การติดตั้งใช้งานนี้จะปรากฏดังนี้
ปุ่มข้อความ
คอมโพเนนต์ปุ่มข้อความใช้คอมโพสิเบิล TextButton
จนกว่าจะกดปุ่ม ข้อความจะปรากฏเป็นข้อความเท่านั้น โดยจะไม่มีเส้นขอบหรือพื้นสีทึบโดยค่าเริ่มต้น
ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้คอมโพเนนต์
@Composable fun TextButtonExample(onClick: () -> Unit) { TextButton( onClick = { onClick() } ) { Text("Text Button") } }
การติดตั้งใช้งานนี้จะปรากฏดังนี้