JSF <f:convertNumber>標籤

<f:convertNumber>標籤用於將字串值轉換為所需格式的數量。以下程式碼顯示如何使用<f:convertNumber>標籤

<f:convertNumber minFractionDigits="2" />

標籤屬性

屬性	描述
type	數位(預設)，貨幣或百分比
pattern	格式化模式，如在`java.text.DecimalFormat`中定義的
maxFractionDigits	小數部分中的最大位數
minFractionDigits	小數部分中的最小位數
maxIntegerDigits	整數部分的最大位數
minIntegerDigits	整數部分的最小位數
integerOnly	如果只解析整數部分，則為`true`(預設值：`false`)
groupingUsed	如果使用分組分隔符，則為`false`(預設值為`true`)
locale	用於分析和格式化的偏好設定的區域設定
currencyCode	轉換貨幣值時使用的ISO 4217貨幣程式碼
currencySymbol	轉換貨幣值時使用的貨幣符號

範例

以下是檔案：index.xhtml 中的程式碼 -

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"   
      xmlns:h="http://java.sun.com/jsf/html"
      xmlns:f="http://java.sun.com/jsf/core"
      xmlns:c="http://java.sun.com/jsp/jstl/core"
      >
    <h:body>    
    <h:form>
      <h:panelGrid columns="3">
        Amount : 
        <h:inputText id="amount" value="#{receipt.amount}" 
          size="20" required="true"
          label="Amount" >
          <!-- display in at least 2 decimal points -->
          <f:convertNumber minFractionDigits="2" />
        </h:inputText>
        <h:message for="amount" style="color:red" />
      </h:panelGrid>
      <h:commandButton value="Submit" action="result" />
    </h:form>

    </h:body>
</html>

以下是檔案：result.xhtml 中的程式碼 -

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" 
"http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml"   
      xmlns:h="http://java.sun.com/jsf/html"
      xmlns:f="http://java.sun.com/jsf/core"
      xmlns:c="http://java.sun.com/jsp/jstl/core"
      >
    <h:body>
    <p>
      Amount [minFractionDigits="2"] : 
      <h:outputText value="#{receipt.amount}" >
        <f:convertNumber minFractionDigits="2" />
      </h:outputText>
    </p>
    <p>
      Amount [pattern="#0.000"] : 
      <h:outputText value="#{receipt.amount}" >
        <f:convertNumber pattern="#0.000" />
      </h:outputText>
    </p>
    <p>
      Amount [currencySymbol="$"] : 
      <h:outputText value="#{receipt.amount}">
        <f:convertNumber currencySymbol="$" type="currency" />
      </h:outputText>
    </p>
    <p>
      Amount [currencyCode="GBP"] : 
      <h:outputText value="#{receipt.amount}" >
        <f:convertNumber currencyCode="GBP" type="currency" />
      </h:outputText>
    </p>
    <p>
      Amount [type="percent"] : 
      <h:outputText value="#{receipt.amount}" >
        <f:convertNumber type="percent" />
      </h:outputText>
    </p>
    </h:body>
</html>

以下是檔案：UserBean.java 中的程式碼 -

package com.yiibai;

import java.io.Serializable;
import javax.faces.bean.ManagedBean;
import javax.faces.bean.SessionScoped;

@ManagedBean(name="receipt")
@SessionScoped
public class UserBean implements Serializable{

  double amount;

  public double getAmount() {
    return amount;
  }

  public void setAmount(double amount) {
    this.amount = amount;
  }

}

執行測試

開啟 Netbeans建立一個Web工程：ConvertNumber，並使用上面列出的檔案程式碼。執行專案，在Tomcat啟動完成後，在瀏覽器位址列中輸入以下URL。

http://localhost:8084/ConvertNumber

如果程式沒有錯誤，應該會看到如下結果 -

在輸入框中填入 999.98 然後提交，應該會看到如下結果 -