Você vê a janela Propriedades de um componente Hyperlink de imagem quando seleciona a parte exterior do componente em uma página que está editando no Visual Designer, ou quando seleciona a parte Hyperlink de imagem deste componente composto na janela Navegador.
Este componente possui as propriedades a seguir.
Geral
id.Tipo: String
O nome do componente Hyperlink de imagem no bean de página e o arquivo JSP.
Aparência
align. Tipo: String
A posição da imagem em relação ao seu contexto na página. Selecione uma posição na lista suspensa para alinhar o hyperlink de imagens a outros componentes.
border. Tipo: int
Especifica a largura da borda da imagem em pixels. O valor padrão desta propriedade depende do navegador do cliente
height. Tipo: int
Define a altura da imagem em pixels, caso você queira substituir a altura real da imagem exibida. Em HTML, esta propriedade é equivalente ao atributo height da marca <img>. Nem todos os navegadores respondem a esta configuração.
icon. Tipo: String
Permite que você selecione uma imagem a partir do tema em vez de especificar seu próprio arquivo de imagem. Se quiser que o ícone seja usado, certifique-se de que a propriedade imageURL não esteja definida.
imageURL. Tipo: String
O caminho relativo para um arquivo de imagem. Esta propriedade terá prioridade sobre a propriedade icon se ambas tiverem valores definidos. Se você clicar no botão de reticências (...), poderá digitar um URL de um arquivo de imagem na Web, poderá navegar para um arquivo de imagem e importá-lo para o projeto ou poderá vincular esta propriedade a uma propriedade JavaBeans que determina o URL, como descrito no Editor de propriedade imageURL.
style. Tipo: String
Regras de folha de estilo em cascata (CSS nível 2) a serem aplicadas ao componente. 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.
Esta propriedade substitui quaisquer configurações do tema ou do arquivo CSS desse componente. Se um estilo especificado nesta propriedade não surtir efeito, é porque uma área do componente está obscurecida por um componente filho que possui configurações de estilo diferentes.
Para obter uma lista de estilos CSS2, consulte a página da Web em
styleClass. Tipo: String Uma lista separada por espaços de classes de estilo CSS2 a serem aplicadas quando o componente é renderizado. As classes de estilo devem ser definidas na folha de estilo do projeto no arquivo CSS do tema. 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.
Consulte a observação acima abaixo da descrição da propriedade style para obter uma explicação do porquê uma classe adicionada a esta propriedade talvez pareça não ter efeito no componente.
text. Tipo: String
A parte do texto, visível, do hyperlink. Equivalente ao texto entre as marcas HTML <a href="url">text</a>. Você pode ter o texto e a imagem visível para um hyperlink de imagem.
textPosition. Tipo: String
Especifica onde o texto se situará em relação à imagem. Escolha uma posição na lista suspensa.
width.Tipo: int
Define a largura da imagem em pixels, caso queira substituir a largura real da imagem exibida. Em HTML, é equivalente ao atributo height da marca <img>. Nem todos os navegadores respondem a esta configuração.
Eventos
action. Tipo: MethodBinding
O método de ação a ser chamado quando este componente for ativado pelo usuário. Se você definir a propriedade action, a página será enviada quando este componente for ativado. A marca JSP desta propriedade é actionExpression.
Se você especificou um valor para a propriedade url, a ação não acontecerá. A propriedade url tem prioridade sobre a propriedade action.
Se clicar com o botão direito do mouse no componente, você poderá escolher Editar manipulador de eventos para definir um método de ação do hyperlink e definir o valor desta propriedade automaticamente para este método. O método de ação determina que página deve ser aberta com base em certas condições. O método de ação geralmente processa os cliques do mouse e retorna um tipo String que indica o nome de um caso de navegação de página (a próxima página a ser exibida em sua aplicação). O nome padrão do método é id-do-hyperlink_action, no qual id-do-hyperlink é o valor da propriedade id do hyperlink.
Comportamento
disabled. Tipo: booleano
Se for selecionada, indicará que este componente nunca receberá o foco.
target. Tipo: String
O quadro da página atual na qual o link deve ser aberto. Se não houver um quadro com este nome, a resposta será processada em uma nova janela a menos que seja substituída pelo usuário. Os nomes de quadro seguintes possuem significado especial:
_blank - renderiza a resposta em uma janela nova, sem nome
_self - renderiza a resposta no quadro atual
_parent - renderiza a resposta no conjunto de quadros pai imediato
_top - renderiza a resposta na janela inteira, sem quadros
toolTip. Tipo: String
Renderizada como o atributo HTML title do componente, que pode ser lido por um leitor de tela e pode ser exibido como uma dica de ferramentas.
Se o componente for desativado, a dica de ferramenta não será exibida na maioria dos navegadores.
url. Tipo: String
O URL do documento ou recurso de destino. Equivalente ao atributo HTML href. Se o valor desta propriedade for definido, haverá duas conseqüências:
A página não será enviada se o usuário clicar no hyperlink.
Qualquer configuração da propriedade action será ignorada.
Se você não definir esta propriedade, clicar no hyperlink enviará a página. Normalmente, se não definir esta propriedade, você usa o método de ação para definir o que deve acontecer quando o usuário clicar no hyperlink. Consulte a propriedade action acima para obter mais informações.
visible. Tipo: booleano
Indica se o componente pode ser visto ou não pelo usuário na página HTML renderizada. Esta propriedade é selecionada por padrão. Se você desmarcar esta propriedade, o código HTML do componente será renderizado na página, mas o componente não ficará visível no navegador porque ele estará oculto por uma configuração de estilo. Como o código HTML é renderizado, os usuários que exibem o código-fonte no navegador podem ver o código HTML. Além disso, sua aplicação Web pode usar JavaScript do lado cliente para mostrar ou ocultar o componente.
Se você precisar ocultar completamente o componente, por exemplo, porque ele contém informações confidenciais que determinados usuários não podem ver, desmarque a propriedade rendered.
Acessibilidade
alt. Tipo: String
O texto alternativo da imagem. O texto alt descreve o elemento gráfico na página HTML, pode ser lido por leitores de tela, pode ser exibido como uma dica de ferramenta e é exibido quando o usuário tem a visualização de imagens desativada no navegador da Web. Equivale ao atributo HTML alt da marca <img>.
tabIndex. Tipo: String
Especifica opcionalmente a posição do componente na ordem de guias do documento. Determina quando o componente terá o foco se o usuário navegar no documento. O valor deve ser um inteiro entre 0 e 32767.
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.
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
actionListener. Tipo: MethodBinding
Um método de vinculação que representa um método ouvinte de ação que é notificado quando este componente é ativado pelo usuário. O valor deve ser uma expressão de método JSF válida, tal como #{Page1.action_method}, e deve ser interpretado como o nome de um método público que usa o parâmetro ActionEvent com o tipo de retorno vazio.
hspace. Tipo: int
Especifica os espaços em branco em pixels que serão inseridos à direita e à esquerda da imagem. O valore padrão não é especificado, mas é geralmente um tamanho pequeno, diferente de zero.
immediate. Tipo: booleano
Se esta propriedade for selecionada, quando o usuário ativar o componente, o manipulador de ação será chamado antes da validação, atualização de valores de modelo, etc. Finalmente, a execução do código acontece imediatamente no servidor que, em seguida, retorna a página. Uma forma mais simples de obter esta funcionalidade é associar o componente a um formulário virtual e, em seguida, clicar com o botão direito do mouse no componente e escolher Enviar automaticamente ao alterar.
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.
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.
urlLang. Tipo: String
Código que descreve o idioma usado no recurso referenciado pela propriedade url. Equivalente ao atributo hreflang da marca HTML <a>. 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
vspace. Tipo: int
Especifica os espaços em branco em pixels que serão inseridos acima ou abaixo da imagem. O valore padrão não é especificado, mas é geralmente um tamanho pequeno, diferente de zero.