GlobalEventHandlers.onformdata

onformdata は GlobalEventHandlers ミックスインのプロパティで、フォームのデータを表す項目リストが構築された後に発行される formdata イベントを処理するイベントハンドラー (EventHandler) です。これはフォームが送信されたときに発生しますが、 FormData() コンストラクターを呼び出しても発行することができます。 onformdata は HTMLFormElement で利用できます。

構文

target.onclick = functionRef;

値

functionRef は関数名または 関数式です。この関数は唯一の引数として FormDataEvent オブジェクトを受け取ります。

例

// grab reference to form

const formElem = document.querySelector('form');

// submit handler

formElem.addEventListener('submit', (e) => {
  // on form submission, prevent default
  e.preventDefault();
 
  // construct a FormData object, which fires the formdata event
  new FormData(formElem);
});

// formdata handler to retrieve data

formElem.onformdata = (e) => {
  console.log('formdata fired');
 
  // Get the form data from the event object
  let data = e.formData;
  for (var value of data.values()) {
    console.log(value);
  }
 
  // submit the data via XHR
  var request = new XMLHttpRequest();
  request.open("POST", "/formHandler");
  request.send(data);
};

仕様書

ブラウザーの互換性

関連情報

• formdata イベント
• FormDataEvent
• FormData オブジェクトの使用