在 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>
...