ZKoss 中在 properties 文件中实现多行标签的正确方法

在 zkoss 框架中，通过 `.properties` 文件定义国际化标签时，若需在前端（如 ``）中显示换行效果，不能直接使用 `\n`、`
` 或空行；必须采用 java properties 标准规范的续行语法（反斜杠+回车），并在 zul 中配合 `pre` 样式或 `white-space: pre-line` 才能正确渲染。

ZKoss 的国际化标签（${c:l('key'

)}）底层依赖 Java 的 java.util.Properties 加载机制，而该类对多行值有严格语法要求：必须使用反斜杠 \ 作为续行符，且 \ 后必须紧跟换行符（不可有空格），后续行将自动拼接为同一逻辑行。换行符本身不会被保留为 \n 字符——它仅用于语法解析，最终加载到内存中的字符串仍是单行。因此，若希望浏览器实际渲染换行，还需在前端控制 CSS 白空间行为。

✅ 正确做法如下：

1. .properties 文件中使用标准续行语法：

   mylabel.linebreakedlabel = Hello this label should be \
   breaked into two lines

   ⚠️ 注意：\ 必须是行末最后一个字符（后不可跟空格或制表符），下一行顶格书写；ZK 会将其合并为 "Hello this label should be breaked into two lines"（无 \n）。

2. 在 ZUL 中启用换行渲染：
   因 Properties 加载后字符串不含 \n，需借助 CSS 控制换行。推荐两种方式：

   • 方式一：用 + style="white-space: pre-line;"（推荐）

     ${c:l('mylabel.linebreakedlabel')}

     pre-line 会将连续空白符（含换行符）折叠，但保留语义换行（即按空格/换行自然断行），视觉上呈现两行。

   • 方式二：用

      包裹（语义更明确）  
     ${c:l('mylabel.linebreakedlabel')}
     但需重置默认 pre 样式（如外边距、字体），避免破坏布局。
     

❌ 常见错误规避：

• 不要写 \n：Java Properties 不识别转义序列，\n 会被当作字面量；
• 不要写
  或 ：ZUL 中非 HTML 模式，原样输出标签；
• 不要空行或 {} 包裹：Properties 解析器会截断或报错；
• 不要依赖 ZK 自动注入 \n：ZK 6+ 仍严格遵循 JDK Properties 行为。

? 进阶提示：若需动态插入换行符（如服务端计算），可改用 Label 组件的 setValue() 配合 setMultiline(true)，或在 ViewModel 中预处理字符串并注入 \n，再结合 white-space: pre-line 渲染。

综上，ZKoss 多行标签本质是「Properties 续行语法 + CSS 白空间策略」的组合方案，理解其分层机制（资源加载层 vs 渲染层）是解决问题的关键。