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.