{"canonical_url":"https://engineer.company/da/glossary/web-components/","content_markdown":"# Web components\n\n## Hvad det er\n\nWeb components, også skrevet Web Components med store bogstaver, er det gængse\nnavn på en gruppe browserfunktioner, der lader udviklere definere deres egne\nHTML-elementer. En side bruger derefter sådan et element som ethvert andet tag.\nStandarderne kalder delene ved deres egne navne: custom elements og elementerne\n`template` og `slot` i HTML-standarden og shadow trees i DOM-standarden.\nFællesnavnet er titlen på\n[*Introduction to Web Components*](https://www.w3.org/TR/components-intro/), en\nWorking Group Note, som W3C udgav den 24. juli 2014 og siden har indstillet og\nmarkeret som et dokument, der ikke bør henvises til.\n\nEt custom element defineres af en JavaScript-klasse, der udvider `HTMLElement`\nog registreres under et navn med `customElements.define()`. Definitionen\nfortæller HTML-parseren, hvordan elementet skal konstrueres, og hvordan det skal\nreagere på ændringer, og fra da af kan elementet oprettes fra markup, med\n`document.createElement()` eller med `new`. Navnet begynder med et lille\nASCII-bogstav, indeholder ingen store ASCII-bogstaver og skal indeholde en\nbindestreg. Bindestregen holder egne navne adskilt fra selve sproget:\nHTML-standarden lover, at der fremover ikke tilføjes noget element med\nbindestreg i navnet til HTML, SVG eller MathML.\n\nDer findes to slags. Et autonomt custom element, som standardens eget\n`\u003cflag-icon country=\"nl\"\u003e`, tager udgangspunkt i et almindeligt element uden\nindbygget betydning. Et customized built-in element udvider et eksisterende\nelement: en klasse, der udvider `HTMLButtonElement`, registreres med\n`{ extends: \"button\" }` og bruges som `\u003cbutton is=\"plastic-button\"\u003e`, beholder\nalt det, der gør en knap til en knap, også fokusadfærd, formularindsendelse og\nattributten `disabled`.\n\nEt shadow tree er et separat træ af noder, der er knyttet til et element, som\nkaldes dets vært; DOM-standarden kalder værtens almindelige træ for light tree.\n`attachShadow()` opretter en shadow root i tilstanden open eller closed, og kun\ni tilstanden open returnerer værtens egenskab `shadowRoot` den. Et\n`slot`-element i værtens shadow tree markerer, hvor værtens egne børn vises. Det\nviser de noder, der er tildelt det, eller sit eget indhold, når ingen er\ntildelt, og en navngivet slot tager de børn, hvis `slot`-attribut bærer dens\nnavn. Elementet `template` rummer et HTML-fragment, som ikke vises, og som et\nscript kan klone. Med attributten `shadowrootmode` repræsenterer en `template`\nen deklarativ shadow root, så et shadow tree også kan skrives direkte i markup.\n\n## Hvorfor det betyder noget\n\nEt opfundet tag var tidligere ikke til megen nytte: HTML-standarden bemærker, at\nden slags elementer historisk har været i strid med standarden og ikke særlig\nfunktionelle. Et custom element er et fuldgyldigt medlem af dokumentet. Parseren\nkonstruerer det, DOM-metoderne opretter det, og dets klasse bestemmer, hvad der\nsker, når dets attributter ændres, eller når det kommer ind på eller forlader en\nside.\n\nDefinitionen behøver ikke komme først. Et element, som parseren allerede har\noprettet, bliver et custom element, så snart en definition for dets navn\nregistreres, og HTML-standarden kalder det en opgradering. Indtil da behandles\nelementet som et udefineret element, stort set som en `span`, så teksten og\nlinkene i det vises, som de er. Standarden siger ligeud, at opgraderinger gør\ndet muligt at forbedre indholdet i et custom element progressivt.\n\nEt custom element kan også indgå i formularer og i tilgængelighedstræet. En\nklasse, der sætter `static formAssociated = true` og kalder `attachInternals()`,\nfår et `ElementInternals`-objekt, og `setFormValue()` på det objekt giver\nelementet en værdi, som formularen sender med ligesom enhver anden kontrols. Det\nsamme objekt sætter en standardrolle og standardtilstande i ARIA, som gælder,\nmedmindre sidens forfatter tilsidesætter dem med attributten `role` eller de\ntilsvarende `aria-*`-attributter, og det kan rumme egne tilstande, som\nstylesheets rammer med pseudoklassen `:state()`.\n\nFor et team er gevinsten ved et shadow tree, at komponenten bliver selvstændig:\nalmindelige selektorer på siden krydser ikke ind i komponentens interne shadow\ntree, og komponenten bestemmer, hvilke dele den vil gøre tilgængelige for\nstyling udefra. Nedarvede værdier og custom properties kan stadig nå ind, og\nindhold fra light tree, der vises gennem slots, er stadig omfattet af sidens\nselektorer. Hvor flere biblioteker deler\nen side, tilbyder HTML-standarden scoped registries, oprettet med\n`new CustomElementRegistry()`, så deres elementer kan sameksistere, uden at\nbibliotekerne skal koordinere deres navne.\n\n## Sådan ser det ud i praksis\n\nEt produktkort viser delene i samspil. Siden rummer indholdet som almindelig\nmarkup, med en `slot`-attribut på det element, der skal ind i en navngivet slot:\n\n```html\n\u003cproduct-card\u003e\n  \u003cspan slot=\"name\"\u003eEgeskammel\u003c/span\u003e\n  \u003ca href=\"/butik/egeskammel/\"\u003eSe detaljerne\u003c/a\u003e\n\u003c/product-card\u003e\n\u003cscript type=\"module\" src=\"product-card.mjs\"\u003e\u003c/script\u003e\n```\n\nModulet definerer elementet. Skabelonen bygges én gang, og hvert kort får sin\negen kopi af den i en åben shadow root:\n\n```js\nconst template = document.createElement(\"template\");\ntemplate.innerHTML = `\n  \u003ch2 part=\"title\"\u003e\u003cslot name=\"name\"\u003eProdukt uden navn\u003c/slot\u003e\u003c/h2\u003e\n  \u003cslot\u003e\u003c/slot\u003e\n`;\n\nclass ProductCard extends HTMLElement {\n  constructor() {\n    super();\n    const root = this.attachShadow({ mode: \"open\" });\n    root.append(template.content.cloneNode(true));\n  }\n}\n\nif (!customElements.get(\"product-card\")) {\n  customElements.define(\"product-card\", ProductCard);\n}\n```\n\nSiden styler titlen gennem den ene del, komponenten stiller til rådighed:\n\n```css\nproduct-card::part(title) {\n  font-size: 1.25rem;\n}\n```\n\nFør `product-card.mjs` er kørt, er kortet et udefineret element, og læseren ser\nproduktnavnet og linket som almindeligt indhold i teksten. Når modulet kører,\nregistrerer `define()` klassen, og det kort, der allerede står på siden, bliver\nopgraderet. Konstruktøren knytter en shadow root til kortet og fylder den med en\nklon af skabelonens indhold. `span`-elementet tildeles den slot, der hedder\n`name`, og vises inde i overskriften. Linket har ingen `slot`-attribut, så det\nhavner i den unavngivne standardslot. Et kort uden navn viser i stedet slottens\neget indhold, »Produkt uden navn«. Tjekket med `customElements.get()`\nforhindrer, at en ekstra kopi af modulet, der ankommer i et andet bundle, får\n`define()` til at kaste en fejl.\n\nFælles komponenter hjælper kun, hvis folk bruger dem, og dette sites portefølje\nhar en post om netop det.\n[Liquid Glass-designsystemet til iOS 26](/da/portfolio/designed-an-ios-26-liquid-glass-design-system/)\ntager udgangspunkt i en brugerflade, hvor hver ny skærm genopfinder sine egne\nknapper, badges og kort, alle lidt forskellige, indtil hver ændring betyder, at\nfem specialbyggede versioner skal rettes. Svaret, som siden beskriver, er et\nkanonisk sæt komponenter, som alle skærme sammensættes af, blandt andet Card,\nLabel, Button, GlassIconButton og DirectoryGrid, med lint-regler, der afviser et\nhjemmelavet badge eller en hjemmelavet chip og henviser til den kanoniske\nkomponent. Siden siger ikke, om komponenterne er custom elements, men\ndisciplinen kan overføres: én definition pr. komponent, holdt i kraft af\nværktøjer og ikke af en reviewers hukommelse. Registret for custom elements\nhåndhæver den første halvdel ved at afvise en ny definition for et navn, der\nallerede er i brug.\n\n## Hvor det går galt\n\n**Et navn med bindestreg skal gøre det ud for en rolle.** »An autonomous custom\nelement does not have any special meaning: it represents its children,« skriver\nHTML-standarden. Standardens eksempel `taco-button` viser, hvad det koster: for\nat opføre sig som en knap har elementet brug for en `tabindex`, ARIA-rollen\n`button`, et tilgængeligt navn, `aria-disabled`, tastaturhåndtering, der gør\nEnter og mellemrumstasten til klik, og styles til den deaktiverede tilstand.\nSelv da kan et custom element ikke erklære en standardadfærd for fokus, så\n`tabindex=\"0\"` passer måske ikke til den måde, knapper opfører sig på på\nplatformen. Hvor elementet bygger på et eksisterende element, siger standarden,\nat et customized built-in element vil være lettere at udvikle, vedligeholde og\nbruge. Sæt for et autonomt element standardrollen og standardtilstandene via\n`ElementInternals` i stedet for at overlade dem til hver side, der bruger det.\n\n**Konstruktøren gør arbejdet.** HTML-standarden stiller krav til konstruktører i\ncustom elements: `super()` uden argumenter kommer først, elementets attributter\nog børn må ikke undersøges, for et element, der er oprettet og ikke opgraderet,\nhar ingen, og elementet må ikke selv få attributter eller børn. En konstruktør,\nder bryder reglerne, kan give et element, som parseren eller DOM-metoderne ikke\nkan oprette. Brug konstruktøren til starttilstand, standardværdier, event\nlisteners og shadow root, og flyt hentning og rendering til `connectedCallback`.\n\n**`connectedCallback` forventes at køre én gang.** Den kan køre mere end én\ngang. Som standard kører en flytning af elementet først `disconnectedCallback`\nog så `connectedCallback`, så elementet nulstiller sin tilstand, som om det var\nblevet fjernet og indsat igen. Beskyt opsætning, der kun må ske én gang, med et\nflag, og ryd i `disconnectedCallback` op efter det, som `connectedCallback`\nsatte i gang. Skal et element beholde sin tilstand, når det flyttes med\n`moveBefore()`, så definér `connectedMoveCallback`: alene det, at den findes,\nerstatter standardparret, også med en tom krop.\n\n**Et navn defineres to gange.** `customElements.define()` kaster en\n`NotSupportedError`, når navnet eller klassen allerede er registreret, og en\n`SyntaxError`, når navnet ikke er gyldigt, for eksempel fordi det mangler en\nbindestreg eller indeholder et stort bogstav. Tjek med `customElements.get()`,\nfør du definerer, og giv et bibliotek, der skal sameksistere med andre, sit eget\nscoped registry.\n\n**Tilstanden closed opfattes som beskyttelse.** Tilstanden closed skjuler roden\nfor værtens egenskab `shadowRoot` og skjuler interne noder i en hændelses\ncomposed path, sådan som den ses af lyttere uden for det lukkede shadow tree. CSS Shadow\nParts siger ligeud, at shadow trees med vilje ikke er en sikkerhedsgrænse, kun\nen bekvemmelighed for sidens forfattere. Hold hemmeligheder ude af komponenter,\nog vælg tilstanden closed for dens virkning på kode udefra, ikke som en lås.\n\n**`attachShadow()` kaldes, hvor det ikke kan virke.** DOM-standarden tillader\nkun en shadow root på elementer med et gyldigt navn til custom elements og på en\nkort liste af indbyggede elementer, blandt dem `div`, `section`, `p` og `span`,\nmen ikke `button`. På en customized built-in knap kaster kaldet en\n`NotSupportedError`. Det opfører sig også anderledes på et element, der allerede\nhar en rod: er den rod deklarativ og i samme tilstand, fjerner kaldet alt i den\nog returnerer den tom, og ellers kaster det en fejl. Tjek først, om der allerede\ner en shadow root, så markup, som serveren har sendt i en deklarativ rod,\nbevares og ikke slettes.\n\n**Sidens styles forventes at nå ind.** CSS Shadow Parts kalder grænsen en\nstylingbarriere og bemærker, at den også gør en komponent sværere at style, når\nsiden gerne vil. Udstil de elementer, siden må style, med `part`, og style dem\nudefra med `::part()`. En komponent inde i en anden har brug for `exportparts`\npå den indre vært for at give sine dele videre til siden. Brug custom properties\nsat på værten til farver og afstande, der skal følge siden; de arves ind i\nkomponentens shadow tree.\n\n**Indholdet findes først efter scriptet.** En komponent, der skriver al sin\ntekst fra JavaScript, viser ikke læserne noget af den, før definitionen er\nindlæst, og slet intet, hvis scriptet fejler. Hold indholdet i light tree, og\ntildel det til slots, som produktkortet gør, så opgraderingen forbedrer det, der\nallerede står der. Hvor indhold må vente, skjuler HTML-standardens eget eksempel\ndet, indtil `customElements.whenDefined()` er opfyldt for hvert element, der\nmatcher `:not(:defined)`.\n\n## Læs mere\n\n- [HTML Standard: Custom elements](https://html.spec.whatwg.org/multipage/custom-elements.html)\n  — navneregler, krav til konstruktører, opgraderinger, formulartilknyttede\n  elementer og `ElementInternals`, med gennemgåede eksempler.\n- [DOM Standard: Shadow tree](https://dom.spec.whatwg.org/#shadow-trees)\n  — shadow roots og deres værter, slots og de noder, der tildeles dem, og\n  trinene bag `attachShadow()`.\n- [HTML Standard: Scripting](https://html.spec.whatwg.org/multipage/scripting.html)\n  — elementet `template` med attributten `shadowrootmode` og elementet `slot`.\n- [CSS Shadow Parts](https://www.w3.org/TR/css-shadow-parts-1/)\n  — W3C's Working Draft fra den 16. december 2025, som definerer `part`,\n  `exportparts` og pseudoelementet `::part()`.\n\n\u003chttps://engineer.company/da/glossary/web-components/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Hvordan custom elements, shadow trees og elementerne template og slot giver et team egne HTML-tags, med et gennemgået eksempel og de typiske fælder.","formats":{"gemtext":"https://engineer.company/da/glossary/web-components/index.gmi","gopher":"https://engineer.company/da/glossary/web-components/gophermap","html":"https://engineer.company/da/glossary/web-components/","json":"https://engineer.company/da/glossary/web-components/index.json","markdown":"https://engineer.company/da/glossary/web-components/index.md","pdf":"https://engineer.company/da/glossary/web-components/index.pdf"},"kind":"page","language":"da","title":"Hvad er web components?","url":"https://engineer.company/da/glossary/web-components/","version":1}