フォームプロパティとメソッド

フォームや <input> のようなコントロール要素は多くの特別なプロパティやイベントを持っています。

それらを知っていると、フォームを使った作業がはるかに便利になります。

ナビゲーション: フォームと要素

ドキュメントフォームは特別な集合 document.forms のメンバです。

それは 名付けされた 集合で、名前と数字の両方を使ってフォームを取得することができます。

          document.forms.my - name="my" のフォーム
document.forms[0] - ドキュメント中の最初のフォーム
        

フォームをもつと、名前付けされた集合 forms.elements で、任意の要素が利用可能です。

例:

<form name="my">
  <input name="one" value="1">
  <input name="two" value="2">
</form>

<script>
  // フォーム取得
  let form = document.forms.my; // <form name="my"> element

  // 要素取得
  let elem = form.elements.one; // <input name="one"> element

  alert(elem.value); // 1
</script>

同じ名前で複数の要素がある可能性があり、それはラジオボタンの場合がよくあります。

この場合、form.elements[name] は集合です、例えば:

<form>
  <input type="radio" name="age" value="10">
  <input type="radio" name="age" value="20">
</form>

<script>
let form = document.forms[0];

let ageElems = form.elements.age;

alert(ageElems[0].value); // 10, 1つ目の input の値
</script>

これらのナビゲーションプロパティはタグ構造には依存しません。すべての要素はフォーム中での深さに関係なく form.elements で利用可能です。

フォームは１つ以上の <fieldset> 要素をその中にもっている場合があります。それらも elements プロパティでサポートされています。

例:

<body>
  <form id="form">
    <fieldset name="userFields">
      <legend>info</legend>
      <input name="login" type="text">
    </fieldset>
  </form>

  <script>
    alert(form.elements.login); // <input name="login">

    let fieldset = form.elements.userFields;
    alert(fieldset); // HTMLFieldSetElement

    // フォームとフィールドセット両方から input を取得することができます
    alert(fieldset.elements.login == form.elements.login); // true
  </script>
</body>

より短い記法があります: form[index/name] で要素にアクセスすることができます。

form.elements.login の代わりに、form.login と書けます。

これも動作しますが、小さな問題があります: もし要素にアクセスし、その後でその name を変えた場合、依然として古い名前で利用可能です(新しい名前と同様に)。

例で簡単に見れます:

<form id="form">
  <input name="login">
</form>

<script>
  alert(form.elements.login == form.login); // true, 同じ <input>

  form.login.name = "username"; // input の名前を変更

  // form.elements は name を更新:
  alert(form.elements.login); // undefined
  alert(form.elements.username); // input

  // 直アクセスは両方の名前が使用可能
  alert(form.username == form.login); // true
</script>

これは通常は問題ではありません。なぜならフォーム要素の名前を変えることは殆どないからです。

後方参照: element.form

任意の要素に対して、フォームは element.form として利用可能です。そのため、フォームはすべての要素を参照し、要素はフォームを参照します。

これはその図です:

例:

<form id="form">
  <input type="text" name="login">
</form>

<script>
  // form -> element
  let login = form.login;

  // element -> form
  alert(login.form); // HTMLFormElement
</script>

フォーム要素

それぞれの機能に注意を払いながら、フォームコントロールについて話しましょう。

input と textarea

通常、チェックボックスに対しては input.value または input.checked で値にアクセスできます。

このように:

          input.value = "New value";
textarea.value = "New text";

input.checked = true; // チェックボックスやラジオボタンの場合
        

決して textarea.innerHTML は使わないよう注意してください。それは現在の値ではなく、ページの初期時点の HTML のみを保持しています。

select と option

<select> 要素は3つの重要なプロパティを持っています:

select.options – <option> 要素の集合です,
select.value – 選ばれた選択肢の値です,
select.selectedIndex – 選ばれた選択肢の番号です.

従って、 <select> の値を設定するのに 3つの方法があります。:

必要な <option> を見つけて、option.selected を true に設定する.
select.value に値を設定する。
select.selectedIndex に option の番号を設定する。

最初の方法が最も明白ですが、(2) と (3) は通常はより便利です。

例:

<select id="select">
  <option value="apple">Apple</option>
  <option value="pear">Pear</option>
  <option value="banana">Banana</option>
</select>

<script>
  // この３行はすべて同じことをしています
  select.options[2].selected = true;
  select.selectedIndex = 2;
  select.value = 'banana';
</script>

他のコントロールとは違い、<select multiple> は複数の選択を許可します。この場合、すべての選択された値を取得するには、select.options を参照する必要があります。

次のようになります:

<select id="select" multiple>
  <option value="blues" selected>Blues</option>
  <option value="rock" selected>Rock</option>
  <option value="classic">Classic</option>
</select>

<script>
  // get all selected values from multi-select
  let selected = Array.from(select.options)
    .filter(option => option.selected)
    .map(option => option.value);

  alert(selected); // blues,rock
</script>

<select> 要素の完全な仕様は https://html.spec.whatwg.org/multipage/forms.html#the-select-element にあります。

new Option

option 要素には、<option> 要素を作成するための簡単でナイスな構文があります。:

option = new Option(text, value, defaultSelected, selected);

パラメータ:

text – option 内のテキスト,
value – option の値,
defaultSelected – true の場合、selected 属性が作られます,
selected – true の場合、 option が選択されます.

例:

          let option = new Option("Text", "value");
// creates <option value="value">Text</option>
        

選択された同じ要素です:

let option = new Option("Text", "value", true, true);

Option 要素は追加のプロパティを持っています:

selected: 選択されているか.
index: その <select> の中で何番目の option であるか
text: option のテキストコンテンツ

サマリ

フォームのナビゲーション:

document.forms: フォームは document.forms[name/index] で利用可能です。
form.elements: フォーム要素は form.elements[name/index] または単に form[name/index] で利用可能です。elements プロパティは <fieldset> に対しても機能します。
element.form: 要素は form プロパティでフォームを参照します。

値は input.value, textarea.value, select.value など、もしくはチェックボックスやラジオボタンに対しては input.checked として利用可能です。

<select> の場合、インデックス select.selectedIndex や、選択肢の集合 select.options を通じて値を取得することもできます。これや他の要素の完全な仕様は https://html.spec.whatwg.org/multipage/forms.html にあります。

これらはフォームを使って作業を始めるための基本です。次のチャプターでは、どの要素でも発生する可能性のある focus イベントと blur イベントについて説明しますが、ほとんどはフォームで処理されます。