JSF - h: commandLink

A tag h: commandLink renderiza um elemento HTML "âncora".

Tag JSF

<h:commandLink value = "Page 1" action = "page1" />

Saída renderizada

<a href = "#" onclick = "mojarra.jsfcljs(document.getElementById('j_idt13'), 
   {'j_idt13:j_idt14':'j_idt13:j_idt14'},'');return false">Page 1</a>

Atributos de tag

S.Não	Atributo e descrição
1	id Identificador para um componente
2	binding Referência ao componente que pode ser usado em um backing bean
3	rendered Um booleano; falso suprime a renderização
4	styleClass Nome da classe da folha de estilo em cascata (CSS)
5	value O valor de um componente, normalmente uma associação de valor
6	valueChangeListener Uma ligação de método a um método que responde a alterações de valor
7	converter Nome da classe do conversor
8	validator Nome da classe de um validador que é criado e anexado a um componente
9	required Um booleano; se verdadeiro, requer que um valor seja inserido no campo associado
10	Accesskey Uma chave, normalmente combinada com uma metachave definida pelo sistema, que dá foco a um elemento
11	accept Lista separada por vírgulas de tipos de conteúdo para um formulário
12	accept-charset Lista separada por vírgulas ou espaços de codificações de caracteres para um formulário. oaccept-charset atributo é especificado com o atributo JSF HTML chamado acceptcharset.
13	Alt Texto alternativo para elementos não textuais, como imagens ou miniaplicativos
14	border Valor de pixel para a largura da borda de um elemento
15	charset Codificação de caracteres para um recurso vinculado
16	coords Coordenadas para um elemento cuja forma é um retângulo, círculo ou polígono
17	dir Direção do texto. Os valores válidos sãoltr (da esquerda para a direita) e rtl (direita para esquerda)
18	hreflang Idioma base de um recurso especificado com o href atributo; hreflang só pode ser usado com href.
19	lang Idioma base dos atributos e texto de um elemento
20	maxlength Número máximo de caracteres para campos de texto
21	readonly Estado somente leitura de um campo de entrada; o texto pode ser selecionado em um campo somente leitura, mas não editado
22	rel Relação entre o documento atual e um link especificado com o href atributo
23	rev Link reverso da âncora especificada com hrefao documento atual. O valor do atributo é uma lista separada por espaço de tipos de link
24	size Tamanho de um campo de entrada
25	style Informação de estilo inline
26	tabindex Valor numérico que especifica um índice de tabulação
27	target O nome de uma moldura na qual um documento é aberto
28	title Um título, usado para acessibilidade, que descreve um elemento. Os navegadores visuais normalmente criam dicas de ferramentas para o valor do título
29	type Tipo de link; por exemplo,stylesheet
30	width Largura de um elemento
31	onblur Elemento perde o foco
32	onchange O valor do elemento muda
33	onclick O botão do mouse é clicado sobre o elemento
34	ondblclick O botão do mouse é clicado duas vezes sobre o elemento
35	onfocus Elemento recebe foco
36	onkeydown A tecla está pressionada
37	onkeypress A tecla é pressionada e posteriormente liberada
38	onkeyup Chave liberada
39	onmousedown O botão do mouse é pressionado sobre o elemento
40	onmousemove O mouse se move sobre o elemento
41	onmouseout O mouse sai da área do elemento
42	onmouseover O mouse se move para um elemento
43	onmouseup Botão do mouse liberado
44	onreset O formulário foi reiniciado
45	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 a seguir 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:commandLink example</h2>
      <hr />
      
      <h:form>
         <h:commandLink value = "Page 1" action = "page1" />
      </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 bem com sua aplicação, isso produzirá o seguinte resultado.

↰ Previous page