Tutorial

HTML requestSubmit ve submit: Form Doğrulamasını Korumak

Mehmet Fatih Ünal
16 Kasım 2026
7 dk okuma
#HTML#Form#requestSubmit#FormData#Erişilebilirlik
HTML requestSubmit ve submit: Form Doğrulamasını Korumak

Formu koddan göndermek neden bazen farklı davranır?

Bir formun gönder düğmesine basmak ile form.submit() çağırmak aynı akış değildir. submit metodu etkileşimli kısıt doğrulamasını ve submit olayını atlar. requestSubmit() ise normal gönderim akışını talep eder; doğrulama ve iptal edilebilen submit olayı bu akışa dahildir. MDN requestSubmit referansı iki yöntemi karşılaştırır.

Bu fark, bir araç çubuğundaki “formu gönder” düğmesinin geçersiz e-posta alanını sessizce geçmesine yol açabilir. Çözümü her alanı ayrıca kontrol eden ikinci bir doğrulama sistemi kurmakla başlatmak zorunda değilsiniz. Önce yerel form davranışını koruyun.

Gerçek gönder düğmesini formda bırakın

Aşağıdaki demo bir sunucuya veri göndermez. submit dinleyicisi gezinmeyi durdurur ve hazırlanmış alanları sayfada gösterir. HTML, CSS ve JavaScript bloklarını aynı belge içinde birlikte kullanın.

<form id="contact-demo" class="form-demo" action="/contact-preview" method="post">
  <label for="contact-email">E-posta</label>
  <input id="contact-email" name="email" type="email" required autocomplete="email">
  <div class="form-actions">
    <button id="send-contact" type="submit" name="intent" value="send">Gönder</button>
    <button id="send-from-code" type="button">Koddan gönder</button>
  </div>
  <p id="contact-result" role="status"></p>
</form>

Gönder düğmesinin adı intent, değeri send. İkinci düğme açıkça type="button" olduğu için tek başına form gönderimi başlatmaz. input'un name alanı verinin anahtarıdır; id ise label bağlantısını kurar. Yerel gönder düğmesini tutmak, JavaScript olmadan da bir sunucu akışına bağlanabilen temel HTML sağlar. Bu demoda gerçek /contact-preview işleyicisi yoktur.

submit olayını form üzerinde dinleyin

const form = document.querySelector('#contact-demo');
const sendButton = document.querySelector('#send-contact');
const codeButton = document.querySelector('#send-from-code');
const result = document.querySelector('#contact-result');

codeButton.addEventListener('click', () => {
  form.requestSubmit(sendButton);
});

form.addEventListener('submit', event => {
  event.preventDefault();
  const data = new FormData(form, event.submitter);
  result.textContent = JSON.stringify(Object.fromEntries(data));
});

Boş veya geçersiz e-posta ile iki düğmeyi de deneyin: Bu formda doğrulama başarısızsa submit dinleyicisine ulaşılmaz. Geçerli bir e-posta ile normal düğme ve koddan gönderim aynı alanları üretir. requestSubmit'e sendButton vermek, hangi gönderim eyleminin seçildiğini açık tutar.

requestSubmit bir click olayı taklidi üretmek için tasarlanmamıştır. İş mantığını yalnızca düğmenin click dinleyicisine koyarsanız programatik gönderimde o dinleyicinin çalışacağını varsaymayın. Burada ortak işlem formun submit olayındadır.

FormData'ya gönderici düğmeyi ayrıca verin

new FormData(form) tek başına etkin gönder düğmesinin name/value çiftini eklemez. İkinci argüman, hangi submitter'ın dahil edileceğini belirtir. Bu örnekte normal ve programatik gönderimde sonuç email ve intent alanlarını içerir. FormData yapıcı belgesi ikinci argümanı açıklar.

Argümansız form.requestSubmit() ilk düğmeye basılmış sayılmaz; belirli bir gönder düğmesi seçmez ve bu örnekte intent alanı oluşmaz. Birden çok eylem varsa ilgili düğmeyi açıkça geçin. Düğmedeki formaction, formmethod veya formnovalidate gibi öznitelikler de gönderim davranışını etkileyebilir. Örnekte bunları kullanmadık; bu nedenle yerel required/email kontrolü korunuyor.

Object.fromEntries yalnızca bu küçük örneğin iki tekil metin alanını göstermek için uygun. Aynı adlı birden fazla alanınız varsa nesneye çevirme tekrarları kaybettirir; FormData üzerinde getAll kullanın veya giriş listesini koruyun. Dosyaları JSON metnine çevirerek göndermek de bu demonun konusu değildir.

Klavyeyi ve dar ekranı örneğe dahil edin

.form-demo {
  box-sizing: border-box;
  width: 100%;
  max-width: 32rem;
  padding: 1rem;
  color: #0f172a;
  background: #fff;
  border: 1px solid #cbd5e1;
  border-radius: 0.75rem;
  overflow-wrap: anywhere;
}
.form-demo label { display: block; margin-bottom: 0.5rem; }
.form-demo input { box-sizing: border-box; width: 100%; min-width: 0; padding: 0.5rem; font: inherit; }
.form-actions { display: flex; flex-wrap: wrap; gap: 0.5rem; margin-top: 1rem; }
.form-actions button { max-width: 100%; padding: 0.5rem; font: inherit; overflow-wrap: anywhere; }
.form-demo :is(input, button):focus-visible { outline: 3px solid #2563eb; outline-offset: 2px; }

Tab ile alana ve düğmelere ulaşın; Space veya Enter ile düğmeyi etkinleştirin. Normal düğmede ve Koddan gönder düğmesinde aynı sonucu görmelisiniz. Uzun etiketlerle, büyütülmüş metinle ve dar ekranda da deneyin. Erişilebilir form rehberi alan adları ve hata geri bildirimini ayrıntılandırır.

Sık sorulan sorular

requestSubmit her durumda doğrulama yapar mı? Formda novalidate veya göndericide formnovalidate varsa davranış değişir. Sunucu tarafı doğrulama yine gereklidir.

requestSubmit'e herhangi bir düğme verebilir miyim? Hayır. Gönder düğmesi olmayan eleman TypeError, bu forma ait olmayan gönder düğmesi NotFoundError üretir. form özniteliğiyle ilişkilendirilmiş dış düğmeler forma ait olabilir.

submit ismini alan adı olarak kullanmak sorun olur mu? name veya id değeri submit olan bir kontrol, form.submit metodunu maskeleyebilir. submit metodu belgesi bu durumu açıklar. HTML Standardı gönderim davranışının normatif kaynağıdır.

Daha Fazla İçerik

Blog sayfasında diğer yazılarımı keşfedin

Tüm Yazılar