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

CKTIS / HTML

formtarget — къде се показва резултатът от изпращането на формуляр

Атрибутът formtarget указва къде да се зареди резултатът от изпращането на формуляр, задействано от конкретен бутон. За това изпращане той заменя target на формуляра и позволява използването на текущия раздел, нов прозорец или раздел, или рамка с име.

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

Синтаксис

formtarget="_self|_blank|_parent|_top|target-name"

formtarget задава навигационната цел при изпращане на формуляр. Прилага се към бутоните за изпращане: button с тип submit и input с тип submit или image. Не е атрибут на елемента form или на обикновено текстово поле.

Стойността на бутона, използван за изпращане, има предимство пред target на свързания формуляр. Ако formtarget липсва, формулярът определя целта. Атрибутът не променя URL адреса на заявката, метода или данните; formaction заменя URL адреса, а formmethod — метода.

Стойността е валидно име на цел или ключова дума. _self означава текущия контекст, _blank — нов контекст от най-високо ниво, обикновено раздел или прозорец, _parent — родителския контекст, а _top — най-горния контекст. Ако няма родителски контекст, _parent и _top действат като _self. Име като preview може да избере iframe със съответстващ name; само id не е достатъчен. Това е атрибут със стойност низ, а не булев атрибут.

Отворете demo.html чрез локален HTTP сървър; не е необходим код от страна на сървъра. Скриптът автоматично извиква requestSubmit() за всеки бутон. Standard използва зададената във формуляра цел _self (текущата страница), а при Preview настройката formtarget="preview" има предимство пред target="_self" и избира рамката iframe с това име. Обработчикът на събитието submit извиква preventDefault(), така че нито един от двата бутона не изпраща формуляра и не предизвиква навигация. Конзолата показва избраните цели, а не зареден резултат.

Примери

<!doctype html>
<html lang="en">
<head>
  <meta charset="utf-8">
  <title>Button-specific form target</title>
</head>
<body>
  <h1>Choose a form target</h1>
  <form id="example" action="#result" target="_self">
    <button type="submit">Standard</button>
    <button type="submit" formtarget="preview">Preview</button>
  </form>
  <p id="result">Local destination for this example.</p>
  <iframe id="preview-frame" name="preview" title="Local preview" srcdoc="<p>Local preview frame.</p>"></iframe>
  <script>
    const form = document.getElementById('example');
    const frame = document.getElementById('preview-frame');
    form.addEventListener('submit', event => {
      event.preventDefault();
      const button = event.submitter;
      const target = button.hasAttribute('formtarget') ? button.formTarget : form.target;
      const destination = target === '_self' ? 'current page' :
        window.frames[target] === frame.contentWindow ? 'named iframe' : 'unmatched target';
      console.log(`${button.textContent}: ${target} (${destination})`);
    });
    for (const button of form.querySelectorAll('button')) {
      form.requestSubmit(button);
    }
  </script>
</body>
</html>

Резултат

Standard: _self (current page)
Preview: preview (named iframe)

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

Източници