Você vê a janela Propriedades de um componente Barra de progresso quando seleciona o componente em uma página que está editando no Visual Designer. Como alternativa, você pode selecionar este componente na
Este componente JavaServer Faces 1.2 possui as propriedades a seguir.
Geral
id. Tipo: String
O nome do componente Barra de progresso no bean de página e o arquivo JSP. No bean de página, o componente é representado por um objeto PropertySheet.
Aparência
description. Tipo: String
Uma descrição da tarefa que está sendo monitorada.
failedStateText. Tipo: String
Texto a ser exibido se a tarefa falhar. Um ícone padrão é exibido com o texto.
height. Tipo: int
Altura da imagem da barra de progresso em pixels. O tamanho padrão é 14 pixels.
logMessage.Tipo: String
Uma mensagem a ser exibida em uma área do texto na parte inferior do componente.
progress.Tipo: int
Um número que indica a porcentagem total da tarefa que foi concluída. Vincular esta propriedade a um objeto que produz os dados inteiros necessários.
progressImageUrl.Tipo: String
O URL para uma imagem que será usada para indicar o progresso em vez da barra de progresso animada padrão.
refreshRate.Tipo: int
O intervalo em milessegundos entre as atualizações da imagem da barra de progresso.
status.Tipo: String
Texto a ser exibido na parte inferior do componente que indica o status atual da tarefa. Por exemplo, o status poderia ser uma string indicando a porcentagem de trabalho concluída ou o tempo que resta.
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.
Se você adicionar uma classe de estilo CSS a partir do tema atual ao arquivo CSS do projeto e redefinir a classe do estilo, a alteração afetará todos os componentes que usam essa classe de estilo. Entretanto, é possível adicionar suas próprias classes de estilo ao arquivo CSS do projeto que redefine as classes de estilo padrão e, em seguida, quando você adicionar as classes a esta propriedade, as alterações afetarão somente a instância deste componente.
width.Tipo: int
Larguras da imagem da barra de progresso em pixels.
Comportamento
toolTip. Tipo: String
Renderizado como o atributo HTML title do componente, que pode ser lido por um leitor de tela e exibido como uma dica de ferramenta quando o usuário passa o cursor do mouse sobre o componente.
Se o componente não estiver visível, 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
tabIndex. Tipo: String
Especifica opcionalmente a posição do componente na ordem das guias do documento, determinando quando o componente 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>.
Avançado
overlayAnimation. Tipo: booleano
Se for selecionada, o número do percentual de conclusão da propriedade progress será sobreposto à animação da barra de progresso. Se não for selecionada, esse número é exibido em uma linha abaixo da barra de progresso.Essa técnica é útil quando o espaço é limitado.
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, a barra de progresso não aparecerá na página, nem mesmo como um componente oculto.
taskState. Tipo: String
Uma string que representa o estado atual da tarefa associada a esta barra de progresso. Você pode clicar na lista suspensa ao lado da propriedade para selecionar um valor. O valor padrão é not_started. Se você não definir esta propriedade, o componente a definirá automaticamente como running se o valor do atributo progress for menor que 100 e maior que 0, e como completed se o valor for 100.
type. Tipo: booleano
O tipo geral da barra de progresso. Os tipos são os seguintes:
Determinar. Uma barra horizontal animada usada para mostrar a porcentagem concluída da tarefa.
Indeterminado. Uma barra horizontal animada usada para mostrar somente que uma tarefa está em andamento quando não é possível determinar a porcentagem concluída da tarefa.
Ocupado. Uma pequena animação usada onde o espaço é limitado para indicar a atividade de uma tarefa quando não é possível determinar a porcentagem concluída da tarefa.