A useful interface does not need to be complicated. Start with native HTML, then add JavaScript only when you need it.
What You Need to Know
A declarative shadow root can ask that focus be delegated to a suitable descendant. Focus behavior still needs testing because people must understand which part of the component is active.
Try the Example
Take a look at the example. We’ll explain the important lines right below it.
<student-card>
<template shadowrootmode="open" shadowrootdelegatesfocus>
<label for="card-name">Name</label>
<input id="card-name" name="card-name">
</template>
</student-card>Let’s Read the Code
- <template>: A template stores markup that is inactive until it is cloned or used as declarative shadow content.
- <label>: The label tells people what the input is for. A matching for/id pair makes the label clickable.
- shadowrootmode: Shadowrootmode lets an HTML parser create a declarative shadow root.
- for: For connects a label or output with a control by ID.
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
- A declarative shadow root can ask that focus be delegated to a suitable descendant.
- <template>: A template stores markup that is inactive until it is cloned or used as declarative shadow content.
- A meaningful HTML element is usually a stronger starting point than adding an ARIA role to a generic div. Also check what happens using only the keyboard.