文字
TextFlatten {
"a".emit(color = Color.RED)
"b".emit(style = DslCharStyle().italic)
}
不要忘记emit(),否则这个字符串不会显示。可以为字符串的每个部分指定字号、样式、颜色。
size建议指定为9.px的整数倍。
换行
TextFlatten永远是一行,即使里面有\n字符也会自动去掉。如果要用\n换行应该使用TextFoldable。如果想让文字填满长度后自动换行,应该使用TextAutoFold。
它们会自动计算布局所需的最小空间,并“撑开”外部空间。TextAutoFold的最小宽度是0。
翻译
语言文件(assets/<modid>/lang/<语言>.json)是翻译的唯一来源,键就是点分路径:
{
"mymod.page.title": "我的页面",
"mymod.page.count": "共 %s 项"
}
在 DSL 里用translate取值,查不到时原样显示键名:
TextFlatten { translate("mymod.page.title").emit() }
TextFlatten { translate("mymod.page.count", 3).emit() }
额外参数会先转成字符串再替换占位符。游戏在读取语言文件时已把%d、%f这类数字占位符统一改写成%s,所以实际只有%s一种占位符。
不在 DSL 上下文里(例如入口的元数据)用translateGlobal。
框架自己的键都以kotlinmcui.开头。