← All resources
The toolkit · Resource guide

Delegate repeated button events

Handle repeated controls through a listener on their shared container.

Visit website (opens in a new tab)
Understand the tool

Overview

Handle repeated controls through a listener on their shared container.

The example below is an original, minimal illustration of the referenced web-platform feature. Read the official reference and adapt it before using it in a real project.

Best for

  • Understanding delegate repeated button events.
  • Trying the pattern in an isolated page.
  • Adapting the example to an existing website.

Key features

  • Event delegation
  • Closest element lookup
  • Container boundary check
A practical walkthrough

Getting started

  1. Read the example and reference. Identify the selectors, files or values that belong to your project.

  2. Try it in isolation. Use a disposable test page and adapt the example values.

  3. Verify before reuse. Check keyboard behavior, responsive layout and relevant browser support.

Things to know

  • These examples are learning material, not a drop-in application.
  • Replace example filenames, selectors and routes as needed.
  • Test changes on staging and escape data for the context where it is used.

Code example

Original illustrative example. Adapt filenames and selectors, and test on staging before reuse.

const list = document.querySelector('.project-list');
if (list) list.addEventListener('click', event => {
  if (!(event.target instanceof Element)) return;
  const button = event.target.closest('button[data-project]');
  if (!button || !list.contains(button)) return;
  console.log('Selected project:', button.dataset.project);
});

Useful alongside this

Accessibility

Text

Visual

Orientation

Accessibility settings