เครื่องมือเลือกเวลามักปรากฏในกล่องโต้ตอบ คุณสามารถใช้กล่องโต้ตอบแบบทั่วไปและใช้งานแบบน้อยที่สุด หรือจะใช้กล่องโต้ตอบที่กําหนดเองซึ่งมีความยืดหยุ่นมากขึ้นก็ได้
ดูข้อมูลเพิ่มเติมเกี่ยวกับกล่องโต้ตอบทั่วไป รวมถึงวิธีใช้เครื่องมือเลือกเวลาได้ที่คู่มือเครื่องมือเลือกเวลา
ตัวอย่างพื้นฐาน
วิธีที่ตรงที่สุดในการสร้างกล่องโต้ตอบสำหรับเครื่องมือเลือกเวลาคือการสร้างคอมโพสิชันที่ใช้ AlertDialog
ตัวอย่างข้อมูลโค้ดต่อไปนี้แสดงกล่องโต้ตอบแบบกะทัดรัดที่ใช้แนวทางนี้
@Composable fun DialWithDialogExample( onConfirm: (TimePickerState) -> Unit, onDismiss: () -> Unit, ) { val currentTime = Calendar.getInstance() val timePickerState = rememberTimePickerState( initialHour = currentTime.get(Calendar.HOUR_OF_DAY), initialMinute = currentTime.get(Calendar.MINUTE), is24Hour = true, ) TimePickerDialog( onDismiss = { onDismiss() }, onConfirm = { onConfirm(timePickerState) } ) { TimePicker( state = timePickerState, ) } } @Composable fun TimePickerDialog( onDismiss: () -> Unit, onConfirm: () -> Unit, content: @Composable () -> Unit ) { AlertDialog( onDismissRequest = onDismiss, dismissButton = { TextButton(onClick = { onDismiss() }) { Text("Dismiss") } }, confirmButton = { TextButton(onClick = { onConfirm() }) { Text("OK") } }, text = { content() } ) }
โปรดสังเกตประเด็นสำคัญในข้อมูลโค้ดนี้
- คอมโพสิเบิล
DialWithDialogExample
จะรวมTimePicker
ในกล่องโต้ตอบ TimePickerDialog
คือคอมโพสิชันที่กําหนดเองซึ่งสร้างAlertDialog
ด้วยพารามิเตอร์ต่อไปนี้onDismiss
: ฟังก์ชันที่เรียกใช้เมื่อผู้ใช้ปิดกล่องโต้ตอบ (ผ่านปุ่มปิดหรือการนำทางกลับ)onConfirm
: ฟังก์ชันที่เรียกใช้เมื่อผู้ใช้คลิกปุ่ม "ตกลง"content
: คอมโพสิชันที่แสดงเครื่องมือเลือกเวลาภายในกล่องโต้ตอบ
AlertDialog
ประกอบด้วยรายการต่อไปนี้- ปุ่มปิดที่มีป้ายกำกับ "ปิด"
- ปุ่มยืนยันที่มีป้ายกำกับว่า "ตกลง"
- เนื้อหาเครื่องมือเลือกเวลาซึ่งส่งผ่านเป็นพารามิเตอร์
text
DialWithDialogExample
จะเริ่มต้นTimePickerState
ด้วยเวลาปัจจุบันและส่งไปยังทั้งฟังก์ชันTimePicker
และonConfirm
ตัวอย่างขั้นสูง
ข้อมูลโค้ดนี้แสดงการใช้งานขั้นสูงของกล่องโต้ตอบเครื่องมือเลือกเวลาที่ปรับแต่งได้ใน Jetpack Compose
@Composable fun AdvancedTimePickerExample( onConfirm: (TimePickerState) -> Unit, onDismiss: () -> Unit, ) { val currentTime = Calendar.getInstance() val timePickerState = rememberTimePickerState( initialHour = currentTime.get(Calendar.HOUR_OF_DAY), initialMinute = currentTime.get(Calendar.MINUTE), is24Hour = true, ) /** Determines whether the time picker is dial or input */ var showDial by remember { mutableStateOf(true) } /** The icon used for the icon button that switches from dial to input */ val toggleIcon = if (showDial) { Icons.Filled.EditCalendar } else { Icons.Filled.AccessTime } AdvancedTimePickerDialog( onDismiss = { onDismiss() }, onConfirm = { onConfirm(timePickerState) }, toggle = { IconButton(onClick = { showDial = !showDial }) { Icon( imageVector = toggleIcon, contentDescription = "Time picker type toggle", ) } }, ) { if (showDial) { TimePicker( state = timePickerState, ) } else { TimeInput( state = timePickerState, ) } } } @Composable fun AdvancedTimePickerDialog( title: String = "Select Time", onDismiss: () -> Unit, onConfirm: () -> Unit, toggle: @Composable () -> Unit = {}, content: @Composable () -> Unit, ) { Dialog( onDismissRequest = onDismiss, properties = DialogProperties(usePlatformDefaultWidth = false), ) { Surface( shape = MaterialTheme.shapes.extraLarge, tonalElevation = 6.dp, modifier = Modifier .width(IntrinsicSize.Min) .height(IntrinsicSize.Min) .background( shape = MaterialTheme.shapes.extraLarge, color = MaterialTheme.colorScheme.surface ), ) { Column( modifier = Modifier.padding(24.dp), horizontalAlignment = Alignment.CenterHorizontally ) { Text( modifier = Modifier .fillMaxWidth() .padding(bottom = 20.dp), text = title, style = MaterialTheme.typography.labelMedium ) content() Row( modifier = Modifier .height(40.dp) .fillMaxWidth() ) { toggle() Spacer(modifier = Modifier.weight(1f)) TextButton(onClick = onDismiss) { Text("Cancel") } TextButton(onClick = onConfirm) { Text("OK") } } } } } }
โปรดสังเกตประเด็นสำคัญในข้อมูลโค้ดนี้
AdvancedTimePickerExample
Composable จะสร้างกล่องโต้ตอบเครื่องมือเลือกเวลาที่ปรับแต่งได้- ใช้
Dialog
Composable เพื่อความยืดหยุ่นที่มากกว่าAlertDialog
- กล่องโต้ตอบนี้มีชื่อที่ปรับแต่งได้และปุ่มเปิด/ปิดสำหรับสลับระหว่างโหมดแป้นหมุนและโหมดป้อนข้อมูล
Surface
ใช้รูปร่างและระดับความสูงกับกล่องโต้ตอบ โดยมีIntrinsicSize.Min
สำหรับทั้งความกว้างและความสูง- เลย์เอาต์
Column
และRow
มีคอมโพเนนต์โครงสร้างของกล่องโต้ตอบ - ตัวอย่างนี้ติดตามโหมดเครื่องมือเลือกโดยใช้
showDial
IconButton
จะสลับระหว่างโหมดต่างๆ โดยอัปเดตไอคอนให้สอดคล้องกัน- เนื้อหาในกล่องโต้ตอบจะเปลี่ยนไปมาระหว่าง
TimePicker
และTimeInput
ตามสถานะshowDial
การใช้งานขั้นสูงนี้มอบกล่องโต้ตอบเครื่องมือเลือกเวลาที่ปรับแต่งได้และนำมาใช้ใหม่ได้ ซึ่งปรับให้เข้ากับกรณีการใช้งานต่างๆ ในแอปของคุณ
การติดตั้งใช้งานนี้จะปรากฏดังนี้