Componente Lista suspensa do JSF 1.1

Consulte também

Você pode arrastar o componente Lista suspensa ícone de Lista suspensa da Paleta para o Visual Designer para criar uma Lista suspensa (ou caixa de combinação) que permite ao usuário clicar em um botão e selecionar itens na lista.

Uma Lista suspensa é uma lista de itens que é exibida inicialmente como um único item e, quando clicada, exibe uma lista de vários itens. É possível selecionar apenas um item por vez. As listas suspensas são semelhantes às caixas de combinação no Java Swing e no Microsoft Windows, e são denominadas listas de seleção em HTML.

Você pode definir a propriedade items para associar o componente a uma tabela de banco de dados ou a uma matriz, um java.util.Collection ou um java.util.Map de objetos com.sun.rave.web.ui.model.Option para preencher a lista. Clique com o botão direito do mouse no componente e escolha Vincular aos dados para definir esta propriedade. Na janela Navegador,  é possível visualizar o objeto padrão que preenche a lista, que possui um nome semelhante a dropDown1DefaultOptions. Para obter mais informações sobre a configuração padrão desta propriedade, consulte Exibição padrão de itens suspensos mais adiante neste tópico.

Use a propriedade selected para associar um componente a um objeto de modelo que representa a escolha atual, definindo o valor de uma expressão que corresponda a uma propriedade de um bean gerenciado. Você pode clicar com o botão direito do mouse no componente e escolher Vinculações de propriedade para vincular a propriedade selected.

Na primeira vez que o componente é renderizado, a opção que corresponde ao valor da propriedade do objeto de modelo selected é marcada como selecionada usando os mesmos métodos no objeto de modelo.

Abaixo se encontram algumas ações que podem ser realizadas com este componente:

Exibição padrão de itens suspensos

Por padrão, uma lista suspensa exibe seus itens de lista usando um objeto de tipo SingleSelectOptionsList com um nome baseado no ID de componente padrão. Por exemplo, a primeira lista suspensa que você solta em uma página é inicialmente chamada dropDown1 e possui uma matriz dropDown1DefaultOptions associada a ela que você pode ver na janela Navegador.

Você pode definir os valores deste objeto matriz clicando com o botão direito do mouse no componente Lista suspensa e escolhendo Configurar opções padrão para abrir a caixa de diálogo Personalizador de opções. Nesta caixa de diálogo você pode adicionar novos itens ou excluir itens existentes, pode definir o valor exibido (Exibição) e o valor do item (Valor) e pode selecionar que item será exibido por padrão (Selecionado). O objeto dropDown#DefaultOptions é uma matriz que armazena os valores de exibição nos campos label e os valores de Valor nos campos value.

O código de amostra seguinte ilustra como você pode usar este objeto e a propriedade select da lista suspensa para determinar que item está selecionado atualmente e escrever os valores de Exibição e Valor, label e value, em dois campos de texto estático para exibição. Se adicionar uma lista suspensa e dois componentes de texto estático à página e, em seguida, colocar este código no método processValueChange da lista suspensa, conforme descrito acima, e selecionar Enviar automaticamente ao alterar para o componente, quando o usuário selecionar um item na lista, os valores de Exibição e Valor serão exibidos nos dois campos de texto estático.

   String myvalue = (String)dropDown.getSelected();1
int numOptions = dropDown1DefaultOptions.getOptions().length;
int i = 0;
for (i = 0; i < numOptions; i++) {
if (myvalue.equals(dropDown1DefaultOptions.getOptions()[i].getValue()))
break;
}
if (i < numOptions) {
staticText1.setText(dropDown1DefaultOptions.getOptions()[i].getLabel());
staticText2.setText(dropDown1DefaultOptions.getOptions()[i].getValue());
} else {
staticText1.setText("not found"); // should not get here
}
Consulte também
Janela Propriedades de Lista suspensa
Vinculando propriedades do componente
Trabalhando com componentes
Tarefas de componente: referência rápida
Sobre a Paleta do Visual Web

Notificações legais