WindowIconCascadingDropdownMenu

WindowIconCascadingDropdownMenu 是基于 IconButton 的封装，点击图标按钮后会展开 WindowCascadingListPopup（通过 Dialog 在窗口级别渲染）。与 OverlayIconCascadingDropdownMenu 不同，它不需要 Scaffold。DropdownItem.children 非空的项会成为子菜单触发行；级联深度限制为 2 级。

引入

kotlin

import top.yukonga.miuix.kmp.menu.WindowIconCascadingDropdownMenu
import top.yukonga.miuix.kmp.basic.DropdownEntry
import top.yukonga.miuix.kmp.basic.DropdownItem

基本用法

将 WindowIconCascadingDropdownMenu 放在 TopAppBar（或 SmallTopAppBar）的 actions 槽中，点击图标即可展开弹出框。children 非空的顶层项会带 chevron，点击后就地展开二级菜单。菜单本身不依赖 Scaffold，但通常仍然以 Scaffold 来承载 TopAppBar。

kotlin

var sortIndex by remember { mutableStateOf(0) }
var viewIndex by remember { mutableStateOf(0) }
var filterIndex by remember { mutableStateOf(0) }

val sortLabels = listOf("按拍摄日期排序", "按添加日期排序")
val viewLabels = listOf("按日期分组", "紧凑视图")
val filterLabels = listOf("全部内容", "相机相册")

val entries = listOf(
    DropdownEntry(
        items = sortLabels.mapIndexed { idx, label ->
            DropdownItem(
                text = label,
                selected = sortIndex == idx,
                onClick = { sortIndex = idx },
            )
        },
    ),
    DropdownEntry(
        items = listOf(
            DropdownItem(
                text = "查看模式",
                children = viewLabels.mapIndexed { idx, label ->
                    DropdownItem(
                        text = label,
                        selected = viewIndex == idx,
                        onClick = { viewIndex = idx },
                    )
                },
            ),
            DropdownItem(
                text = "筛选",
                children = filterLabels.mapIndexed { idx, label ->
                    DropdownItem(
                        text = label,
                        selected = filterIndex == idx,
                        onClick = { filterIndex = idx },
                    )
                },
            ),
        ),
    ),
)

Scaffold(
    topBar = {
        SmallTopAppBar(
            title = "图库",
            actions = {
                WindowIconCascadingDropdownMenu(entries = entries) {
                    Icon(imageVector = MiuixIcons.Tune, contentDescription = "调整")
                }
            }
        )
    }
) { padding ->
    // 页面内容
}

单 Entry 重载

只需要一个分组时，可以使用 entry 重载省略外层的 listOf(...)。

kotlin

val entry = DropdownEntry(
    items = listOf(
        DropdownItem(
            text = "查看模式",
            children = listOf(
                DropdownItem(text = "按日期分组", onClick = { /* ... */ }),
                DropdownItem(text = "紧凑视图", onClick = { /* ... */ }),
            ),
        ),
        DropdownItem(text = "刷新", onClick = { /* ... */ }),
    ),
)

WindowIconCascadingDropdownMenu(entry = entry) {
    Icon(imageVector = MiuixIcons.Tune, contentDescription = "调整")
}

组件状态

禁用状态

kotlin

WindowIconCascadingDropdownMenu(
    entry = DropdownEntry(items = listOf(DropdownItem(text = "选项 1"))),
    enabled = false,
) {
    Icon(imageVector = MiuixIcons.MoreCircle, contentDescription = "更多")
}

当所有 DropdownEntry 都不包含任何条目时，菜单也会被隐式禁用。

级联深度

级联深度上限为 2。二级菜单中的项不会再处理自己的 children；更深层的子树会被静默忽略。

属性