HTML Declarative Shadow DOM with shadowrootmode

Small interactions can make a webpage easier to use: opening a tip, changing a setting, or reusing an interface component.

What You Need to Know

Declarative Shadow DOM can attach a shadow root directly from HTML using template shadowrootmode. Browser support and server rendering details matter, so test the exact markup you use.

In this example: render a static web component without JS initialization.

Try the Example

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

<student-card>
    <template shadowrootmode="open">
        <style>p { color: teal; }</style>
        <p>Styles in this shadow tree are scoped.</p>
        <slot></slot>
    </template>
    <span>Student: Alex</span>
</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.
<style>: Style contains CSS rules for the page.
shadowrootmode: Shadowrootmode lets an HTML parser create a declarative shadow root.

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

Declarative Shadow DOM can attach a shadow root directly from HTML using template shadowrootmode.
<template>: A template stores markup that is inactive until it is cloned or used as declarative shadow content.
Test the behavior you expect rather than trusting how the snippet looks in your editor.