Coleção Select options

Objeto Select do HTML DOM

Definição e uso

options A coleção retorna todos os itens da lista suspensa Elemento <option> da coleção.

Observação:Os elementos da coleção são ordenados pela ordem em que aparecem no código-fonte.

Exemplo

Exemplo 1

Ver quantas opções há em uma lista suspensa específica:

var x = document.getElementById("mySelect").options.length;

Experimente pessoalmente

O resultado de x será:

4

Dica:Mais exemplos estão disponíveis na parte inferior da página.

Sintaxe

selectObject.options

Propriedade

Propriedade Descrição
length

Retornar o número de elementos <option> na coleção.

Observação:Esta propriedade é apenas de leitura
selectedIndex Definir ou retornar o índice do elemento <option> selecionado na coleção (começando em 0).

Método

Método Descrição
[index]

Retornar o elemento <option> com o índice especificado (começando em 0) da coleção.

Observação:Se o número de índice estiver fora do intervalo, retorna null.
[add(option[,index)] Adicionar o elemento <option> na posição especificada na coleção. Se não for especificado o índice, a opção será inserida no final da coleção.
item(index)

Retornar o elemento <option> com o índice especificado (começando em 0) da coleção.

Observação:Se o número de índice estiver fora do intervalo, retorna null.
namedItem(id)

Retornar o elemento <option> com o ID especificado da coleção.

Observação:Se id Se não existir, retorna null.
remove(index) Remover o elemento <option> com o índice especificado da coleção.

Detalhes técnicos

Versão DOM: Nível 2 de Document Object Core
Retorno:

Objeto HTMLOptionsCollection, que representa todos os elementos <option> do elemento <select>.

Os elementos da coleção são ordenados pela ordem em que aparecem no código-fonte.

Mais exemplos

Exemplo 2: [index]

Obter o texto da primeira opção na lista suspensa (índice 0):

var x = document.getElementById("mySelect").options[0].text;

Experimente pessoalmente

O resultado de x será:

Apple

Exemplo 3: item(index)

Obter o texto da primeira opção na lista suspensa (índice 0):

var x = document.getElementById("mySelect").options.item(0).text;

Experimente pessoalmente

O resultado de x será:

Apple

Exemplo 4: namedItem(id)

Obter o texto da opção com id="orange" na lista suspensa:

var x = document.getElementById("mySelect").options.namedItem("orange").text;

Experimente pessoalmente

O resultado de x será:

Orange

Exemplo 5

Adicionar a opção "Kiwi" na posição de índice da lista suspensa "1":

var x = document.getElementById("mySelect");
var c = document.createElement("option");
c.text = "Kiwi";
x.options.add(c, 1);

Experimente pessoalmente

Exemplo 6

Remova a opção com índice "1" da lista suspensa:

var x = document.getElementById("mySelect"); x.options.remove(1);

Experimente pessoalmente

Exemplo 7

Percorra todas as opções da lista suspensa e exiba o texto de cada opção:

var x = document.getElementById("mySelect");
var txt = "";
var i;
for (i = 0; i < x.length; i++) {
  txt = txt + x.options[i].text + "<br>";
}

Experimente pessoalmente

O resultado de x será:

Apple
Orange
Pineapple
Banana

Exemplo 8

Selecione uma opção na lista suspensa e exiba o texto da opção selecionada no elemento com id="demo":

var x = document.getElementById("mySelect");
var i = x.selectedIndex;
document.getElementById("demo").innerHTML = x.options[i].text;

Experimente pessoalmente

O resultado de x será:

Banana

Exemplo 9

Altere as opções da lista suspensa com base na seleção de outra lista suspensa:

var carsAndModels = {};
carsAndModels['VO'] = ['V70', 'XC60', 'XC90'];
carsAndModels['VW'] = ['Golf', 'Polo', 'Scirocco', 'Touareg'];
carsAndModels['BMW'] = ['M6', 'X5', 'Z3'];
function ChangeCarList() {
  var carList = document.getElementById("car");
  var modelList = document.getElementById("carmodel");
  var selCar = carList.options[carList.selectedIndex].value;
  while (modelList.options.length) {
    modelList.remove(0);
  }
  var cars = carsAndModels[selCar];
  if (cars) {
    var i;
    for (i = 0; i < cars.length; i++) {
      var car = new Option(cars[i], i);
      modelList.options.add(car);
    }
  }
}

Experimente pessoalmente

Suporte do navegador Coleção options Yes Yes Yes Yes Yes

Objeto Select do HTML DOM