스낵바(snackbar)

스낵바 구성요소는 화면 하단에 표시되는 간단한 알림 역할을 합니다. 사용자 환경을 중단하지 않고 작업이나 작업에 관한 피드백을 제공합니다. 스낵바는 몇 초 후 사라집니다. 사용자는 버튼을 탭하는 등의 작업으로 닫을 수도 있습니다.

스낵바를 사용할 수 있는 세 가지 사용 사례를 살펴보겠습니다.

  • 작업 확인: 사용자가 이메일 또는 메시지를 삭제하면 작업을 확인하고 '실행취소' 옵션을 제공하는 스낵바가 표시됩니다.
  • 네트워크 상태: 앱의 인터넷 연결이 끊어지면 스낵바가 표시되어 현재 오프라인 상태임을 나타냅니다.
  • 데이터 제출: 양식을 제출하거나 설정을 업데이트하면 변경사항이 저장되었다는 알림이 스낵바에 표시됩니다.

기본 예

스낵바를 구현하려면 먼저 SnackbarHostState 속성이 포함된 SnackbarHost를 만듭니다. SnackbarHostState를 통해 스낵바를 표시하는 데 사용할 수 있는 showSnackbar() 함수에 액세스할 수 있습니다.

이 정지 함수는 CoroutineScope가 필요하고(예: rememberCoroutineScope 사용) UI 이벤트에 대한 응답으로 호출되어 Scaffold 내의 Snackbar를 표시할 수 있습니다.

val scope = rememberCoroutineScope()
val snackbarHostState = remember { SnackbarHostState() }
Scaffold(
    snackbarHost = {
        SnackbarHost(hostState = snackbarHostState)
    },
    floatingActionButton = {
        ExtendedFloatingActionButton(
            text = { Text("Show snackbar") },
            icon = { Icon(Icons.Filled.Image, contentDescription = "") },
            onClick = {
                scope.launch {
                    snackbarHostState.showSnackbar("Snackbar")
                }
            }
        )
    }
) { contentPadding ->
    // Screen content
}
MaterialLayoutSnippets.kt

작업이 포함된 스낵바

선택적 작업을 제공하고 Snackbar의 지속 시간을 조정할 수 있습니다. snackbarHostState.showSnackbar() 함수는 추가 actionLabel 및 duration 매개변수를 허용하고 SnackbarResult를 반환합니다.

val scope = rememberCoroutineScope()
val snackbarHostState = remember { SnackbarHostState() }
Scaffold(
    snackbarHost = {
        SnackbarHost(hostState = snackbarHostState)
    },
    floatingActionButton = {
        ExtendedFloatingActionButton(
            text = { Text("Show snackbar") },
            icon = { Icon(Icons.Filled.Image, contentDescription = "") },
            onClick = {
                scope.launch {
                    val result = snackbarHostState
                        .showSnackbar(
                            message = "Snackbar",
                            actionLabel = "Action",
                            // Defaults to SnackbarDuration.Short
                            duration = SnackbarDuration.Indefinite
                        )
                    when (result) {
                        SnackbarResult.ActionPerformed -> {
                            /* Handle snackbar action performed */
                        }
                        SnackbarResult.Dismissed -> {
                            /* Handle snackbar dismissed */
                        }
                    }
                }
            }
        )
    }
) { contentPadding ->
    // Screen content
}
MaterialLayoutSnippets.kt

snackbarHost 매개변수를 사용하여 맞춤 Snackbar를 제공할 수 있습니다. 자세한 내용은 SnackbarHost API 참조 문서를 참고하세요.