在 zkoss 框架中，通过 `.properties` 文件定义国际化标签时，若需在前端 `
ZKoss 使用标准 Java ResourceBundle 加载 .properties 文件，其解析规则严格遵循 Java Properties 文件规范：仅当反斜杠 \ 位于行末（后紧跟换行符）时，才表示续行；换行符本身会被忽略，最终合并为单行字符串。因此，单纯写 \n 或换行不会生效——ZK 并未对属性值做额外的 \n → <br> 转义。
✅ 正确做法（ZK 6+ 兼容）：
-
在 .properties 文件中使用续行语法（注意：\ 后不能有空格或制表符，且下一行不能缩进）：
mylabel.linebreakedlabel = Hello this label should be \ breaked into two lines
→ 解析后等效于 "Hello this label should be breaked into two lines"（无换行符）。
-
但 ZK 的 c:l() 函数默认不渲染换行符为 HTML 换行，因此需配合 pre 标签、CSS 或 ZK 内置支持：
-
✅ 推荐方案：用 <html> 标签包裹，并启用 multiline="true"（ZK 6.5+）或手动插入 <br>（需确保 HTML 安全性）：
<h:label> <html><![CDATA[${c:l('mylabel.linebreakedlabel')}]]></html> </h:label>并在 .properties 中使用实际 <br>（ZK 会自动解码 HTML 实体）：
mylabel.linebreakedlabel = Hello this label should be <br>breaked into two lines
-
✅ 更安全通用方案（兼容 ZK 6）：使用 <div> + CSS white-space: pre-line，并在 .properties 中插入 Unicode 换行符（需 UTF-8 编码且文件保存为 UTF-8）：
<div style="white-space: pre-line;"> ${c:l('mylabel.linebreakedlabel')} </div>对应 .properties（注意：需用 \u000A 表示 LF，且 IDE/编辑器必须以 UTF-8 保存）：
mylabel.linebreakedlabel = Hello this label should be \u000Abreaked into two lines
-
⚠️ 注意事项：
- 确保 .properties 文件以 UTF-8 编码保存（尤其含 \uXXXX 时），并在 zk.xml 中声明编码（ZK 6 默认支持 UTF-8）；
- 避免在 \ 后添加空格或注释，否则续行失效；
- <br> 方案需确认 ZK 版本是否对 c:l() 返回值自动 HTML 解码（ZK 6 默认开启，如被转义可改用 c:ml() 多语言函数）；
- 不要依赖 \n 直接渲染——浏览器 <label> 或 <span> 默认忽略空白符，必须配合 CSS 或 HTML 标签。
总结：ZKoss 多行标签的本质是「Properties 续行 + 前端 HTML/CSS 协同渲染」。优先推荐 <br> + <html> 组合（简洁可控），次选 white-space: pre-line + \u000A（语义更清晰）。务必验证文件编码与 ZK 的资源加载配置一致性。
