JSF - h: commandButton

A tag h: commandButton renderiza um elemento de entrada HTML do tipo "enviar".

Tag JSF

<h:commandButton value = "Click Me!" onclick = "alert('Hello World!');" />

Saída renderizada

<input type = "submit" name = "j_idt10:j_idt13" value = "Click Me!" 
   onclick = "alert('Hello World!');" />

Atributos de tag

S.No Atributo e descrição
1

id

Identificador para um componente

2

rendered

Um booleano; falso suprime a renderização

3

value

O valor de um componente, normalmente uma associação de valor

4

valueChangeListener

Uma ligação de método a um método que responde a alterações de valor

5

coords

Coordenadas para um elemento cuja forma é um retângulo, círculo ou polígono

6

dir

Direção do texto. Os valores válidos sãoltr (da esquerda para a direita) e rtl (direita para esquerda)

7

disabled

Estado desabilitado de um elemento de entrada ou botão

8

tabindex

Valor numérico que especifica um índice de tabulação

9

target

O nome de uma moldura na qual um documento é aberto

10

title

Um título, usado para acessibilidade, que descreve um elemento. Navegadores visuais normalmente criam dicas de ferramentas para o valor do título

11

width

Largura de um elemento

12

onblur

Elemento perde o foco

13

onchange

O valor do elemento muda

14

onclick

O botão do mouse é clicado sobre o elemento

15

ondblclick

O botão do mouse é clicado duas vezes sobre o elemento

16

onfocus

Elemento recebe foco

17

onkeydown

A tecla está pressionada

18

onkeypress

A tecla é pressionada e posteriormente liberada

19

onkeyup

Chave liberada

20

onmousedown

O botão do mouse é pressionado sobre o elemento

21

onmousemove

O mouse se move sobre o elemento

22

onmouseout

O mouse sai da área do elemento

23

onmouseover

O mouse se move para um elemento

24

onmouseup

O botão do mouse é liberado

25

onreset

O formulário foi reiniciado

26

onselect

O texto é selecionado em um campo de entrada

Aplicação de exemplo

Vamos criar um aplicativo JSF de teste para testar a tag acima.

Degrau Descrição
1 Crie um projeto com o nome helloworld sob um pacote com.tutorialspoint.test conforme explicado no capítulo JSF - Primeira Aplicação .
2 Modifique home.xhtml conforme explicado abaixo. Mantenha o resto dos arquivos inalterados.
3 Compile e execute o aplicativo para ter certeza de que a lógica de negócios está funcionando de acordo com os requisitos.
4 Por fim, construa o aplicativo na forma de um arquivo war e implante-o no Apache Tomcat Webserver.
5 Inicie seu aplicativo da web usando o URL apropriado, conforme explicado abaixo na última etapa.

home.xhtml

<!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">
   <head>
      <title>JSF Tutorial!</title>
   </head>
   
   <body>
      <h2>h:commandButton example</h2>
      <hr />
      
      <h:form>
         <h:commandButton value = "Click Me!" onclick = "alert('Hello World!');" />
      </h:form>
   </body>
</html>

Assim que você estiver pronto com todas as mudanças feitas, vamos compilar e rodar a aplicação como fizemos no capítulo JSF - Primeira Aplicação. Se tudo estiver certo com sua aplicação, isso produzirá o seguinte resultado.