HTML Form-Associated Custom Elements and ElementInternals

Let’s take one interactive feature apart so the markup and behavior make sense separately.

What You Need to Know

Form-associated custom elements can participate in forms through ElementInternals. Their value, validity, and labels require deliberate implementation; wrapping a div in a custom tag does not give it form behavior.

Try the Example

Take a look at the example. We’ll explain the important lines right below it.

<form action="/save" method="post">
    <label for="rating">Rating</label>
    <input id="rating" name="rating" type="number" min="1" max="5" required>
    <button type="submit">Save</button>
</form>
<p>A custom control needs ElementInternals and additional JavaScript to behave like a native form field.</p>

Let’s Read the Code

<form>: The form groups controls and identifies where submitted data goes.
<label>: The label tells people what the input is for. A matching for/id pair makes the label clickable.
for: For connects a label or output with a control by ID.
id: An id uniquely identifies an element on this page.

Read the named elements and attributes together. They explain how the browser connects this feature to the rest of the page.

What Happens in the Browser?

When this example includes JavaScript, it supplies behavior that ordinary HTML does not automatically provide. Always think about a fallback.

Start with native behavior. Details, dialog, and popover each solve a different interface problem. Choose the simplest control that actually matches what a visitor wants to do, then test focus and dismissal as well as appearance.

Your Turn

Run this on a local development server if it loads modules or resources. Change the visible text or trigger and check what still works with scripts disabled.

Common Beginner Mistakes

Assuming new HTML syntax works in every browser without testing.
HTML supplies structure; JavaScript is necessary for the scripted behavior in this example. Check keyboard access and focus movement too.

Key Takeaways

Form-associated custom elements can participate in forms through ElementInternals.
<form>: The form groups controls and identifies where submitted data goes.
Remember that HTML form rules help the visitor, but server-side code must decide whether received data is valid.