Você vê a janela Propriedades de um componente Imagem quando seleciona o componente em uma página que está editando no Visual Designer.
A maioria das propriedades do componente Imagem são atributos JSP e as propriedades do componente Java Image no bean de página.
Este componente possui as propriedades a seguir.
Geral
id. Tipo: String
O nome do componente 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 a imagem 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. Verifique se a propriedade url não está definida,caso queira usar um ícone em vez de um arquivo de imagem.
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.
url. Tipo: String
O caminho para um arquivo de imagem ou uma expressão que se vincula a um objeto que fornece o caminho para a imagem. Esta propriedade terá prioridade sobre a propriedade icon, caso ambas sejam definidas. Se você clicar no botão de reticências (...), poderá se vincular a um objeto ou poderá fornecer um valor e navegar para um arquivo de imagem e importá-lo para o projeto. Você também pode apontar para um URL de uma imagem na Web. Por exemplo, uma referência de arquivo pode ser /resources/image-file.gif e um URL que leva a uma imagem pode ser
.
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.
Comportamento
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.
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, o componente ainda pode ser processado em envios de formulário, e os usuários que vêem 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>.
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.
JavaScript
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.
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
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.
rendered. Tipo: booleano
Se for selecionada, a imagem será renderizada e processada em qualquer envio de página subseqüente. Se não for selecionada, a imagem não aparecerá na página, nem mesmo como um componente oculto.
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.