ปุ่มไอคอน

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

ปุ่มไอคอนมี 2 ประเภท ได้แก่

  • ค่าเริ่มต้น: ปุ่มเหล่านี้สามารถเปิดองค์ประกอบอื่นๆ ได้ เช่น เมนูหรือการค้นหา
  • ปุ่มเปิด/ปิด: ปุ่มเหล่านี้แสดงถึงการดำเนินการแบบไบนารีที่เปิดหรือปิดได้ เช่น "รายการโปรด" หรือ "บุ๊กมาร์ก"
ปุ่มไอคอน 5 ปุ่มที่มีไอคอนต่างๆ เช่น การตั้งค่า และอื่นๆ บางรายการเป็นแบบทึบซึ่งแสดงถึงการเลือก และบางรายการเป็นแบบเส้นขอบ
รูปที่ 1 ปุ่มไอคอน บางปุ่มเป็นสีทึบ (แสดงว่าเลือกอยู่) และบางปุ่มเป็นแบบเส้นขอบ

แพลตฟอร์ม API

ใช้ Composable IconButton เพื่อใช้ปุ่มไอคอนมาตรฐาน และ IconToggleButton สำหรับปุ่มที่สลับระหว่างสถานะที่เลือกและไม่ได้เลือก หากต้องการสร้างรูปแบบภาพที่แตกต่างกัน เช่น แบบทึบ แบบทึบโทนสี หรือแบบเส้นขอบ ให้ใช้ FilledIconButton, FilledTonalIconButton และ OutlinedIconButton หรือไอคอนที่สลับได้ FilledIconToggleButton, FilledTonalIconToggleButton และ OutlinedIconToggleButton

พารามิเตอร์หลักสำหรับ IconButton ได้แก่

  • onClick: ฟังก์ชัน Lambda ที่จะทำงานเมื่อผู้ใช้แตะปุ่มไอคอน
  • enabled: บูลีนที่ควบคุมสถานะการเปิดใช้ของปุ่ม เมื่อfalse ปุ่มจะไม่ตอบสนองต่อการป้อนข้อมูลของผู้ใช้
  • content: เนื้อหาที่ประกอบกันได้ภายในปุ่ม ซึ่งโดยปกติจะเป็น Icon

พารามิเตอร์หลักสำหรับ IconToggleButton ได้แก่

  • checked: บูลีนที่ควบคุมสถานะที่เลือกของปุ่ม
  • onCheckedChange: ฟังก์ชัน Lambda ที่จะทำงานเมื่อผู้ใช้แตะปุ่ม โดยจะแสดงสถานะการเลือกใหม่
  • enabled: บูลีนที่ควบคุมสถานะการเปิดใช้ของปุ่ม เมื่อfalse ปุ่มจะไม่ตอบสนองต่อการป้อนข้อมูลของผู้ใช้

ตัวอย่างพื้นฐาน: ปุ่มไอคอนเปิด/ปิด

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

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

@Preview
@Composable
fun ToggleIconButtonExample() {
    // isToggled initial value should be read from a view model or persistent storage.
    var isToggled by rememberSaveable { mutableStateOf(false) }

    IconButton(
        onClick = { isToggled = !isToggled }
    ) {
        Icon(
            painter = if (isToggled) painterResource(R.drawable.favorite_filled) else painterResource(R.drawable.favorite),
            contentDescription = if (isToggled) "Selected icon button" else "Unselected icon button."
        )
    }
}

ประเด็นสำคัญเกี่ยวกับโค้ด

  • คอมโพสิเบิล ToggleIconButtonExample จะกำหนด IconButton ที่เปิด/ปิดได้
    • mutableStateOf(false) จะสร้างออบเจ็กต์ MutableState ที่เก็บค่าบูลีน ซึ่งมีค่าเริ่มต้นเป็น false ซึ่งทำให้ isToggled เป็นตัวเก็บสถานะ ซึ่งหมายความว่า Compose จะสร้าง UI ใหม่ทุกครั้งที่ค่ามีการเปลี่ยนแปลง
    • rememberSaveable ช่วยให้มั่นใจว่าสถานะ isToggled จะยังคงอยู่แม้จะมีการเปลี่ยนแปลงการกำหนดค่า เช่น การหมุนหน้าจอ
  • onClick lambda ของ IconButton จะกำหนดลักษณะการทำงานของปุ่มเมื่อคลิก โดยสลับสถานะระหว่าง true และ false
  • พารามิเตอร์ painter ของ Composable Icon จะโหลด painterResource ที่แตกต่างกันตามเงื่อนไขโดยอิงตามสถานะ isToggled ซึ่งจะเปลี่ยนลักษณะที่ปรากฏของไอคอน
    • หาก isToggled เป็น true ระบบจะโหลดรูปหัวใจที่เติมสีได้
    • หาก isToggled เป็น false ระบบจะโหลดรูปหัวใจแบบมีเส้นขอบที่วาดได้
  • contentDescriptionของIconจะอัปเดตตามสถานะisToggledด้วยเพื่อให้ข้อมูลการช่วยเหลือพิเศษที่เหมาะสม

ผลลัพธ์

รูปภาพต่อไปนี้แสดงปุ่มไอคอนเปิด/ปิดจากข้อมูลโค้ดก่อนหน้าในสถานะที่เลือก

รูปที่ 2 ปุ่มไอคอนเปิด/ปิด "รายการโปรด" ในสถานะที่เลือก

ตัวอย่างขั้นสูง: การดำเนินการซ้ำเมื่อกด

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

@Composable
fun MomentaryIconButton(
    unselectedImage: Int,
    selectedImage: Int,
    contentDescription: String,
    modifier: Modifier = Modifier,
    stepDelay: Long = 100L, // Minimum value is 1L milliseconds.
    onClick: () -> Unit
) {
    val interactionSource = remember { MutableInteractionSource() }
    val isPressed by interactionSource.collectIsPressedAsState()
    val pressedListener by rememberUpdatedState(onClick)

    LaunchedEffect(isPressed) {
        while (isPressed) {
            delay(stepDelay.coerceIn(1L, Long.MAX_VALUE))
            pressedListener()
        }
    }

    IconButton(
        modifier = modifier,
        onClick = onClick,
        interactionSource = interactionSource
    ) {
        Icon(
            painter = if (isPressed) painterResource(id = selectedImage) else painterResource(id = unselectedImage),
            contentDescription = contentDescription,
        )
    }
}

ประเด็นสำคัญเกี่ยวกับโค้ด

  • MomentaryIconButton จะใช้ unselectedImage: Int ซึ่งเป็นรหัสทรัพยากรที่ถอนออกได้สำหรับไอคอนเมื่อไม่ได้กดปุ่ม และ selectedImage: Int ซึ่งเป็นรหัสทรัพยากรที่ถอนออกได้สำหรับไอคอนเมื่อกดปุ่ม
  • โดยใช้ interactionSource เพื่อติดตามการโต้ตอบ "กด" จากผู้ใช้โดยเฉพาะ
  • isPressed จะเป็นจริงเมื่อมีการกดปุ่มอยู่ และเป็นเท็จในกรณีอื่นๆ เมื่อ isPressed เป็น true LaunchedEffect จะเข้าสู่ลูป
    • ภายในลูปนี้ ระบบจะใช้ delay (พร้อม stepDelay) เพื่อสร้างการหยุดชั่วคราวระหว่างการทริกเกอร์การดำเนินการ coerceIn ตรวจสอบว่าความล่าช้ามีค่าอย่างน้อย 1 มิลลิวินาทีเพื่อป้องกันการวนซ้ำไม่สิ้นสุด
    • ระบบจะเรียกใช้ pressedListener หลังจากแต่ละช่วงเวลาหน่วงภายในลูป ซึ่งจะทำให้การดำเนินการทำงานซ้ำ
  • pressedListener ใช้ rememberUpdatedState เพื่อให้มั่นใจว่า onClick lambda (การดำเนินการที่จะทำ) เป็นเวอร์ชันล่าสุดเสมอจากองค์ประกอบล่าสุด
  • Icon จะเปลี่ยนรูปภาพที่แสดงตามสถานะของปุ่มว่ามีการกดอยู่หรือไม่
    • หาก isPressed เป็นจริง ระบบจะแสดง selectedImage
    • มิเช่นนั้น ระบบจะแสดง unselectedImage

ถัดไป ให้ใช้ MomentaryIconButton นี้ในตัวอย่าง ข้อมูลโค้ดต่อไปนี้แสดงปุ่มไอคอน 2 ปุ่มที่ควบคุมตัวนับ

@Preview()
@Composable
fun MomentaryIconButtonExample() {
    var pressedCount by remember { mutableIntStateOf(0) }

    Row(
        modifier = Modifier.fillMaxWidth(),
        verticalAlignment = Alignment.CenterVertically
    ) {
        MomentaryIconButton(
            unselectedImage = R.drawable.fast_rewind,
            selectedImage = R.drawable.fast_rewind_filled,
            stepDelay = 100L,
            onClick = { pressedCount -= 1 },
            contentDescription = "Decrease count button"
        )
        Spacer(modifier = Modifier)
        Text("advanced by $pressedCount frames")
        Spacer(modifier = Modifier)
        MomentaryIconButton(
            unselectedImage = R.drawable.fast_forward,
            selectedImage = R.drawable.fast_forward_filled,
            contentDescription = "Increase count button",
            stepDelay = 100L,
            onClick = { pressedCount += 1 }
        )
    }
}

ประเด็นสำคัญเกี่ยวกับโค้ด

  • MomentaryIconButtonExample Composable จะแสดง Row ที่มีอินสแตนซ์ MomentaryIconButton 2 รายการและ Text Composable เพื่อสร้าง UI สำหรับเพิ่มและลดตัวนับ
  • โดยจะเก็บตัวแปรสถานะ pressedCount ที่เปลี่ยนแปลงได้โดยใช้ remember และ mutableIntStateOf ซึ่งเริ่มต้นเป็น 0 เมื่อ pressedCount เปลี่ยนแปลง คอมโพสิเบิลที่สังเกตการณ์อยู่ (เช่น คอมโพสิเบิล Text) จะจัดองค์ประกอบใหม่เพื่อให้สอดคล้องกับค่าใหม่
  • MomentaryIconButton แรกจะลด pressedCount เมื่อคลิกหรือกดค้างไว้
  • MomentaryIconButton ตัวที่ 2 จะเพิ่ม pressedCount เมื่อคลิกหรือกดค้างไว้
  • ปุ่มทั้ง 2 ปุ่มใช้ stepDelay 100 มิลลิวินาที ซึ่งหมายความว่าการดำเนินการ onClick จะทำซ้ำทุกๆ 100 มิลลิวินาทีขณะที่กดปุ่มค้างไว้

ผลลัพธ์

วิดีโอต่อไปนี้แสดง UI ที่มีปุ่มไอคอนและตัวนับ

รูปที่ 3 UI ตัวนับที่มีปุ่มไอคอน 2 ปุ่ม (บวกและลบ) ซึ่งจะเพิ่มและลดตัวนับ

การอัปเดต M3 Expressive

การอัปเดต M3 Expressive ช่วยให้ปุ่มไอคอนรองรับตัวเลือกขนาด มุม และความกว้างเพิ่มเติม รวมถึงเปลี่ยนรูปร่างได้เมื่อกดหรือเลือก เมื่อวางไว้ในกลุ่มปุ่มมาตรฐาน ปุ่มไอคอนจะโต้ตอบกับปุ่มข้างเคียงเมื่อกดด้วย

รูปร่างแบบเคลื่อนไหว

ปุ่มไอคอนสามารถเคลื่อนไหวรูปร่างเมื่อกด และปุ่มไอคอนสลับสามารถเคลื่อนไหวรูปร่างตามสถานะที่เลือกได้ หากต้องการเปิดใช้ภาพเคลื่อนไหวของรูปร่าง ให้ส่ง IconButtonDefaults.shapes() หรือ IconButtonDefaults.toggleableShapes() ไปยังพารามิเตอร์ shapes ของ IconButton หรือ IconToggleButton

ปุ่มไอคอน

สถานะของปุ่มไอคอน
รูปที่ 4 ภาพเคลื่อนไหวของรูปร่างปุ่มไอคอนในรูปทรงกลมและสี่เหลี่ยมจัตุรัส

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

@Composable
fun IconButtonWithAnimatedShapeSample() {
    IconButton(
        onClick = { /* doSomething() */ },
        shapes = IconButtonDefaults.shapes(),
    ) {
        Icon(painter = rememberVectorPainter(AppIcons.LockFilled), contentDescription = "Localized description")
    }
}

ปุ่มไอคอนเปิด/ปิด

สถานะของปุ่มไอคอนเปิด/ปิด
รูปที่ 5 ภาพเคลื่อนไหวของรูปร่างปุ่มไอคอนเปิด/ปิดในสถานะที่ไม่ได้เลือกและเลือกไว้

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

@Composable
fun IconToggleButtonWithAnimatedShapeSample() {
    var checked by remember { mutableStateOf(false) }
    IconToggleButton(
        checked = checked,
        onCheckedChange = { checked = it },
        shapes = IconButtonDefaults.toggleableShapes(),
    ) {
        if (checked) {
            Icon(painter = rememberVectorPainter(AppIcons.LockFilled), contentDescription = "Localized description")
        } else {
            Icon(painter = rememberVectorPainter(AppIcons.Lock), contentDescription = "Localized description")
        }
    }
}

ตัวแปรขนาด ความกว้าง และรูปร่าง

ปุ่มไอคอนมีให้เลือกในรูปทรงกลมและสี่เหลี่ยมจัตุรัส 5 ขนาด และ 3 ความกว้าง

ตัวอย่างขนาด รูปร่าง และความกว้างของปุ่มไอคอน
รูปที่ 6 ฟีเจอร์ที่สื่ออารมณ์ประกอบด้วย 5 ขนาด 2 รูปทรง และ 3 ความกว้าง

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

ปุ่มไอคอนมี 5 ขนาด ได้แก่ เล็กพิเศษ เล็ก กลาง ใหญ่ และใหญ่พิเศษ แต่ละขนาดรองรับตัวเลือกความกว้าง 3 แบบ ได้แก่ สม่ำเสมอ (ค่าเริ่มต้น) แคบ และกว้าง

ปุ่มไอคอน 5 แถวและ 3 คอลัมน์ที่แสดงไอคอนหัวใจ แต่ละแถวจะมีขนาดเพิ่มขึ้น และคอลัมน์ทั้ง 3 คอลัมน์จะมีความกว้างแตกต่างกัน ได้แก่ เท่ากัน แคบ และกว้าง
รูปที่ 7 ปุ่มไอคอนที่แสดงตัวเลือกขนาด 5 แบบและตัวเลือกความกว้าง 3 แบบ ได้แก่ สม่ำเสมอ แคบ และกว้าง

ปุ่มไอคอนมีให้เลือกทั้งแบบมุมมนหรือมุมเหลี่ยม และปุ่มไอคอนเปิด/ปิดจะเปลี่ยนรูปร่างเมื่อกดหรือเลือก

ปุ่มไอคอน 5 ปุ่ม 2 แถวที่มีไอคอนรูปหัวใจ โดยมีขนาดเพิ่มขึ้นจากซ้ายไปขวา แถวบนมีมุมโค้งมนและแถวล่างมีมุมเหลี่ยม
รูปที่ 8 ปุ่มไอคอนมีให้เลือกทั้งแบบมุมมนหรือมุมเหลี่ยม

ดูคำแนะนำในการเลือกระหว่างตัวแปรมุมได้ที่หลักเกณฑ์เกี่ยวกับปุ่มไอคอนของ Material Design 3

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