Componente Saída formatada padrão do JSF

Consulte também

Você pode arrastar o componente Saída formatada padrão do JavaServer Faces ícone da saída formatada da Paleta para o Visual Designer a fim de criar um campo de texto de saída que seja formatado. O componente Saída formatada fornece funcionalidade semelhante para o componente Texto de saída, mas adiciona a habilidade de substituir os parâmetros localizados quando o componente é renderizado. Como acontece com Texto de saída, Saída formatada é renderizado como uma marca HTML <span>.

Este componente é avançado porque ele requer edição direta do código JSP e compreensão dos pacotes de recursos. Você pode editar as propriedades deste componente em sua janela Propriedades e vinculá-lo a um provedor de dados, clicando com o botão direito do mouse no componente no Visual Designer e escolhendo a opção Vincular aos dados.

Aqui está uma breve explicação de como usar este componente:

Na visualização Código-fonte da sua página, um componente Saída formatada é a marca do componente JavaServer Faces <h:outputFormat>, que trata seu valor como uma entrada para um objeto java.text.MessageFormat. Você também pode aninhar marcas <f:param> dentro da marca <h:outputFormat> para especificar substituições dos parâmetros {0}, {1}, etc.

Para obter mais informações sobre sintaxe de mensagem válida, consulte as páginas do Javadoc para java.text.MessageFormat em

Para obter informações sobre a localização e os pacotes de recursos, consulte a seção sobre localização.

Exemplo simples

Você não precisa usar um pacote de recursos para usar um componente Saída formatada, embora você possa usar este exemplo em conjunto com <f:loadBundle> para obter a string de mensagem.

O exemplo seguinte assume que você tenha criado uma propriedade integer no bean de sessão chamado count que seleciona o número de itens no carrinho de compras do usuário (consulte a descrição do bean de sessão na janela Navegador para obter mais informações). O componente Saída formatada exibe o número de itens no carrinho de compras.

   <h:outputFormat binding="#{Page1.formattedOutput1}" 
                   id="formattedOutput1" 
                   style="left: 216px; top: 360px; position: absolute"
                   value="Você possui {0} itens em sue carinho de compras.">
      <f:param value="#{SessionBean1.count}"/>
   </h:outputFormat>

Exemplo do pacote de recursos

Se você tinha a string do exemplo anterior em um pacote de recursos sob a chave itemCount, talvez use o código seguinte:

   <f:loadBundle basename="webapplication1.Bundle"
                 var="messages"/>
   ...
   <h:outputFormat binding="#{Page1.formattedOutput1}" 
                   id="formattedOutput1" 
                   style="left: 216px; top: 360px; position: absolute"
                   value="#{messages.itemCount}">
      <f:param value="#{SessionBean1.count}"/>
   </h:outputFormat>

Para que o código deste exemplo funcione, ou qualquer outro caso em que deseja fornecer um pacote de recursos dentro da aplicação, você deve criar um arquivo de propriedades para conter as mensagens, como descrito em Criando e excluindo um pacote de recursos.

Depois que você cria um novo arquivo de propriedades, ele é aberto no Editor de propriedades. Para cada propriedade que deseja adicionar, clique em Nova propriedade e, na caixa de diálogo Nova propriedade, indique uma chave e um valor. Por exemplo, a propriedade do exemplo anterior teria uma chave chamada itemCount e o texto seria, "Você possui {0} itens em seu carrinho de compras."

Quando você implanta sua aplicação, o arquivo de propriedades é copiado para o diretório WEB-INF/classes/nome-do-projeto, de forma que esteja disponível para ser carregado pela marca <f:loadBundle>. Para obter mais informações, consulte Componente Carregar pacote.

Consulte também
Trabalhando com componentes
Tarefas de componente: referência rápida
Sobre a Paleta do Visual Web

Notificações legais