База знанияИзпитен център
BGБългарски
Избери език13

CKTIS / HTML

formenctype — формат на данните за конкретен бутон за изпращане

Атрибутът formenctype позволява на бутон за изпращане да замени enctype на формуляра. Той избира формата на данните в POST заявката само когато формулярът се изпраща с този бутон.

Версия: WHATWG HTML Living Standard; index snapshot date recorded separately

Синтаксис

formenctype="application/x-www-form-urlencoded|multipart/form-data|text/plain"

formenctype указва формата на данните, използван от конкретен бутон за изпращане на формуляр. Прилага се за button, който служи като бутон за изпращане, и за input с type="submit" или type="image". При button е полезно изрично да зададете type="submit". Замяната важи само за изпращане чрез този бутон; тя не променя атрибута enctype на формуляра.

Допустимите стойности са application/x-www-form-urlencoded (кодирани с проценти двойки име–стойност), multipart/form-data (отделни части, които могат да пренасят съдържание на файлове) и text/plain (четим, но двусмислен формат, неподходящ за надеждно обработване).

Ако formenctype липсва, се използва enctype на свързания формуляр. Празна или невалидна стойност вместо това избира application/x-www-form-urlencoded, а не настройката на формуляра. Ако и формулярът не задава enctype, форматът му по подразбиране е application/x-www-form-urlencoded.

При изпращане по HTTP този формат определя тялото на заявката POST; той не променя метода на POST. При GET данните се поставят в URL с application/x-www-form-urlencoded, независимо от formenctype. В JavaScript отразяващото свойство се нарича formEnctype. Примерът отменя изпращането и показва избрания формат, без да изпраща заявка.

Примери

<!doctype html>
<html lang="en">
<meta charset="utf-8">
<title>formenctype demo</title>
<form id="demo" method="post" enctype="application/x-www-form-urlencoded">
  <input name="message" value="hello world" aria-label="Message">
  <button type="submit">Default</button>
  <button type="submit" formenctype="multipart/form-data">Multipart</button>
</form>
<pre id="result"></pre>
<script>
  const form = document.getElementById('demo');
  const result = document.getElementById('result');
  form.addEventListener('submit', (event) => {
    event.preventDefault();
    const button = event.submitter;
    result.textContent = button && button.hasAttribute('formenctype')
      ? button.formEnctype
      : form.enctype;
  });
</script>
</html>

Резултат

Clicking Default displays only `application/x-www-form-urlencoded`. Clicking Multipart displays only `multipart/form-data`. Each click replaces the previous result.

Показаният код и заявеният резултат са проверени в изолирана среда по метода, записан в доказателството за проверка на тази точна версия.

Източници