<!-- template : markup inerte, cloné à la demande, jamais rendu tel quel -->
<template id="tpl-carte-produit">
    <style>
        .carte { border: 1px solid #ddd; border-radius: 8px; padding: 16px; }
        .prix { color: #2563eb; font-weight: bold; }
    </style>
    <div class="carte">
        <h3><slot name="titre">Titre par défaut</slot></h3>
        <p class="prix"><slot name="prix">0€</slot></p>
        <slot>Description par défaut</slot>
    </div>
</template>

// Custom element : encapsule structure, style et comportement
class CarteProduit extends HTMLElement {
    static get observedAttributes() {
        return ["disponible"]; // attributs surveillés pour attributeChangedCallback
    }

    constructor() {
        super();

        // Shadow DOM : isole le style/markup interne du reste de la page
        // "open" = accessible depuis l'extérieur via element.shadowRoot
        const shadow = this.attachShadow({ mode: "open" });

        const template = document.getElementById("tpl-carte-produit");
        shadow.appendChild(template.content.cloneNode(true));
    }

    connectedCallback() {
        // appelé quand l'élément est inséré dans le DOM
        console.log("Carte produit ajoutée à la page");
    }

    disconnectedCallback() {
        // appelé quand l'élément est retiré : nettoyer listeners/timers ici
    }

    attributeChangedCallback(nom, ancienneValeur, nouvelleValeur) {
        if (nom === "disponible") {
            this.shadowRoot.querySelector(".carte").classList.toggle(
                "indisponible",
                nouvelleValeur === "false"
            );
        }
    }
}

// Le nom DOIT contenir un tiret : réservé aux éléments custom par la spec
customElements.define("carte-produit", CarteProduit);

<!-- Usage : un vrai élément HTML, utilisable partout -->
<carte-produit disponible="true">
    <span slot="titre">Chaise ergonomique</span>
    <span slot="prix">129€</span>
    Bois massif, garantie 5 ans.
</carte-produit>

<carte-produit disponible="false">
    <span slot="titre">Bureau réglable</span>
    <span slot="prix">349€</span>
    Hauteur ajustable électriquement.
</carte-produit>

// Communication : props, events, attributs — pas de framework, juste la plateforme
class SelecteurQuantite extends HTMLElement {
    connectedCallback() {
        this.innerHTML = `
            <button data-action="moins">-</button>
            <span data-role="valeur">1</span>
            <button data-action="plus">+</button>
        `;
        this.valeur = 1;

        this.addEventListener("click", (e) => {
            const action = e.target.dataset.action;
            if (!action) return;

            this.valeur = Math.max(1, this.valeur + (action === "plus" ? 1 : -1));
            this.querySelector('[data-role="valeur"]').textContent = this.valeur;

            // Custom event : pattern standard pour remonter une info au parent
            this.dispatchEvent(new CustomEvent("quantite-changee", {
                detail: { valeur: this.valeur },
                bubbles: true, // traverse le DOM comme un événement natif
            }));
        });
    }
}
customElements.define("selecteur-quantite", SelecteurQuantite);

document.querySelector("selecteur-quantite")
    .addEventListener("quantite-changee", (e) => {
        console.log("Nouvelle quantité :", e.detail.valeur);
    });