Baza znanjaIzpitno središče
SLSlovenščina
Izberi jezik13

CKTIS / HTML

form — obrazec HTML

Element form poveže kontrolnike z obrazcem in določi, kako se njihovi podatki pošljejo. Podpira izvorno pošiljanje in preverjanje; JavaScript lahko pošiljanje prestreže.

Različica: WHATWG HTML Living Standard; index snapshot date recorded separately

Sintaksa

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

form predstavlja obrazec, katerega kontrolniki lahko zagotovijo podatke za obdelavo. Potrebni sta začetna in končna oznaka; obrazci ne smejo biti vgnezdeni. Podprte kontrolnike zunaj obrazca lahko povežete z njim prek atributa form, ki se sklicuje na njegov id.

action določa cilj. method="get" (privzeta vrednost) podatke doda poizvedbi URL-ja, method="post" pa jih umesti v telo zahteve. Za nalaganje datotek z metodo POST uporabite enctype="multipart/form-data". Sama metoda POST ne zagotavlja šifriranja.

Ključi podatkov izvirajo iz name, ne iz id. Onemogočeni kontrolniki in neoznačena potrditvena polja se izpustijo. Kontrolniki brez imena se praviloma izpustijo, če pa obrazec pošljete s slikovnim gumbom za pošiljanje (<input type="image">) brez imena, ta podatkom doda koordinati s ključema x in y. Oznake povežite s polji. Preverjanje v brskalniku pomaga uporabnikom, vendar ne nadomesti preverjanja na strežniku.

Pri običajnem pošiljanju se interaktivno preverjanje izvede pred sprožitvijo dogodka submit, razen če se preverjanje preskoči. Če preverjanje ne uspe, se pošiljanje ustavi in dogodek submit se ne sproži. Atribut novalidate omogoča, da se interaktivno preverjanje preskoči. V skriptih raje uporabite requestSubmit(): v nasprotju z submit() ohrani preverjanje in dogodek submit.

Primeri

<!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>

Rezultat

q=html

Prikazana koda in navedeni rezultat sta bila preverjena v izoliranem okolju z metodo, zapisano v dokazilu o preverjanju te natančne različice.

Viri