메뉴

드롭다운 메뉴를 사용하면 사용자가 아이콘, 텍스트 필드 또는 기타 구성요소를 클릭한 다음 임시 표시 경로의 옵션 목록에서 선택할 수 있습니다. 이 가이드에서는 기본 메뉴와 구분선 및 아이콘이 있는 더 복잡한 메뉴를 만드는 방법을 설명합니다.

두 가지 옵션이 있는 드롭다운 메뉴가 표시됩니다. 세로로 된 점 3개 아이콘을 클릭하면 메뉴가 열립니다.
그림 1. 두 항목이 나열된 기본 드롭다운 메뉴

API 노출 영역

DropdownMenu, DropdownMenuItem, IconButton 구성요소를 사용하여 맞춤 드롭다운 메뉴를 구현합니다. DropdownMenu 및 DropdownMenuItem 구성요소는 메뉴 항목을 표시하는 데 사용되며 IconButton는 드롭다운 메뉴를 표시하거나 숨기는 트리거입니다.

DropdownMenu 구성요소의 주요 매개변수는 다음과 같습니다.

  • expanded: 메뉴가 표시되는지 여부를 나타냅니다.
  • onDismissRequest: 메뉴 닫기를 처리하는 데 사용됩니다.
  • content: 메뉴의 컴포저블 콘텐츠로, 일반적으로 DropdownMenuItem 컴포저블을 포함합니다.

DropdownMenuItem의 주요 매개변수는 다음과 같습니다.

  • text: 메뉴 항목에 표시되는 콘텐츠를 정의합니다.
  • onClick: 메뉴의 항목과의 상호작용을 처리하는 콜백입니다.

기본 드롭다운 메뉴 만들기

다음 스니펫은 최소한의 DropdownMenu 구현을 보여줍니다.

@Composable
fun MinimalDropdownMenu() {
    var expanded by remember { mutableStateOf(false) }
    Box(
        modifier = Modifier
            .padding(16.dp)
    ) {
        IconButton(onClick = { expanded = !expanded }) {
            Icon(Icons.Default.MoreVert, contentDescription = "More options")
        }
        DropdownMenu(
            expanded = expanded,
            onDismissRequest = { expanded = false }
        ) {
            DropdownMenuItem(
                text = { Text("Option 1") },
                onClick = { /* Do something... */ }
            )
            DropdownMenuItem(
                text = { Text("Option 2") },
                onClick = { /* Do something... */ }
            )
        }
    }
}

코드에 관한 핵심 사항

  • 메뉴 항목 두 개가 포함된 기본 DropdownMenu를 정의합니다.
  • expanded 매개변수는 메뉴의 공개 상태를 펼치거나 접은 상태로 제어합니다.
  • onDismissRequest 매개변수는 사용자가 메뉴를 닫을 때 실행되는 콜백을 정의합니다.
  • DropdownMenuItem 컴포저블은 드롭다운 메뉴에서 선택 가능한 항목을 나타냅니다.
  • IconButton는 메뉴의 펼치기 및 접기를 트리거합니다.

결과

세로로 된 점 3개 아이콘으로 트리거되는 드롭다운 메뉴입니다. 메뉴에는 선택 가능한 두 가지 옵션인 옵션 1과 옵션 2가 표시됩니다.
그림 2. 옵션이 두 개뿐인 최소한의 드롭다운 메뉴

더 긴 드롭다운 메뉴 만들기

DropdownMenu는 모든 메뉴 항목을 한 번에 표시할 수 없는 경우 기본적으로 스크롤할 수 있습니다. 다음 스니펫은 스크롤 가능한 더 긴 드롭다운 메뉴를 만듭니다.

@Composable
fun LongBasicDropdownMenu() {
    var expanded by remember { mutableStateOf(false) }
    // Placeholder list of 100 strings for demonstration
    val menuItemData = List(100) { "Option ${it + 1}" }

    Box(
        modifier = Modifier
            .padding(16.dp)
    ) {
        IconButton(onClick = { expanded = !expanded }) {
            Icon(Icons.Default.MoreVert, contentDescription = "More options")
        }
        DropdownMenu(
            expanded = expanded,
            onDismissRequest = { expanded = false }
        ) {
            menuItemData.forEach { option ->
                DropdownMenuItem(
                    text = { Text(option) },
                    onClick = { /* Do something... */ }
                )
            }
        }
    }
}

코드에 관한 핵심 사항

  • DropdownMenu는 콘텐츠의 총 높이가 사용 가능한 공간을 초과할 때 스크롤할 수 있습니다. 이 코드는 100개의 자리표시자 항목을 표시하는 스크롤 가능한 DropdownMenu를 만듭니다.
  • forEach 루프는 DropdownMenuItem 컴포저블을 동적으로 생성합니다. 항목은 지연 생성되지 않습니다. 즉, 100개의 드롭다운 항목이 모두 생성되어 컴포지션에 존재합니다.
  • IconButton는 클릭 시 DropdownMenu의 펼치기 및 접기를 트리거합니다.
  • 각 DropdownMenuItem 내의 onClick 람다를 사용하면 사용자가 메뉴 항목을 선택할 때 실행되는 작업을 정의할 수 있습니다.

결과

위의 코드 스니펫은 다음과 같은 스크롤 가능한 메뉴를 생성합니다.

모든 항목을 보려면 스크롤해야 하는 여러 옵션이 있는 드롭다운 메뉴
그림 3. 스크롤 가능한 긴 드롭다운 메뉴

구분선이 있는 긴 드롭다운 메뉴 만들기

다음 스니펫은 드롭다운 메뉴의 고급 구현을 보여줍니다. 이 스니펫에서는 선행 및 후행 아이콘이 메뉴 항목에 추가되고 구분선이 메뉴 항목 그룹을 구분합니다.

@Composable
fun DropdownMenuWithDetails() {
    var expanded by remember { mutableStateOf(false) }

    Box(
        modifier = Modifier
            .fillMaxWidth()
            .padding(16.dp)
    ) {
        IconButton(onClick = { expanded = !expanded }) {
            Icon(Icons.Default.MoreVert, contentDescription = "More options")
        }
        DropdownMenu(
            expanded = expanded,
            onDismissRequest = { expanded = false }
        ) {
            // First section
            DropdownMenuItem(
                text = { Text("Profile") },
                leadingIcon = { Icon(Icons.Outlined.Person, contentDescription = null) },
                onClick = { /* Do something... */ }
            )
            DropdownMenuItem(
                text = { Text("Settings") },
                leadingIcon = { Icon(Icons.Outlined.Settings, contentDescription = null) },
                onClick = { /* Do something... */ }
            )

            HorizontalDivider()

            // Second section
            DropdownMenuItem(
                text = { Text("Send Feedback") },
                leadingIcon = { Icon(Icons.Outlined.Feedback, contentDescription = null) },
                trailingIcon = { Icon(Icons.AutoMirrored.Outlined.Send, contentDescription = null) },
                onClick = { /* Do something... */ }
            )

            HorizontalDivider()

            // Third section
            DropdownMenuItem(
                text = { Text("About") },
                leadingIcon = { Icon(Icons.Outlined.Info, contentDescription = null) },
                onClick = { /* Do something... */ }
            )
            DropdownMenuItem(
                text = { Text("Help") },
                leadingIcon = { Icon(Icons.AutoMirrored.Outlined.Help, contentDescription = null) },
                trailingIcon = { Icon(Icons.AutoMirrored.Outlined.OpenInNew, contentDescription = null) },
                onClick = { /* Do something... */ }
            )
        }
    }
}

이 코드는 Box 내에 DropdownMenu를 정의합니다.

코드에 관한 핵심 사항

  • leadingIcon 및 trailingIcon 매개변수는 DropdownMenuItem의 시작과 끝에 아이콘을 추가합니다.
  • IconButton는 메뉴 펼치기를 트리거합니다.
  • DropdownMenu에는 여러 DropdownMenuItem 컴포저블이 포함되어 있으며, 각 컴포저블은 선택 가능한 작업을 나타냅니다.
  • HorizontalDivider 컴포저블은 가로선을 삽입하여 메뉴 항목 그룹을 구분합니다.

결과

위 스니펫은 아이콘과 구분선이 있는 드롭다운 메뉴를 생성합니다.

프로필, 설정, 의견 보내기, 정보, 도움말 섹션이 있는 드롭다운 메뉴 각 옵션에는 프로필의 사람 아이콘과 같은 아이콘이 있습니다.
그림 4. 선행 및 후행 아이콘이 있는 섹션으로 나뉜 드롭다운 메뉴

추가 리소스