Você vê a janela Propriedades de um componente Imagem do JavaServer Faces quando seleciona o componente em uma página que está editando no Visual Designer.
A maioria das propriedades do componente são atributos JSP e as propriedades do componente Java HtmlGraphicImage no bean de página.
Este componente JavaServer Faces padrão possui as propriedades a seguir.
Geral
id. Tipo: text
O nome do componente Imagem no bean de página e o arquivo JSP.
Aparência
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. O mesmo que o atributo HTML alt
da marca <img>.
height. Tipo: String
Define a altura da imagem em pixels, caso você queira substituir a altura real da imagem exibida. Em HTML, está propriedade é o atributo height da marca <img> gerada.
longdesc. Tipo: String
O URL de uma página da Web que possui uma descrição deste gráfico. Em HTML, está propriedade é o atributo longdesc da marca <img> gerada.
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 de título consultivo sobre o componente, 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.
width.Tipo: String
Define a largura da imagem em pixels, caso queira substituir a largura real da imagem exibida. Em HTML, está propriedade é o atributo width da marca <img> gerada.
Dados
value. Tipo: Objeto
O caminho relativo para o arquivo da imagem, tal como /resources/image-file.gif, ou uma URL que aponta para uma imagem, tal como
.
JavaScript
onclick. Tipo: String
JavaScript a ser executado quando o usuário clica na imagem.
ondblclick. Tipo: String
JavaScript a ser executado quando o usuário clica duas vezes na imagem.
onkeydown. Tipo: String
JavaScript a ser executado quando a imagem recebe o foco e a tecla é pressionada.
onkeypress. Tipo: String
JavaScript a ser executado quando a imagem recebe o foco e a tecla é pressionada e liberada.
onkeyup. Tipo: String
JavaScript a ser executado quando a imagem recebe o foco e a tecla é liberada.
onmousedown. Tipo: String
JavaScript a ser executado quando o cursor do mouse está sobre a imagem 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 na imagem.
onmouseout. Tipo: String
JavaScript a ser executado quando o usuário move o cursor do mouse para longe da imagem, depois de estar sobre a imagem.
onmouseover. Tipo: String
JavaScript a ser executado quando o usuário move o cursor do mouse para a imagem.
onmouseup. Tipo: String
JavaScript a ser executado quando o cursor do mouse está sobre a imagem e o usuário libera o botão do mouse.
Avançado
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.
ismap. Tipo: booleano
Se selecionada, a imagem é um mapa de imagem do lado de servidor e deve ficar em um hyperlink.
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
rendered. Tipo: booleano
Se for selecionada, o componente será renderizado e processado em qualquer envio de página subseqüente. Se não for selecionada, o componente 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 o componente 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.
usemap. Tipo: String
O nome de um mapa de imagem do lado do cliente para o qual esse componente fornece a imagem.