Dom HTML : Objet Select.add

La méthode javascript add

Définition

La méthode javascript add(newoption, optionapres) de l'objet Select du Document Object Model HTML (DOM HTML) permet d'insérer une option à une balise HTML ou XHTML SELECT.

Paramètres de add

Paramètre

La méthode javascript add(newoption, optionapres) de l'objet Select du Document Object Model HTML (DOM HTML) accepte comme paramètres :
- newoption, valeur de type objet Option qui correspond à la nouvelle option.
- optionapres valeur de type objet Option qui correspond à l'option après laquelle on va insérer newoption. Si omise, newoption sera mise en fin de liste.

Internet Explorer

Attention pour Internet Explorer < 8 .
optionapres est de type Number, comprise entre 0 et Select-length-1. Elle correspond à l'index de l'option après laquelle on va insérer "newoption".

Valeur retournée de add

Valeur retournée

La méthode javascript add() de l'objet Select du Document Object Model HTML (DOM HTML) ne renvoie rien.

Exceptions de add

Exception

La méthode javascript add(newoption, optionapres) de l'objet Select du Document Object Model HTML (DOM HTML) renvoie comme exception :
- NOT_FOUND_ERR, si "optionapres" n'existe pas.

Dans le Dom Level 1, la méthode javascript add() de l'objet Select du Document Object Model HTML (DOM HTML) ne renvoie aucune exception.

Exemples de add

Exemple

Code HTML :
Exemple de code :
<form name="monform">
  <select id="select" size="5" >
    <option>Option 1</option>
    <option>Option 2</option>
  </select>
<button type="button" onclick="select_add(false)"> Cliquer pour tester select.add() </button>
<button type="button" onclick="select_add(true)"> Cliquer pour lancer Exception </button>
</form>

Code javscript :
Exemple de code :
function select_add(bError){
  var oSelect= document.getElementById("select");
  var oOption = document.createElement("option");
  oOption.text = "Nouveau text" ;
  oOption.value = "Nouvelle value";
  var oOptionBefore = bError? oSelect : oSelect.options[0];
  if(oSelect.disabled == true){bAction = false;}
  try{
    oSelect.add( oOption, oOptionBefore );
  }catch (e) {
    alert('Oups!');
  }
}

La balise HTML et XHTML SELECT contient une liste d'options. La balise HTML et XHTML SELECT permet de créer un menu déroulant dans un formulaire.<SELE...[Voir]