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

CKTIS / HTML

form — HTML формуляр

Елементът form свързва контролите с формуляр и определя как се изпращат данните им. Поддържа стандартно изпращане и проверка; JavaScript може да прихване изпращането.

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

Синтаксис

<form action="/search" method="get">…</form>

form представя формуляр, чиито контроли могат да предоставят данни за обработка. Необходими са както отварящият, така и затварящият таг; формулярите не трябва да се влагат един в друг. Поддържаните контроли извън формуляра могат да се свържат с него чрез атрибут form, който сочи към неговия id.

action указва целта. method="get" (стойността по подразбиране) поставя данните в заявката на URL адреса, докато method="post" ги поставя в тялото на заявката. За качване на файлове с POST използвайте enctype="multipart/form-data". Сам по себе си POST не осигурява криптиране.

Ключовете на данните идват от name, а не от id. Деактивираните контроли и квадратчетата без отметка се пропускат. Контролите без име обикновено се пропускат, но ако формулярът се изпрати чрез бутон за изпращане с изображение (<input type="image">) без име, бутонът добавя към данните координатите с ключове x и y. Свързвайте етикетите с полетата. Проверката в браузъра помага на потребителите, но не замества проверката на сървъра.

При обикновено изпращане интерактивната проверка се извършва преди задействането на събитието submit, освен ако проверката не е пропусната. Ако проверката установи невалидни данни, изпращането се прекратява и събитието submit не се задейства. Атрибутът novalidate позволява да се пропусне интерактивната проверка. В скриптове предпочитайте requestSubmit(): за разлика от submit(), той запазва проверката и събитието submit.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>HTML form example</title>
</head>
<body>
  <form id="search" method="get">
    <label for="query">Query</label>
    <input id="query" name="q" value="html" required>
    <button id="submit-query" type="submit">Submit query</button>
  </form>
  <output id="result" for="query" aria-live="polite"></output>
  <script>
    const form = document.getElementById('search');
    const submitButton = document.getElementById('submit-query');
    const result = document.getElementById('result');

    form.addEventListener('submit', (event) => {
      event.preventDefault();
      const data = new FormData(form);
      result.value = 'q=' + data.get('q');
      console.log(result.value);
    });

    form.requestSubmit(submitButton);
  </script>
</body>
</html>

Резултат

q=html

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

Източници