Componente Calendário do JSF 1.1
Consulte também
Você pode arrastar o componente Calendário
da categoria Básico da Paleta para uma página aberta no Visual Designer para criar um campo de entrada com um pop-up de calendário integrado a fim de ajudar o usuário a selecionar datas para o campo.
-
Este é um componente JavaServer Faces 1.1. Você vê os componentes que usam essa
versão do JavaServer Faces quando o seu projeto usa J2EE 1.4 ou J2EE 1.3.
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. Os valores padrão são o ano atual e quatro anos a partir do ano atual, para um intervalo total de cinco anos.
- 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 do rótulo for 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çãoEssa opção remove o atributo de vinculação do componente.
- Configurar formulários virtuais. Permite adicionar o componente a um formulário virtual.
- Alinhar. Se houver vários componentes selecionados, você pode especificar como eles serão alinhados um em relação ao outro. Se somente o componente atual estiver selecionado, você pode decidir se o componente se alinhará (se colocará junto) à grade de fundo quando for movido.
- 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