在 XPage 中使用带有 message.properties 的外部文本

Created: November-22, 2018

准备

首先在 Resources / Files /中创建一个“message.properties”文件。例：

##############
# Test message.properties
##############
label.age=Enter your age:
validate.error.reqired.age=Sorry, but you have to give away the secret of your age ...

接下来，将资源与 XPage 或自定义控件连接：

<xp:this.resources>
    <xp:bundle src="/messages.properties" var="appMsg" />
    ....
</xp:this.resources>

注意：var 定义要在 XPage 或自定义控件中使用的名称以引用消息映射。

用法

现在，你可以将消息映射与服务器端 JavaScript（#{javascript:appMsg.getString('...')}）或 EL（#{appMsg['...']}）一起使用。

用法示例：

...
<!-- to show the error message: -->
<xp:messages />

<!-- use with ssjs: -->
<xp:text value="#{javascript:appMsg.getString('label.age')}" escape="false" />

<!-- use with EL: -->
<xe:djNumberSpinner value="#{myDoc.age}" maxLength="2" javaType="int">
    <xp:this.validators>
        <xp:validateRequired message="#{appMsg['validate.error.reqired.age']}" />
    </xp:this.validators>
</xe:djNumberSpinner>
...