Componente Calendário do JSF 1.2
Consulte também
Você pode arrastar o componente Calendário
da categoria Fundamentos do Woodstock da Paleta para uma página aberta no Visual Designer, de modo a criar um campo de entrada com um pop-up de calendário integrado para ajudar o usuário a selecionar datas para o campo.
-
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:calendar.
Você pode soltar o calendário em um componente de recipiente, como a célula de uma tabela ou uma caixa de grupo.
Depois de arrastar o componente para o Visual Designer, você pode:
- Selecionar o componente e editar suas propriedades na janela Propriedades do Calendário. Algumas propriedades típicas que você pode definir são:
- id O nome do componente Calendário. No arquivo JSP, este nome é o valor do atributo
id do componente. No bean de página, o valor desta propriedade é o nome do objeto Calendar.
- colunas. Esta propriedade determina a largura do campo de texto do calendário.
- label. O texto do rótulo exibido com o componente, se houver.
- 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.
- minDate, maxDate. Especifica as datas mínimas e máximas que o usuário pode definir no calendário. Valores padrão:
- maxDate.100 anos depois do valor da propriedade
selectedDate ou 100 anos depois da data atual se tal propriedade não for definida.
- minDate.100 anos antes do valor da propriedade
selectedDate ou 100 anos antes da data atual se tal propriedade não for definida.
- labelLevel. 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
label estiver definida.
- imageURL. Especifica um arquivo de imagem que será exibido com o calendário.
- Clique com o botão direito do mouse no componente e escolha um dos seguintes itens no menu pop-up:
- Editar manipulador de eventos. Escreve o código de um dos manipuladores de eventos a seguir.
- validate. Abre o Editor de Java com o cursor posicionado no método
validate do componente para que você possa inserir o código para validar o valor do componente.
- processValueChange.Abre o Editor Java com o cursor posicionado no método
processValueChange do componente para que você possa inserir o código que é executado quando o valor deste componente sofrer alterações (por exemplo, quando o usuário altera o valor de outro componente que esteja controlando o valor deste componente).
- Definir foco inicial. Coloca o foco neste componente quando o usuário abre a página.
- Enviar automaticamente ao alterar Faz com que o formulário seja enviado automaticamente se o valor do componente sofrer alterações. Define a propriedade
onclick de JavaScript do componente para common_timeoutSubmitForm(this.form, 'id-do-componente');. Em tempo de execução, este código faz com que o formulário seja enviado automaticamente se o usuário alterar o valor do componente. Depois de o formulário ter sido enviado, ocorre a conversão e a validação no servidor, quaisquer métodos ouvintes de alteração de valor são executados e, em seguida, a página é reexibida.
Um componente configurado como Enviar automaticamente ao alterar pode usar formulários virtuais para limitar os campos de entrada processados quando o formulário é enviado. Se o componente de envio automático for definido para enviar um formulário virtual, somente os participantes de tal formulário virtual serão processados quando o envio automático ocorrer.
- Vincular aos dados. Abre a caixa de diálogo que permite vincular a propriedade
selectedDate a um objeto ou a um provedor de dados para que você possa avaliar os dados que o usuário escolhe depois que a página é enviada. Para obter mais informações sobre o uso desta caixa de diálogos, consulte Caixa de diálogo Vincular aos dados.
- Vinculações de propriedade. Abre a caixa de diálogo que permite vincular as propriedades dos componentes, além da propriedade
selectedDate, a outros objetos ou beans de propriedades que atualizam automaticamente estas propriedades do componente.
- Adicionar atributo de vinculação. Essa opção adiciona um atributo de vinculação ao componente
- Observação: se você planeja fazer o script do componente em código Java, deve adicionar um atributo de vinculação manualmente, que é vinculado usando uma expressão vinculadora de valor a uma propriedade do bean da página de backup.
- Remover atributo de vinculação Essa opção remove o atributo de vinculação do componente.
- Configurar formulários virtuais. Permite adicionar o componente a um formulário virtual.
- Visualizar no navegador. Veja como a página é renderizada no navegador da Web padrão no seu sistema.
- Consulte também
- Vinculando propriedades do componente
- Trabalhando com componentes
- Tarefas de componente: referência rápida
- Sobre a Paleta do Visual Web
Notificações legais