ปุ่ม

ปุ่มเป็นองค์ประกอบพื้นฐานที่ช่วยให้ผู้ใช้เรียกใช้การดำเนินการที่กำหนดไว้ได้ ปุ่มมี 5 ประเภท ตารางนี้อธิบายลักษณะของปุ่มทั้ง 5 ประเภท รวมถึงตำแหน่งที่คุณควรใช้ปุ่มเหล่านั้น

ประเภท ลักษณะที่ปรากฏ วัตถุประสงค์
เติมพื้น พื้นหลังสีทึบพร้อมข้อความที่ตัดกัน ปุ่มที่เน้นสูง ใช้สำหรับการดำเนินการหลักในแอปพลิเคชัน เช่น "ส่ง" และ "บันทึก" เอฟเฟกต์เงาจะไฮไลต์ความสำคัญของปุ่ม
คุมโทนแบบทึบ สีพื้นหลังจะแตกต่างกันไปตามพื้นผิว นอกจากนี้ยังใช้สำหรับการดำเนินการหลักหรือการดำเนินการที่สำคัญด้วย ปุ่มแบบเต็มสีช่วยเพิ่มน้ำหนักของสายตาและเหมาะกับฟังก์ชันต่างๆ เช่น "เพิ่มลงในรถเข็น" และ "ลงชื่อเข้าใช้"
สูงกว่าปกติ โดดเด่นด้วยการมีเงา มีวัตถุประสงค์คล้ายกับปุ่มโทนสี เพิ่มระดับความสูงเพื่อให้ปุ่มโดดเด่นยิ่งขึ้น
เติมขอบ มีเส้นขอบแต่ไม่มีสีเติม ปุ่มที่เน้นปานกลางซึ่งมีการดำเนินการที่สำคัญแต่ไม่ใช่การดำเนินการหลัก ปุ่มประเภทนี้เหมาะที่จะใช้ร่วมกับปุ่มอื่นๆ เพื่อระบุการดำเนินการรองที่เป็นทางเลือก เช่น "ยกเลิก" หรือ "กลับ"
ข้อความ แสดงข้อความโดยไม่มีพื้นหลังหรือเส้นขอบ ปุ่มที่เน้นน้อย เหมาะสำหรับการดำเนินการที่มีความสำคัญน้อยกว่า เช่น ลิงก์การนำทาง หรือฟังก์ชันรอง เช่น "ดูข้อมูลเพิ่มเติม" หรือ "ดูรายละเอียด"

รูปภาพนี้แสดงปุ่ม 5 ประเภทใน Material Design

ตัวอย่างของคอมโพเนนต์ปุ่มทั้ง 5 รายการ โดยไฮไลต์ลักษณะเฉพาะของแต่ละรายการ
รูปที่ 1 องค์ประกอบปุ่ม 5 รายการ

แพลตฟอร์ม API

  • onClick: ฟังก์ชันที่ระบบเรียกใช้เมื่อผู้ใช้กดปุ่ม
  • enabled: เมื่อ false พารามิเตอร์นี้จะทำให้ปุ่มปรากฏเป็นไม่พร้อมใช้งานและไม่ได้ใช้งาน
  • colors: อินสแตนซ์ของ ButtonColors ที่กำหนดสีที่ใช้ในปุ่ม
  • contentPadding: ระยะห่างจากขอบภายในปุ่ม

ปุ่มแบบทึบ

คอมโพเนนต์ปุ่มแบบเติมใช้ Button Composable พื้นฐาน โดยค่าเริ่มต้นจะมีการเติมสีทึบ ข้อมูลโค้ดแสดงวิธีใช้คอมโพเนนต์และแสดงตัวอย่างแบบอินเทอร์แอกทีฟ

@Composable
fun FilledButtonExample(onClick: () -> Unit) {
    Button(onClick = { onClick() }) {
        Text("Filled")
    }
}

ปุ่มสีทึบแบบมีโทนสี

คอมโพเนนต์ปุ่มแบบเติมสีโทนเดียวใช้คอมโพสิเบิล FilledTonalButton โดยค่าเริ่มต้น ระบบจะเติมสีโทนเดียวกับสีพื้นหลัง

ข้อมูลโค้ดแสดงวิธีใช้คอมโพเนนต์และดูตัวอย่างแบบอินเทอร์แอกทีฟ

@Composable
fun FilledTonalButtonExample(onClick: () -> Unit) {
    FilledTonalButton(onClick = { onClick() }) {
        Text("Tonal")
    }
}

ปุ่มแบบมีเส้นขอบ

คอมโพเนนต์ปุ่มที่มีเส้นขอบใช้ OutlinedButton Composable โดยจะปรากฏพร้อมกับเส้นขอบโดยค่าเริ่มต้น

ข้อมูลโค้ดแสดงวิธีใช้คอมโพเนนต์และแสดงตัวอย่างแบบอินเทอร์แอกทีฟ

@Composable
fun OutlinedButtonExample(onClick: () -> Unit) {
    OutlinedButton(onClick = { onClick() }) {
        Text("Outlined")
    }
}

ปุ่มแบบยกขึ้น

คอมโพเนนต์ปุ่มที่ยกขึ้นจะใช้ ElevatedButton Composable โดยค่าเริ่มต้นจะมีเงาที่แสดงถึงเอฟเฟกต์การยกขึ้น เป็นปุ่มแบบทึบที่มีเงา

ข้อมูลโค้ดแสดงวิธีใช้คอมโพเนนต์และแสดงตัวอย่างแบบอินเทอร์แอกทีฟ

@Composable
fun ElevatedButtonExample(onClick: () -> Unit) {
    ElevatedButton(onClick = { onClick() }) {
        Text("Elevated")
    }
}

ปุ่มข้อความ

คอมโพเนนต์ปุ่มข้อความใช้ TextButton Composable โดยจะปรากฏเป็นข้อความเท่านั้นจนกว่าจะกด โดยค่าเริ่มต้นจะไม่มีการเติมสีทึบหรือเส้นขอบ

ข้อมูลโค้ดแสดงวิธีใช้คอมโพเนนต์และดูตัวอย่างแบบอินเทอร์แอกทีฟ

@Composable
fun TextButtonExample(onClick: () -> Unit) {
    TextButton(
        onClick = { onClick() }
    ) {
        Text("Text Button")
    }
}

การอัปเดต M3 Expressive

ตอนนี้ปุ่มมีรูปร่างและขนาดที่หลากหลายมากขึ้น รวมถึงมีฟังก์ชันการเปิด/ปิด และเปลี่ยนรูปร่างได้เมื่อเลือก

ขนาดและรูปร่างของปุ่ม
รูปที่ 7 รูปแบบขนาดและรูปร่างของปุ่ม Material 3 Expressive

ดูข้อมูลเพิ่มเติมเกี่ยวกับการอัปเดต M3 Expressive สำหรับปุ่มได้ที่หลักเกณฑ์เกี่ยวกับปุ่มของ Material Design 3

ปุ่มเปิด-ปิด

ปุ่มเปิด/ปิดมี 4 รูปแบบ ได้แก่ แบบทึบ แบบนูน แบบโทนสี และแบบมีเส้นขอบ

เติมพื้น

รูปแบบปุ่มที่เติมสีมีผลต่อการมองเห็นมากที่สุดรองจากปุ่มการทำงานแบบลอย (FAB) และควรใช้สำหรับการดำเนินการขั้นสุดท้ายที่สำคัญซึ่งทำให้ขั้นตอนเสร็จสมบูรณ์ เช่น บันทึก เข้าร่วมเลย หรือยืนยัน

ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้ปุ่มเปิด/ปิดแบบเติมสี

@Composable
fun ToggleButtonSample() {
    var checked by remember { mutableStateOf(false) }
    ToggleButton(checked = checked, onCheckedChange = { checked = it }) {
        Text("Button")
    }
}

สูงกว่าปกติ

ปุ่มแบบยกขึ้นจะแยกออกจากพื้นหลังที่โดดเด่นสะดุดตา

ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้ปุ่มเปิด/ปิดแบบยกขึ้น

@Composable
fun ElevatedToggleButtonSample() {
    var checked by remember { mutableStateOf(false) }
    ElevatedToggleButton(checked = checked, onCheckedChange = { checked = it }) {
        Text("Elevated Button")
    }
}

คุมโทน

รูปแบบปุ่มโทนสีจะเติมด้วยสีโทนโดยค่าเริ่มต้น ซึ่งมีประโยชน์ในบริบทที่ปุ่มที่มีลำดับความสำคัญต่ำกว่าต้องการการเน้นมากกว่าที่ปุ่มแบบเส้นขอบจะให้ได้เล็กน้อย

ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้ปุ่มเปิด/ปิดแบบโทนสีโดยใช้ FilledTonalToggleButton

@Composable
fun TonalToggleButtonSample() {
    var checked by remember { mutableStateOf(false) }
    FilledTonalToggleButton(checked = checked, onCheckedChange = { checked = it }) {
        Text("Tonal Button")
    }
}

เติมขอบ

สไตล์ที่มีเส้นขอบเหมาะสำหรับปุ่มที่เน้นปานกลางซึ่งมีการดำเนินการที่สำคัญ แต่ไม่ใช่การดำเนินการหลักในผลิตภัณฑ์

ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้ปุ่มเปิด/ปิดแบบมีเส้นขอบ

@Composable
fun OutlinedToggleButtonSample() {
    var checked by remember { mutableStateOf(false) }
    OutlinedToggleButton(checked = checked, onCheckedChange = { checked = it }) {
        Text("Outlined Button")
    }
}

ตัวเลือกขนาด

Material 3 Expressive เพิ่มตัวเลือกขนาด 4 รายการนอกเหนือจากขนาดเล็กที่เป็นค่าเริ่มต้น ได้แก่ เล็กพิเศษ กลาง ใหญ่ และใหญ่พิเศษ โอเวอร์โหลดปุ่มที่สื่ออารมณ์จะใช้พารามิเตอร์ shapes ที่จำเป็น หรือคุณจะใช้การปรับขนาดที่สื่ออารมณ์กับ Button มาตรฐานก็ได้โดยตั้งค่า ButtonDefaults.contentPaddingFor(...) ดังตัวอย่างต่อไปนี้

เล็ก (ค่าเริ่มต้นที่มีอยู่)

ขนาดปุ่มเล็ก:

  • ความสูง: 40dp

ปุ่มเริ่มต้น

ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้ปุ่มขนาดเล็กที่มีไอคอน

@Composable
fun ButtonWithIconSample() {
    Button(
        onClick = { /* Do something! */ },
        contentPadding = ButtonDefaults.contentPaddingFor(ButtonDefaults.MinHeight, hasStartIcon = true),
    ) {
        Icon(
            painter = rememberVectorPainter(AppIcons.FavoriteFilled),
            contentDescription = null,
            modifier = Modifier.size(ButtonDefaults.iconSizeFor(ButtonDefaults.MinHeight)),
        )
        Spacer(Modifier.size(ButtonDefaults.iconSpacingFor(ButtonDefaults.MinHeight)))
        Text("Like")
    }
}

ปุ่มเปิด/ปิด

ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้ปุ่มเปิด/ปิดขนาดเล็กที่มีไอคอน

@Composable
fun ToggleButtonWithIconSample() {
    var checked by remember { mutableStateOf(false) }
    ToggleButton(checked = checked, onCheckedChange = { checked = it }) {
        Icon(
            painter = rememberVectorPainter(if (checked) AppIcons.FavoriteFilled else AppIcons.Favorite),
            contentDescription = null,
            modifier = Modifier.size(ButtonDefaults.IconSize),
        )
        Spacer(Modifier.size(ButtonDefaults.IconSpacing))
        Text("Like")
    }
}

เล็กพิเศษ

ขนาดปุ่มเล็กพิเศษ

  • ความสูง: 32dp

ปุ่มเริ่มต้น

ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้ปุ่มขนาดเล็กพิเศษที่มีไอคอน

@Composable
fun XSmallButtonWithIconSample() {
    val size = ButtonDefaults.ExtraSmallContainerHeight
    Button(
        onClick = { /* Do something! */ },
        modifier = Modifier.heightIn(size),
        contentPadding = ButtonDefaults.contentPaddingFor(size, hasStartIcon = true),
    ) {
        Icon(
            painter = rememberVectorPainter(AppIcons.EditFilled),
            contentDescription = null,
            modifier = Modifier.size(ButtonDefaults.iconSizeFor(size)),
        )
        Spacer(Modifier.size(ButtonDefaults.iconSpacingFor(size)))
        Text("Label")
    }
}

ปุ่มเปิด/ปิด

ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้ปุ่มเปิด/ปิดขนาดเล็กพิเศษที่มีไอคอน

@Composable
fun XSmallToggleButtonWithIconSample() {
    var checked by remember { mutableStateOf(false) }
    val size = ButtonDefaults.ExtraSmallContainerHeight
    ToggleButton(
        checked = checked,
        onCheckedChange = { checked = it },
        modifier = Modifier.heightIn(size),
        shapes = ToggleButtonDefaults.shapesFor(size),
        contentPadding = ButtonDefaults.contentPaddingFor(size),
    ) {
        Icon(
            painter = rememberVectorPainter(if (checked) AppIcons.EditFilled else AppIcons.Edit),
            contentDescription = null,
            modifier = Modifier.size(ButtonDefaults.iconSizeFor(size)),
        )
        Spacer(Modifier.size(ButtonDefaults.iconSpacingFor(size)))
        Text("Label")
    }
}

ปานกลาง

ขนาดของปุ่มระดับกลาง

  • ความสูง: 56dp

ปุ่มเริ่มต้น

ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้ปุ่มขนาดกลางที่มีไอคอน

@Composable
fun MediumButtonWithIconSample() {
    val size = ButtonDefaults.MediumContainerHeight
    Button(
        onClick = { /* Do something! */ },
        modifier = Modifier.heightIn(size),
        contentPadding = ButtonDefaults.contentPaddingFor(size, hasStartIcon = true),
    ) {
        Icon(
            painter = rememberVectorPainter(AppIcons.EditFilled),
            contentDescription = null,
            modifier = Modifier.size(ButtonDefaults.iconSizeFor(size)),
        )
        Spacer(Modifier.size(ButtonDefaults.iconSpacingFor(size)))
        Text("Label", style = ButtonDefaults.textStyleFor(size))
    }
}

ปุ่มเปิด/ปิด

ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้ปุ่มเปิด/ปิดขนาดกลางที่มีไอคอน

@Composable
fun MediumToggleButtonWithIconSample() {
    var checked by remember { mutableStateOf(false) }
    val size = ButtonDefaults.MediumContainerHeight
    ToggleButton(
        checked = checked,
        onCheckedChange = { checked = it },
        modifier = Modifier.heightIn(size),
        shapes = ToggleButtonDefaults.shapesFor(size),
        contentPadding = ButtonDefaults.contentPaddingFor(size),
    ) {
        Icon(
            painter = rememberVectorPainter(if (checked) AppIcons.EditFilled else AppIcons.Edit),
            contentDescription = null,
            modifier = Modifier.size(ButtonDefaults.iconSizeFor(size)),
        )
        Spacer(Modifier.size(ButtonDefaults.iconSpacingFor(size)))
        Text("Label", style = ButtonDefaults.textStyleFor(size))
    }
}

ใหญ่

ขนาดของปุ่มขนาดใหญ่

  • ความสูง: 96dp

ปุ่มเริ่มต้น

ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้ปุ่มขนาดใหญ่ที่มีไอคอน

@Composable
fun LargeButtonWithIconSample() {
    val size = ButtonDefaults.LargeContainerHeight
    Button(
        onClick = { /* Do something! */ },
        modifier = Modifier.heightIn(size),
        contentPadding = ButtonDefaults.contentPaddingFor(size, hasStartIcon = true),
    ) {
        Icon(
            painter = rememberVectorPainter(AppIcons.EditFilled),
            contentDescription = null,
            modifier = Modifier.size(ButtonDefaults.iconSizeFor(size)),
        )
        Spacer(Modifier.size(ButtonDefaults.iconSpacingFor(size)))
        Text("Label", style = ButtonDefaults.textStyleFor(size))
    }
}

ปุ่มเปิด/ปิด

ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้ปุ่มเปิด/ปิดขนาดใหญ่ที่มีไอคอน

@Composable
fun LargeToggleButtonWithIconSample() {
    var checked by remember { mutableStateOf(false) }
    val size = ButtonDefaults.LargeContainerHeight
    ToggleButton(
        checked = checked,
        onCheckedChange = { checked = it },
        modifier = Modifier.heightIn(size),
        shapes = ToggleButtonDefaults.shapesFor(size),
        contentPadding = ButtonDefaults.contentPaddingFor(size),
    ) {
        Icon(
            painter = rememberVectorPainter(if (checked) AppIcons.EditFilled else AppIcons.Edit),
            contentDescription = null,
            modifier = Modifier.size(ButtonDefaults.iconSizeFor(size)),
        )
        Spacer(Modifier.size(ButtonDefaults.iconSpacingFor(size)))
        Text("Label", style = ButtonDefaults.textStyleFor(size))
    }
}

ใหญ่พิเศษ

ขนาดปุ่มใหญ่พิเศษ:

  • ความสูง: 136dp

ปุ่มเริ่มต้น

ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้ปุ่มขนาดใหญ่พิเศษที่มีไอคอน

@Composable
fun XLargeButtonWithIconSample() {
    val size = ButtonDefaults.ExtraLargeContainerHeight
    Button(
        onClick = { /* Do something! */ },
        modifier = Modifier.heightIn(size),
        contentPadding = ButtonDefaults.contentPaddingFor(size, hasStartIcon = true),
    ) {
        Icon(
            painter = rememberVectorPainter(AppIcons.EditFilled),
            contentDescription = null,
            modifier = Modifier.size(ButtonDefaults.iconSizeFor(size)),
        )
        Spacer(Modifier.size(ButtonDefaults.iconSpacingFor(size)))
        Text("Label", style = ButtonDefaults.textStyleFor(size))
    }
}

ปุ่มเปิด/ปิด

ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้ปุ่มเปิด/ปิดขนาดใหญ่พิเศษที่มีไอคอน

@Composable
fun XLargeToggleButtonWithIconSample() {
    var checked by remember { mutableStateOf(false) }
    val size = ButtonDefaults.ExtraLargeContainerHeight
    ToggleButton(
        checked = checked,
        onCheckedChange = { checked = it },
        modifier = Modifier.heightIn(size),
        shapes = ToggleButtonDefaults.shapesFor(size),
        contentPadding = ButtonDefaults.contentPaddingFor(size),
    ) {
        Icon(
            painter = rememberVectorPainter(if (checked) AppIcons.EditFilled else AppIcons.Edit),
            contentDescription = null,
            modifier = Modifier.size(ButtonDefaults.iconSizeFor(size)),
        )
        Spacer(Modifier.size(ButtonDefaults.iconSpacingFor(size)))
        Text("Label", style = ButtonDefaults.textStyleFor(size))
    }
}

ตัวเลือกรูปร่าง

โดยมีตัวเลือกรูปร่าง 2 แบบ ได้แก่ สี่เหลี่ยมจัตุรัสและวงกลม

ปุ่มสี่เหลี่ยมจัตุรัสเปลี่ยนขนาด
รูปที่ 8 การปรับขนาดรัศมีมุมของปุ่มสี่เหลี่ยมจัตุรัสตามขนาดต่างๆ

ปุ่มสี่เหลี่ยมจัตุรัสมีคอนเทนเนอร์ที่มีมุมโค้งมนเล็กน้อยซึ่งปรับขนาดตามขนาดปุ่ม

ตัวอย่างปุ่มที่มีมุมโค้งมน
รูปที่ 9 ปุ่มที่มีมุมโค้งมน

ปุ่มประเภทกลมจะมีคอนเทนเนอร์ที่มีมุมโค้งมนเต็มรูปแบบ เมื่อเลือกแล้ว รูปร่างของปุ่มเปิด/ปิดสี่เหลี่ยมจัตุรัสจะเปลี่ยนเป็นทรงกลม

ข้อมูลโค้ดต่อไปนี้แสดงวิธีใช้ปุ่มเปิด/ปิดสี่เหลี่ยมจัตุรัสที่เปลี่ยนรูปร่างเป็นวงกลมเมื่อเลือก

@Composable
fun SquareToggleButtonSample() {
    var checked by remember { mutableStateOf(false) }
    val shapes =
        ToggleButtonShapes(
            shape = ToggleButtonDefaults.checkedShape,
            pressedShape = ToggleButtonDefaults.pressedShape,
            checkedShape = ToggleButtonDefaults.shape,
        )
    ToggleButton(checked = checked, onCheckedChange = { checked = it }, shapes = shapes) {
        Text("Button")
    }
}

แหล่งข้อมูลเพิ่มเติม