Você vê a janela Propriedades de um componente Calendário quando seleciona o componente em uma página que está editando no Visual Designer.
A maioria das propriedades do componente Calendário são atributos JSP e as propriedades do componente Java Calendário no bean de página.
Este componente possui as propriedades a seguir.
Geral
id. Tipo: String
O nome do componente Calendário no bean de página e o arquivo JSP.
Aparência
columns. Tipo: int
O número de colunas de caracteres usado para renderizar o componente. O valor padrão é 20.
dateFormatPattern. Tipo: String
O formato da data a ser inserida pelo usuário. Geralmente não é necessário definir esta propriedade porque um padrão é escolhido automaticamente com base na localidade.
Se preferir especificar um formato de data, clique no botão de reticências (...) à direita da propriedade e selecione um formato de data predefinido na lista do editor de propriedade. Você também pode adicionar seus próprios formatos. Se adicionar um formato, os valores inseridos ficarão limitados a alguma combinação de yyyy para o ano, MM para o mês e dd para o dia separados por caracteres separadores. Os caracteres separadores típicos são / (barra), . (ponto) e - (traço). Por exemplo, os formatos de data a seguir são aceitáveis:
MM/dd/yyyy
yyyy.MM.dd
MM-dd-yyyy
dateFormatPatternHelp. Tipo: texto
O texto que aparece abaixo do campo de entrada de data e mostra o padrão de formato que o campo de entrada de data aceita. Se você não definiu a propriedade dateFormatPattern, o texto da ajuda será escolhido automaticamente para você. Se você definiu a propriedade dateFormatPattern, vincule a propriedade dateFormatPatternHelp a uma string localizada que coincida com a configuração de cada localidade que deseja aceitar.
label. Tipo: String
Um rótulo que aparece ao lado do campo de entrada de texto, geralmente descrevendo o que o usuário deve inserir.
A propriedade label não é tão flexível quanto o componente Rótulo. Você pode usar o componente Rótulo se quiser ter mais controle sobre a aparência do rótulo, tal como o seu posicionamento em relação ao componente.
labelLevel. Tipo: int
Um número que afeta a aparência do rótulo. 1 (Forte) é grande e em negrito. 2 (Médio), o padrão, é menor e em negrito. 3 (Fraco), é menor e normal (não está em negrito). Esta propriedade tem efeito somente se a propriedade do rótulo for definida.
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.
maxDate. Tipo: java.util.Date
A última data que o usuário pode selecionar. O valor padrão é quatro anos a partir da data definida na propriedade minDate, de um intervalo total de cinco anos.
minDate. Tipo: java.util.Date
A primeira data que o usuário pode selecionar. O valor padrão é o da propriedade selectedDate, que define padrões para a data atual se tal propriedade não estiver definida.
required. Tipo: booleano
Se for selecionada, o usuário deverá inserir um valor para o calendário antes que a página seja enviada. Se você adicionar um componente Mensagem na página e vincular sua propriedade for a este componente, será exibida uma mensagem de erro se o usuário tentar enviar a página sem inserir um valor.
selectedDate. Tipo: Data
Um objeto java.util.Date que representa a data do calendário selecionada pelo usuário. Se clicar com o botão direito do mouse no componente e escolher Vincular aos dados, você poderá vincular esta propriedade a um provedor de dados ou objeto que possa processar o valor inserido pelo usuário no servidor.
Quando o componente é exibido inicialmente, se esta propriedade não estiver definida, seu valor padrão é a data atual.Se fornecer valores para minDate e maxDate, você também poderá fornecer um valor para esta propriedade que exibe inicialmente uma data nesse intervalo.
validator. Tipo: MethodBinding
Indica o validador JavaServer Faces que é chamado quando o valor é enviado. Um validador garante que o valor correto é inserido por um usuário. Escolha um validador na lista suspensa. Se você escolher (null), nenhum validador será chamado. Se você escolher um validador, selecione também a propriedade required para garantir que o validador seja usado.
Se você definir o seu próprio método de validação, por exemplo, clicando com o botão direito do mouse no componente e escolhendo Editar manipulador de eventos > validar, qualquer validador que você tenha definido nesta propriedade será sobrescrito.
Eventos
Defina as propriedades do evento, clicando com o botão direito no mouse no Visual Designer e escolhendo Editar manipulador de eventos > nome do evento.
validate. Indica o nome do método chamado para validar o valor do componente. Se quiser codificar um método de validação, clique com o botão direito do mouse no componente na janela Navegador e escolha Editar manipulador de eventos > Validar. O nome padrão do método é id-do-componente_validate, onde id-do-componente é o valor da propriedade id do componente.
valueChangeListener Indica o nome do método ouvinte de alteração de valor do componente que é chamado quando o valor do componente é alterado. Geralmente este método é definido no bean de página, clicando com o botão direito do mouse no componente na janela Navegador e escolhendo Editar manipulador de eventos > processValueChange. O nome padrão do método é id-do-componente_processValueChange, onde id-do-componente é o valor da propriedade id.
Comportamento
disabled. Tipo: booleano
Se for selecionada, indicará que o componente nunca deverá receber o foco ou ser incluído em um envio. Use esta propriedade quando o componente não se aplicar à página. Consulte a observação abaixo da propriedade readOnly sobre os efeitos do uso da propriedade disabled em comparação ao efeito do uso da propriedade readOnly.
readOnly. Tipo: booleano
Se for selecionada, tornará impossível para o usuário inserir valores, mas ainda possibilitará o envio do valor do componente. Use esta propriedade quando o componente se aplica mas não deve ser alterado.
Um campo somente leitura é incluído quando a página é enviada, ao contrário de um campo desativado, que não é incluído quando a página é enviada. Se você usar a propriedade disabled, o JavaServer Faces não detectará que algum valor tenha sido enviado.
toolTip. Tipo: String
Define o atributo HTML title do campo de entrada de data. O valor do texto desta propriedade será exibido se o usuário passar o cursor do mouse sobre o campo de entrada.
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
tabIndex. Tipo: String
Especifica opcionalmente a posição do calendário 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.
JavaScript
onBlur. Tipo: String
JavaScript a ser executado quando o componente perde o foco.
onChange. Tipo: String
JavaScript a ser executado quando o componente perde o foco e seu valor é modificado depois de ganhar o foco.
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.
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.
onSelect. Tipo: String
JavaScript a ser executado quando o usuário seleciona texto no componente.
Avançado
immediate. Tipo: booleano
Se esta propriedade for selecionada, quando o usuário terminar de inserir uma data no calendário, o código no bean de página será executado antes da validação, atualização de valores do 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 calendário será renderizado e processado em qualquer envio de página subseqüente. Se não for selecionada, o calendário não aparecerá na página, nem mesmo como um componente oculto.
valueChangeListener. Tipo: MethodBinding
Consulte a propriedade valueChange da seção Evento acima, que fornece uma forma mais fácil de definir o valor desta propriedade. A propriedade valueChangeListener é a propriedade MethodBinding que fica abaixo da propriedade do evento valueChange. A propriedade valueChangeListener é atualizada quando você define o método da propriedade do evento valueChange.
Se você clicar no botão de reticências ao lado da propriedade valueChange, poderá usar o editor de propriedade para escolher um método existente para se vincular, ou poderá criar um novo método ou desvincular um método existente. Se você for um especialista, em vez de usar a propriedade valueChange, pode digitar uma expressão MethodBinding diretamente nesta propriedade valueChangeListener, por exemplo, se quiser chamar um método que não esteja no bean de página.