Tutorial

JavaScript Olay Delegasyonu: closest ve Dinamik Düğmeler

Mehmet Fatih Ünal
17 Kasım 2026
7 dk okuma
#JavaScript#DOM#Event Delegation#closest#Erişilebilirlik
JavaScript Olay Delegasyonu: closest ve Dinamik Düğmeler

Sonradan eklenen düğme neden çalışmıyor?

Sayfa açılırken bütün düğmelere click dinleyicisi bağladığınızda, daha sonra eklenen bir düğme o ilk seçimin parçası olmaz. Olay delegasyonu, uygun olayları üst öğede dinleyip işlemin hangi alt öğeye ait olduğunu orada belirleme yaklaşımıdır. Böylece aynı listeye yeni satır eklemek için her düğmeye tekrar dinleyici bağlamak gerekmez.

MDN olay yayılımı rehberi bu yaklaşımın temelini açıklar. Aşağıdaki demo yalnızca görünümden satır kaldırır; kalıcı veri silmez ve API çağırmaz. Örneği normal DOM ağacı için kuruyoruz; Shadow DOM sınırları ayrı bir olay yolu tasarımı gerektirebilir.

İşlemi gerçek düğmeye yerleştirin

<ul id="notes-demo" data-action-list tabindex="-1" aria-label="Notlar">
  <li data-note-id="101">
    Not A
    <button type="button" data-action="remove" aria-label="Not A'yı listeden kaldır">
      <span aria-hidden="true">×</span>
    </button>
  </li>
  <li data-note-id="102">
    Not B
    <button type="button" data-action="remove" aria-label="Not B'yi listeden kaldır">
      <span aria-hidden="true">×</span>
    </button>
  </li>
</ul>
<p id="notes-status" role="status"></p>

span işarete görsel bir hedef verir; erişilebilir işlem adı düğmededir. type="button" bu öğenin bir forma taşındığında istemeden gönderim başlatmasını engeller. tabindex="-1" listeyi normal Tab sırasına eklemeden, liste tamamen boşalınca kodun odağı buraya taşımasına izin verir.

target ile currentTarget'ı ayırın

Dinleyici listedeyken event.currentTarget, dinleyicinin bağlı olduğu listedir. event.target ise tıklanan iç span olabilir. Bu yüzden yalnızca target.matches('button') kontrolü, simgenin üstüne basıldığında işlemi kaçırabilir. closest referansı, öğenin kendisi dahil eşleşen en yakın üst öğeyi bulma davranışını tanımlar.

const list = document.querySelector('#notes-demo');
const status = document.querySelector('#notes-status');

function handleListClick(event) {
  if (!(event.target instanceof Element)) return;
  const button = event.target.closest('button[data-action="remove"]');
  if (!button || button.closest('[data-action-list]') !== list || button.disabled) return;
  const item = button.closest('li[data-note-id]');
  if (!item || item.parentElement !== list) return;

  const id = item.dataset.noteId;
  item.remove();
  status.textContent = 'Listeden kaldırıldı: ' + id;
  const remaining = list.querySelector(':scope > li[data-note-id] > button[data-action="remove"]:not(:disabled)');
  if (remaining) remaining.focus();
  else list.focus();
}

list.addEventListener('click', handleListClick);

closest belge köküne doğru çıkabildiği için eşleşmenin hangi listeye ait olduğunu ayrıca denetliyoruz. İç içe başka bir data-action-list varsa dış liste onun işlemini üstlenmez. item.parentElement kontrolü de bu demonun doğrudan li çocuklarıyla çalıştığını açık tutar.

Her tıklamada bütün satırlara dolaşmıyoruz; olayın hedefinden uygun düğmeyi buluyoruz. İşlemden sonra kalan ilk uygun düğmeye, hiç kalmadıysa listeye odak veriyoruz. Bu küçük odak kararı, kaldırılan düğmeyle birlikte klavye odağının belirsiz bir yere düşmesini önler.

Yeni satırı yeni dinleyici olmadan ekleyin

İlk JavaScript bloğundan sonra bu bloğu çalıştırın. Yeni düğmeye addEventListener çağrısı yoktur; olay aynı listeye yayılır.

const row = document.createElement('li');
row.dataset.noteId = '103';
const removeButton = document.createElement('button');
removeButton.type = 'button';
removeButton.dataset.action = 'remove';
removeButton.setAttribute('aria-label', "Not C'yi listeden kaldır");
const icon = document.createElement('span');
icon.setAttribute('aria-hidden', 'true');
icon.textContent = '×';
removeButton.append(icon);
row.append('Not C ', removeButton);
list.append(row);

101, 102 ve sonradan gelen 103 için aynı işleyici çalışır. Veri anahtarını dataset üzerinden okumak, bu anahtarın sunucu tarafında yetki verdiği anlamına gelmez. Gerçek bir kalıcı işlemde sonucu API sözleşmesine göre ele alın; burada yalnızca DOM davranışını öğreniyoruz.

Klavyeyi, sınırları ve temizliği deneyin

#notes-demo { max-width: 32rem; padding: 0; list-style: none; overflow-wrap: anywhere; }
#notes-demo > li { display: flex; align-items: center; justify-content: space-between; gap: 1rem; padding: 0.75rem; border-bottom: 1px solid #cbd5e1; }
#notes-demo button { flex-shrink: 0; min-width: 2.75rem; min-height: 2.75rem; font: inherit; }
#notes-demo:focus-visible, #notes-demo button:focus-visible { outline: 3px solid #2563eb; outline-offset: 2px; }
#notes-status { overflow-wrap: anywhere; }

Tab ile düğmeye gidip Space veya Enter kullanın. Gerçek button klavye etkinleştirmesini click akışına taşır; ayrıca keydown içinde aynı kaldırma işlemini tekrarlamayın. Erişilebilir form yazısı işlem adları ve klavye kullanımını genişletir.

Başlığa, boş liste alanına ve devre dışı bir düğmeye tıklamak satır kaldırmamalıdır. Bir alt işleyici stopPropagation çağırıyorsa olay üst listeye ulaşmayabilir. stopPropagation ile preventDefault farklı işler yapar; MDN açıklaması bu ayrımı tanımlar.

Listeyi yöneten bileşeni kapatırken, aynı fonksiyon referansıyla dinleyiciyi kaldırabilirsiniz. Aşağıdaki satırı kurulumun hemen ardından değil, temizleme anında çalıştırın.

list.removeEventListener('click', handleListClick);

Sık sorulan sorular

Her olay bu şekilde yayılır mı? Hayır. Bu örnek click içindir; olayın bubbling davranışını ayrıca kontrol edin.

closest yalnızca üst öğelere mi bakar? Kendisini de dener; ilk eşleşmeyi döndürür, eşleşme yoksa null verir.

Listeyi tamamen değiştirirsem dinleyici korunur mu? Yeni bir ul düğümü üretirseniz eski düğümün dinleyicisi yeni düğüme taşınmaz. Delegasyon, burada sabit tuttuğumuz liste öğesine bağlıdır. requestSubmit yazısı da yerel düğme davranışını korumanın farklı bir örneğidir.

Daha Fazla İçerik

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

Tüm Yazılar