在 zkoss 框架中，通过 `.properties` 文件定义国际化标签时，若需在前端（如 `
ZKoss 的国际化标签（${c:l('key')}）底层依赖 Java 的 java.util.Properties 加载机制，而该类对多行值有严格语法要求：必须使用反斜杠 \ 作为续行符，且 \ 后必须紧跟换行符（不可有空格），后续行将自动拼接为同一逻辑行。换行符本身不会被保留为 \n 字符——它仅用于语法解析，最终加载到内存中的字符串仍是单行。因此，若希望浏览器实际渲染换行，还需在前端控制 CSS 白空间行为。
✅ 正确做法如下：
-
.properties 文件中使用标准续行语法：
mylabel.linebreakedlabel = Hello this label should be \ breaked into two lines
⚠️ 注意：\ 必须是行末最后一个字符（后不可跟空格或制表符），下一行顶格书写；ZK 会将其合并为 "Hello this label should be breaked into two lines"（无 \n）。
-
在 ZUL 中启用换行渲染：
因 Properties 加载后字符串不含 \n，需借助 CSS 控制换行。推荐两种方式：-
方式一：用 <label> + style="white-space: pre-line;"（推荐）
<h:label style="white-space: pre-line;">${c:l('mylabel.linebreakedlabel')}</h:label>pre-line 会将连续空白符（含换行符）折叠，但保留语义换行（即按空格/换行自然断行），视觉上呈现两行。
-
方式二：用 <pre> 包裹（语义更明确）
<pre style="margin: 0; font-family: inherit;">${c:l('mylabel.linebreakedlabel')}</pre>但需重置默认 pre 样式（如外边距、字体），避免破坏布局。
-
❌ 常见错误规避：
- 不要写 \n：Java Properties 不识别转义序列，\n 会被当作字面量；
- 不要写 <br> 或 </br>：ZUL 中非 HTML 模式，原样输出标签；
- 不要空行或 {} 包裹：Properties 解析器会截断或报错；
- 不要依赖 ZK 自动注入 \n：ZK 6+ 仍严格遵循 JDK Properties 行为。
? 进阶提示：若需动态插入换行符（如服务端计算），可改用 Label 组件的 setValue() 配合 setMultiline(true)，或在 ViewModel 中预处理字符串并注入 \n，再结合 white-space: pre-line 渲染。
综上，ZKoss 多行标签本质是「Properties 续行语法 + CSS 白空间策略」的组合方案，理解其分层机制（资源加载层 vs 渲染层）是解决问题的关键。
