JSF Core Tags

Jak łatwo się domyślić, jsf_core udostępnia podstawowe (i niezależne od sposobu wyświetlania) znaczniki. Są wśród nich np. tagi konwerterów, walidatorów, listenerów, które można zagnieździć w tagach komponentów, rejestrując na nich konwertery, walidatory itd.

Proste przykłady zarejestrowania konwertera daty, walidatora liczb (by były z przedziału od-do) i listenera:

<h:inputText id="userNo"
   value="#{UserNumberBean.userNumber}">
  <f:validateLongRange
     minimum="#{UserNumberBean.minimum}"
     maximum="#{UserNumberBean.maximum}" />
</h:inputText>

<h:outputText value="#{cashier.shipDate}">
  <f:convertDateTime dateStyle="full" />
</h:outputText>

<h:commandLink id="Germany" action="bookstore"
  actionListener="#{localeBean.chooseLocaleFromLink}">
  <h:outputText value="#{bundle.German}" />
</h:commandLink>

Do ciekawszych tagów należą poza tym:

• view
  Obowiązkowy! Strona JSF jest reprezentowana jako drzewo, jej korzeniem jest komponent UIViewRoot. Tag view reprezentuje ten komponent, wszystkie pozostałe tagi muszą być w nim zawarte:

  <f:view>
  ... inne tagi ...
  </f:view>
  

• subview
  By załączyć stronę zawierającą tagi JSF należy zagnieździć ją w tagu subview (subview stanie się korzeniem poddrzewa dla znaczników z zaincludowanej strony)

  <f:subview id="nestedPage">
     <jsp:include page="nestedPage.jsp">
  </f:subview>
  

• facet - zagnieżdżony komponent o specjalnym znaczeniu dla znacznika-rodzica - jak nagłówek, stopka itp. Ten tag może mieć tylko jedno dziecko, więc jeśli chcielibyśmy zagnieździć więcej tagów, musimy w nim zagnieździć panelGroup i dopiero w nim pozostałe.

  <h:column >
     <f:facet name="header">
        <h:outputText value="#{bundle.ItemQuantity}" />
     </f:facet>
     <h:inputText id="quantity" size="4"
        value="#{item.quantity}" >
     </h:inputText>
  </h:column>
  

• loadBundle - do lokalizacji aplikacji - pozwala określić, gdzie jest ResourceBundle, z którego będziemy chcieli korzystać

  <f:loadBundle var="bundle" basename="carstore.bundles.Resources"/>
  

  by potem użyć zlokalizowanych wiadomości w zagnieżdżonych tagach:

  <h:outputText value="#{bundle.Hello}"/>
  

• selectItem, selectItems - zbiór elementów i jeden element ze zbioru:

  <h:selectOneMenu   id="shippingOption"
    required="true"
    value="#{cashier.shippingOption}">
    <f:selectItem
       itemValue="2"
       itemLabel="#{bundle.QuickShip}"/>
    <f:selectItem
       itemValue="5"
       itemLabel="#{bundle.NormalShip}"/>
  </h:selectOneMenu>
  
  <h:selectManyCheckbox
    id="newsletters"
    layout="pageDirection"
    value="#{cashier.newsletters}">
    <f:selectItems
       value="#{newsletters}"/>
  </h:selectManyCheckbox>