Você vê a janela Propriedades de um componente Hyperlink do JavaServer Faces quando seleciona a parte exterior do componente em uma página que está editando no Visual Designer, ou quando seleciona a parte Hyperlink desse componente composto na janela Navegador.
O componente Hyperlink consiste em um componente Texto de saída incorporado em um componente Hyperlink . Quando seleciona este componente no Visual Designer, você também o vê na janela Navegador, onde pode selecionar a parte do componente na qual deseja trabalhar.
Este componente JavaServer Faces padrão possui as propriedades a seguir.
Geral
id. Tipo: text
O nome do componente Hyperlink no bean de página e o arquivo JSP.
target. Tipo: String
O quadro da página atual na qual o link deve ser aberto.
Aparência
style. Tipo: String
Regras de folha de estilo em cascata (CSS nível 2) a serem aplicadas ao componente. Esta propriedade sobrescreve as configurações do arquivo CSS do projeto. Por exemplo:
position: absolute; left: 288px; top: 312px
Você pode inserir valores diretamente ou clicar no botão de reticências (...) para usar o Editor de estilo.
Para obter uma lista de estilos CSS2, consulte a página da Web em
styleClass. Tipo: String
Indique uma lista separada por espaços de classes de estilo CSS2 a serem aplicadas quando o componente é renderizado. As classes do estilo devem ser definidas na folha de estilo do projeto. Se você clicar no botão de reticências (...), verá uma lista de todos os estilos que podem ser adicionados a esta propriedade. Para obter informações sobre a adição de classes CSS e regras na folha de estilos em cascata do projeto, consulte Editor CSS.
title. Tipo: String
Informações sobre o hyperlink que podem ser lidas por um leitor de tela e podem ser exibidas como uma dica de ferramenta.
Se o componente for desativado, a dica de ferramenta não será exibida na maioria dos navegadores.
Dados
converter. Tipo: Conversor
Um conversor JavaServer Faces que produz o tipo correto do valor da propriedade value. Se o usuário inserir o tipo incorreto de valor, tal como uma palavra em vez de um número em um Conversor de inteiro, o conversor enviará uma mensagem que você poderá exibir em um componente Mensagem in-line.
value. Tipo: Objeto
O URL do documento ou recurso de destino. Equivalente ao atributo HTML href.
JavaScript
onblur. Tipo: String
JavaScript a ser executado quando o componente perde o foco.
onclick. Tipo: String
JavaScript a ser executado quando o usuário clica no componente.
ondblclick. Tipo: String
JavaScript a ser executado quando o usuário clica duas vezes no componente.
onfocus. Tipo: String
JavaScript a ser executado quando o componente recebe o foco.
onkeydown. Tipo: String
JavaScript a ser executado quando o componente recebe o foco e a tecla é pressionada.
onkeypress. Tipo: String
JavaScript a ser executado quando o componente recebe o foco e a tecla é pressionada e liberada.
onkeyup. Tipo: String
JavaScript a ser executado quando o componente recebe o foco e a tecla é liberada.
onmousedown. Tipo: String
JavaScript a ser executado quando o cursor do mouse está sobre o componente e o usuário pressiona o botão do mouse.
onmousemove. Tipo: String
JavaScript a ser executado quando o usuário move o cursor do mouse no componente.
onmouseout. Tipo: String
JavaScript a ser executado quando o usuário move o cursor do mouse para longe do componente, depois de estar sobre o componente.
onmouseover. Tipo: String
JavaScript a ser executado quando o usuário move o cursor do mouse para o componente.
onmouseup. Tipo: String
JavaScript a ser executado quando o cursor do mouse está sobre o componente e o usuário libera o botão do mouse.
Avançado
accesskey. Tipo: String
Uma tecla ou atalho de teclado, que ativa este hyperlink. Você pode indicar qualquer caractere válido que possa ser digitado no teclado. Equivalente ao atributo accesskey da marca HTML <input>.
charset. Tipo: String
A codificação de caractere do documento ou o recurso ao qual o hyperlink se vincula. Equivalente ao atributo HTML charset da marca <a>. Você pode ver uma lista das codificações em
.
coords. Tipo: String
A posição e a forma do ponto de acesso na página, usada para mapas de imagem do lado do cliente. Equivalente ao atributo HTML coords da marca <a>. O número e a ordem de valores depende da forma que está sendo definida. As combinações possíveis são:
rectangulo. left-x, top-y, right-x, bottom-y.
circle. centro-x, centro-y, raio.
polygon. x1, y1, x2, y2, ..., xN, yN. O primeiro e o último par de coordenadas x e y devem ser os mesmos para fechar o polígono.
As coordenadas são relativas ao canto esquerdo superior do objeto. Todos os valores são tamanhos. Todos os valores são separados por vírgulas.
dir. Tipo: String
Um indicador da direcionalidade se o texto não herdar a direcionalidade (por exemplo, porque o texto está em inglês mas o idioma principal da página é hebraico). Equivalente ao atributo dir da marca HTML <input>.
Os valores podem ser:
LTR. Esquerda para direita.
RTL. Direita para esquerda.
hreflang. Tipo: String
Código que descreve o idioma usado pelo documento ou recurso ao qual o hyperlink se vincula. Esta propriedade usa o mesmo valor que Language Code, que é descrita em seguida.
lang. Tipo: String
Código que descreve a linguagem usada na marcação gerada para o componente. Equivalente ao atributo lang da marca HTML <input>. Para escolher um código de idioma, clique no botão de reticências (...) para abrir o editor de propriedade. Alguns exemplos:
ar - árabe tradicional
de - alemão
en - inglês
es - espanhol
fr - francês
ja - japonês
Além dos códigos disponíveis no editor de propriedade, você também pode inserir códigos adicionais usando nomes ISP padrão. Alguns exemplos:
en-US - inglês dos Estados Unidos
ja-JP - japonês
zh-guoyu - mandarim ou chinês padrão
zh-Hans - script em chinês simplificado
zh-HansT - script em chinês tradicional
rel. Tipo: String
Especifica a relação com o documento vinculado. Equivalente ao atributo HTML rel, uma lista de tipos separada por espaços. Os tipos podem ser um dos seguintes:
Alternate. Versões substitutas do documento nas quais o link ocorre. Quando usada com o atributo lang, significa que o substituto é uma versão traduzida do documento.
Apêndice. Um apêndice em uma coleção de documentos.
Indicador. Um link para um ponto de entrada em um documento.
Capítulo. Um capítulo em uma coleção de documentos.
Conteúdo. Um índice analítico.
Direito autoral. O direito autoral do documento atual.
Glossário. Um glossário de termos do documento atual..
Ajuda. Um documento de ajuda.
Índice. O índice do documento atual.
Próximo. O próximo documento em uma seqüência de documentos.
Anterior. O documento anterior em uma seqüência de documentos.
Seção. Uma seção em uma coleção de documentos.
Iniciar. O primeiro documento em uma coleção de documentos: o ponto inicial da coleção.
Folha de estilo Refere-se a uma folha de estilo externa. Usada com o tipo de link alternativo para oferecer folhas de estilo que podem ser selecionadas pelo usuário.
Subseção. Uma subseção em uma coleção de documentos.
rendered. Tipo: booleano
Se for selecionada, o hyperlink será renderizado e processado em qualquer envio de página subseqüente. Se não for selecionada, o hyperlink não aparecerá na página, nem mesmo como um componente oculto. Você pode vincular esta propriedade a uma variável que determina quando o componente é renderizado. Por exemplo, um formulário de reserva de viagens pode mostrar um hyperlink para passageiros freqüentes e não mostrá-lo para o público em geral. Para vincular esta propriedade, clique com o botão direito do mouse no componente no Visual Designer e escolha Vinculações de propriedade e, em seguida, selecione Todos os botões de opção para exibir todas as propriedades para que você possa selecionar a propriedade rendered.
rev. Tipo: String
Um link de tipo reverso a partir do documento ao qual este hyperlink se vincula de volta para este documento. Equivalente ao atributo HTML rev, uma lista de tipos separada por vírgulas. Consulte a propriedade Relationship acima para obter uma lista de tipos.
shape. Tipo: String
A forma do ponto de acesso na página, usado para mapas de imagem do lado do cliente. Equivalente ao atributo HTML shape da marca <a>. Os valores possíveis são:
padrão. Região inteira
retângulo. Região retangular.
circle. Região circular.
polígono. Região do poligonal.
tabindex. Type: String
Especifica opcionalmente a posição do hyperlink na ordem das abas do documento, determinando quando o Hyperlink terá o foco, se o usuário navegar no documento. O valor deve ser um inteiro entre 0 e 32767. Equivalente ao atributo tabindex da marca HTML <input>.
type. Tipo: String
O tipo de conteúdo do recurso ao qual este hyperlink se vincula. Equivalente ao atributo HTML type, que é um tipo de MIME, tal como text/html, image/png, image/gif, video/mpeg, text/css ou audio/basic.