DialogButtonBar

DialogButtonBar 是 COUI 警告对话框的按钮栏，对标 ColorOS 的 COUIButtonBarLayout。它最核心的行为是自动纵排：按钮栏会测量自己的文案，一旦某个文案宽到放不进单元格，整栏就从横排翻成纵排，而不是把文字挤压或截断。

横排与纵排不只是方向不同——两档的最小高度、内边距、分割线粗细与内缩都不一样，而且按钮顺序完全相反。

导入

kotlin

import io.github.suqi8.coui.kmp.layout.DialogButtonBar
import io.github.suqi8.coui.kmp.layout.DialogButtonBarAction
import io.github.suqi8.coui.kmp.layout.DialogButtonBarDefaults

基础用法

按角色而非位置传入动作——由按钮栏决定每个动作摆在哪：

kotlin

OverlayDialog(
    show = showDialog,
    title = "Dialog Title",
    summary = "A dialog with a COUI button bar.",
    onDismissRequest = { showDialog = false },
) {
    DialogButtonBar(
        negative = DialogButtonBarAction(text = "Cancel", onClick = { showDialog = false }),
        positive = DialogButtonBarAction(text = "Confirm", onClick = { showDialog = false }),
    )
}

两个短文案会并排显示。长文案会自动把整栏翻成纵排，无需任何额外配置：

kotlin

DialogButtonBar(
    negative = DialogButtonBarAction(text = "Not Now", onClick = { showDialog = false }),
    positive = DialogButtonBarAction(
        text = "Delete Backup And Local Copies",
        onClick = { showDialog = false },
    ),
)

也支持第三个中性动作。COUI 对三按钮栏一律纵排，无论文案多短：

kotlin

DialogButtonBar(
    negative = DialogButtonBarAction(text = "Cancel", onClick = { showDialog = false }),
    positive = DialogButtonBarAction(text = "Save", onClick = { showDialog = false }),
    neutral = DialogButtonBarAction(text = "Discard", onClick = { showDialog = false }),
)

纵排判定规则

按钮栏严格复刻 COUIButtonBarLayout.onMeasure。只有同时满足以下三条才保持横排：

所有文案都放得下，且
恰好有两个按钮，且
没有推荐按钮（本实现永远如此，见未实现部分）。

其余任何情况都纵排。特别地，三按钮栏与单按钮栏都走纵排路径。

单元格宽度来自 needSetButVertical：栏宽（先夹到 DialogDefaults.MaxWidth，即 coui_dialog_max_width 392dp）减去分割线后按按钮数均分，每格再减去自己的两侧内边距：

available = (min(392.dp, barWidth) - (buttonCount - 1) * StackedDividerThickness) / buttonCount
            - ButtonHorizontalPadding * 2

任一文案宽于 available 即触发翻转。文案用 TextMeasurer 按解析后的 textStyle 单行测量，对应 COUI 的原始 paint 测量。

TIP

该公式里减掉的是纵排档的 0.33dp 分割线厚度，即使这一栏最终画的是更粗的 1dp 横排分割线也一样。这是 COUIButtonBarLayout 的原始行为，此处如实复刻。

传 dynamicLayout = false 可锁定横排，等同于 COUIButtonBarLayout.setDynamicLayout(false)。

顺序与分割线

按钮顺序在两档之间反转，对应 resortButton：

档位	顺序
横排	negative → neutral → positive（从左到右）
纵排	neutral → positive → negative（从上到下）

所以否定（取消）动作横排时在最左，纵排时在最下。

分割线也不同：

档位	粗细	内缩
横排	1dp（`DialogDefaults.ButtonBarDividerThickness`）	上 17dp / 下 21dp
纵排	0.33dp（`DialogButtonBarDefaults.StackedDividerThickness`）	左右各 24dp

相邻的两个存在按钮之间会画一条分割线。传 showDivider = false 可全部隐藏（对应 buttonBarShowDivider 属性）。

属性