O Hyperlink de imagem cria uma imagem que se vincula a um URL. O hyperlink de imagem pode exibir texto e imagem.
Este componente possui suporte para funções JavaScript do lado do cliente que permitem realizar ações no cliente sem voltar ao servidor. Para obter mais informações sobre este recurso avançado, escolha Ajuda > Referência Javadoc > Biblioteca de marcas do Projeto Woodstock 4.2 e vá até webuijsf:imageHyperlink.
Para definir a imagem do componente Hyperlink de imagem, você pode clicar com o botão direito do mouse no componente e escolher Definir imagem. É exibida, então, uma caixa de diálogo que pode ser usada para especificar a imagem de três formas:
Escolher arquivo. Você pode ir até um arquivo do sistema de arquivos e clicar em OK. O arquivo de imagem é copiado para o projeto, e você pode vê-lo na em nome-do-projeto > Páginas da Web > recursos. A escolha desta opção define a propriedade url do componente Imagem como /resources/arquivo-de-imagem.
Inserir URL. Insere no arquivo um URL para um local da Web. Por exemplo, insere o seguinte URL:
.
A escolha desta opção define a propriedade url do componente Imagem como o URL inserido.
Definir ícone do tema. Exibe uma lista de ícones que estão no tema associado à aplicação. Selecione um nome de ícone na lista para exibi-lo na caixa de diálogo. A escolha desta opção define a propriedade icon do componente Imagem como o nome do ícone escolhido.
Se a propriedade url já estiver definida, a escolha de um ícone não altera a aparência do componente, pois a propriedade url tem prioridade sobre a propriedade icon. Para que o ícone esteja visível, a propriedade url não deve estar definida.
Você pode soltar o componente Imagem ou Texto estático, ou ambos, no Hyperlink de imagem se quiser personalizar a aparência do link.
Se soltar um componente no Hyperlink de imagem, você integra o componente ao hyperlink, e deve trabalhar com as propriedades do componente integrado em vez de trabalhar com as propriedades do Hyperlink de imagem. Selecione o componente incorporado na
Com exceção do suporte adicional para uma imagem, um Hyperlink de imagem é essencialmente igual a um componente Hyperlink. Assim como no componente Hyperlink, se você definir a propriedade action e não definir a propriedade url, a página é enviada. Do contrário, se definir a propriedade url, o link será um hyperlink normal que envia o navegador a um novo local, não envia a página e ignora qualquer configuração da propriedade action. As propriedades do componente podem ser definidas na sua janela Propriedades.