{"canonical_url":"https://engineer.company/nb/glossary/web-components/","content_markdown":"# Web components\n\n## Hva det er\n\nWeb components, også skrevet Web Components med store bokstaver, er det vanlige\nnavnet på en gruppe nettleserfunksjoner som lar utviklere definere sine egne\nHTML-elementer. En side bruker deretter et slikt element som en hvilken som\nhelst annen tagg. Standardene kaller delene ved deres egne navn: custom elements\nog elementene `template` og `slot` i HTML-standarden, og shadow trees i\nDOM-standarden. Fellesnavnet er tittelen på\n[*Introduction to Web Components*](https://www.w3.org/TR/components-intro/), en\nWorking Group Note som W3C ga ut 24. juli 2014 og senere har avviklet og merket\nsom et dokument det ikke bør henvises til.\n\nEt custom element defineres av en JavaScript-klasse som utvider `HTMLElement` og\nregistreres under et navn med `customElements.define()`. Definisjonen forteller\nHTML-parseren hvordan elementet skal konstrueres og hvordan det skal reagere på\nendringer, og fra da av kan elementet opprettes fra markup, med\n`document.createElement()` eller med `new`. Navnet begynner med en liten\nASCII-bokstav, inneholder ingen store ASCII-bokstaver og må inneholde en\nbindestrek. Bindestreken holder egne navn atskilt fra selve språket:\nHTML-standarden lover at det heretter ikke legges til noe element med bindestrek\ni navnet i HTML, SVG eller MathML.\n\nDet finnes to slags. Et autonomt custom element, som standardens eget\n`\u003cflag-icon country=\"nl\"\u003e`, tar utgangspunkt i et vanlig element uten innebygd\nbetydning. Et customized built-in element utvider et eksisterende element: en\nklasse som utvider `HTMLButtonElement`, registreres med `{ extends: \"button\" }`\nog brukes som `\u003cbutton is=\"plastic-button\"\u003e`, beholder alt som gjør en knapp til\nen knapp, blant annet fokusoppførsel, innsending av skjemaer og attributtet\n`disabled`.\n\nEt shadow tree er et eget tre av noder som er knyttet til et element, kalt\nverten; DOM-standarden kaller vertens vanlige tre for light tree.\n`attachShadow()` oppretter en shadow root i modusen open eller closed, og bare i\nmodusen open returnerer vertens egenskap `shadowRoot` den. Et `slot`-element i\nvertens shadow tree markerer hvor vertens egne barn vises. Det viser nodene som\ner tilordnet det, eller sitt eget innhold når ingen er tilordnet, og en navngitt\nslot tar de barna som har dens navn i `slot`-attributtet. Elementet `template`\nrommer et HTML-fragment som ikke vises, og som et skript kan klone. Med\nattributtet `shadowrootmode` representerer en `template` en deklarativ shadow\nroot, slik at et shadow tree også kan skrives rett inn i markupen.\n\n## Hvorfor det er viktig\n\nEn oppdiktet tagg var tidligere til liten nytte: HTML-standarden påpeker at\nslike elementer historisk har vært i strid med standarden og ikke særlig\nfunksjonelle. Et custom element er et fullverdig medlem av dokumentet. Parseren\nkonstruerer det, DOM-metodene oppretter det, og klassen bestemmer hva som skjer\nnår attributtene endres, eller når elementet kommer inn på eller forlater en\nside.\n\nDefinisjonen trenger ikke komme først. Et element som parseren allerede har\nopprettet, blir et custom element så snart en definisjon for navnet registreres,\nog HTML-standarden kaller dette en oppgradering. Fram til da behandles elementet\nsom et udefinert element, omtrent som en `span`, slik at teksten og lenkene i\ndet vises som de er. Standarden sier rett ut at oppgraderinger gjør det mulig å\nforbedre innholdet i et custom element progressivt.\n\nEt custom element kan også delta i skjemaer og i tilgjengelighetstreet. En\nklasse som setter `static formAssociated = true` og kaller `attachInternals()`,\nfår et `ElementInternals`-objekt, og `setFormValue()` på dette objektet gir\nelementet en verdi som skjemaet sender inn på samme måte som for enhver annen\nkontroll. Det samme objektet setter en standardrolle og standardtilstander i\nARIA, som gjelder med mindre sidens forfatter overstyrer dem med attributtet\n`role` eller de tilsvarende `aria-*`-attributtene, og det kan holde egne\ntilstander som stilark treffer med pseudoklassen `:state()`.\n\nFor et team er gevinsten ved et shadow tree at komponenten blir selvstendig:\nvanlige selektorer på siden krysser ikke inn i komponentens interne shadow\ntree, og komponenten bestemmer hvilke deler den vil eksponere for styling\nutenfra. Arvede verdier og custom properties kan fortsatt nå inn, og innhold\nfra light tree som vises i slots, er fortsatt underlagt sidens selektorer. Der flere biblioteker\ndeler en side, tilbyr HTML-standarden scoped registries, opprettet med\n`new CustomElementRegistry()`, slik at elementene deres kan leve side om side\nuten at bibliotekene må samordne navnene sine.\n\n## Slik ser det ut i praksis\n\nEt produktkort viser delene i samspill. Siden har innholdet som vanlig markup,\nmed et `slot`-attributt på elementet som skal inn i en navngitt slot:\n\n```html\n\u003cproduct-card\u003e\n  \u003cspan slot=\"name\"\u003eEikekrakk\u003c/span\u003e\n  \u003ca href=\"/butikk/eikekrakk/\"\u003eSe detaljene\u003c/a\u003e\n\u003c/product-card\u003e\n\u003cscript type=\"module\" src=\"product-card.mjs\"\u003e\u003c/script\u003e\n```\n\nModulen definerer elementet. Malen bygges én gang, og hvert kort får sin egen\nkopi av den i en åpen shadow root:\n\n```js\nconst template = document.createElement(\"template\");\ntemplate.innerHTML = `\n  \u003ch2 part=\"title\"\u003e\u003cslot name=\"name\"\u003eProdukt uten 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 tittelen gjennom den ene delen komponenten eksponerer:\n\n```css\nproduct-card::part(title) {\n  font-size: 1.25rem;\n}\n```\n\nFør `product-card.mjs` har kjørt, er kortet et udefinert element, og leseren ser\nproduktnavnet og lenken som vanlig innhold i teksten. Når modulen kjører,\nregistrerer `define()` klassen, og kortet som allerede står på siden, blir\noppgradert. Konstruktøren knytter en shadow root til kortet og fyller den med en\nklone av malens innhold. `span`-elementet tilordnes sloten som heter `name`, og\nvises inne i overskriften. Lenken har ikke noe `slot`-attributt, så den havner i\nden navnløse standardsloten. Et kort uten navn viser i stedet slotens eget\ninnhold, «Produkt uten navn». Sjekken med `customElements.get()` hindrer at en\nekstra kopi av modulen, som kommer med en annen bundle, får `define()` til å\nkaste en feil.\n\nFelles komponenter hjelper bare hvis folk bruker dem, og nettstedets portefølje\nhar en oppføring om akkurat det.\n[Liquid Glass-designsystemet for iOS 26](/nb/portfolio/designed-an-ios-26-liquid-glass-design-system/)\ntar utgangspunkt i et brukergrensesnitt der hver ny skjerm finner opp sine egne\nknapper, merker og kort, alle litt ulike, til hver endring betyr å rette fem\nskreddersydde versjoner. Svaret siden beskriver, er et kanonisk sett med\nkomponenter som alle skjermer settes sammen av, blant dem Card, Label, Button,\nGlassIconButton og DirectoryGrid, med lint-regler som avviser et hjemmelaget\nmerke eller en hjemmelaget brikke og peker mot den kanoniske komponenten. Siden\nsier ikke om komponentene er custom elements, men disiplinen lar seg overføre:\nén definisjon per komponent, holdt ved like av verktøy og ikke av hukommelsen\ntil den som gjør gjennomgangen. Registeret for custom elements håndhever den\nførste halvdelen ved å avvise en ny definisjon for et navn som allerede er i\nbruk.\n\n## Hvor det går galt\n\n**Et navn med bindestrek skal gjøre jobben til en rolle.** «An autonomous custom\nelement does not have any special meaning: it represents its children,» skriver\nHTML-standarden. Standardens eksempel `taco-button` viser hva det koster: for å\noppføre seg som en knapp trenger elementet en `tabindex`, ARIA-rollen `button`,\net tilgjengelig navn, `aria-disabled`, tastaturhåndtering som gjør Enter og\nmellomromstasten til klikk, og stiler for deaktivert tilstand. Selv da kan et\ncustom element ikke angi en standard fokusoppførsel, så `tabindex=\"0\"` stemmer\nkanskje ikke med hvordan knapper oppfører seg på plattformen. Der elementet\nbygger på et eksisterende element, sier standarden at et customized built-in\nelement vil være enklere å utvikle, vedlikeholde og bruke. For et autonomt\nelement bør du sette standardrollen og standardtilstandene via\n`ElementInternals` i stedet for å overlate dem til hver side som bruker det.\n\n**Konstruktøren gjør arbeidet.** HTML-standarden stiller krav til konstruktører\ni custom elements: `super()` uten argumenter kommer først, elementets\nattributter og barn skal ikke undersøkes, fordi et element som er opprettet og\nikke oppgradert, ikke har noen, og elementet skal ikke selv få attributter eller\nbarn. En konstruktør som bryter reglene, kan gi et element som parseren eller\nDOM-metodene ikke klarer å opprette. Bruk konstruktøren til starttilstand,\nstandardverdier, hendelseslyttere og shadow root, og flytt henting og rendering\ntil `connectedCallback`.\n\n**`connectedCallback` forventes å kjøre én gang.** Den kan kjøre mer enn én\ngang. Som standard fører en flytting av elementet til at `disconnectedCallback`\nog deretter `connectedCallback` kjører, så elementet nullstiller tilstanden sin\nsom om det var fjernet og satt inn på nytt. Beskytt oppsett som bare skal skje\nén gang, med et flagg, og rydd i `disconnectedCallback` opp etter det\n`connectedCallback` satte i gang. Skal et element beholde tilstanden sin når det\nflyttes med `moveBefore()`, definerer du `connectedMoveCallback`: at den finnes,\ner nok til å erstatte standardparet, selv med en tom kropp.\n\n**Et navn defineres to ganger.** `customElements.define()` kaster en\n`NotSupportedError` når navnet eller klassen allerede er registrert, og en\n`SyntaxError` når navnet ikke er gyldig, for eksempel fordi det mangler\nbindestrek eller inneholder en stor bokstav. Sjekk med `customElements.get()`\nfør du definerer, og gi et bibliotek som må leve side om side med andre, sitt\neget scoped registry.\n\n**Modusen closed blir tatt for beskyttelse.** Modusen closed skjuler roten for\nvertens egenskap `shadowRoot` og skjuler interne noder i en hendelses composed\npath slik den ses av lyttere utenfor det lukkede shadow tree-et. CSS Shadow\nParts sier rett ut at shadow trees med vilje ikke er en sikkerhetsgrense, bare\nen bekvemmelighet for sideforfattere. Hold hemmeligheter utenfor komponentene,\nog velg modusen closed for virkningen på kode utenfra, ikke som en lås.\n\n**`attachShadow()` kalles der det ikke kan virke.** DOM-standarden tillater en\nshadow root bare på elementer med et gyldig navn for custom elements og på en\nkort liste med innebygde elementer, blant dem `div`, `section`, `p` og `span`,\nmen ikke `button`. På en customized built-in knapp kaster kallet en\n`NotSupportedError`. Det oppfører seg også annerledes på et element som allerede\nhar en rot: er roten deklarativ og i samme modus, fjerner kallet alt i den og\nreturnerer den tom, ellers kaster det en feil. Sjekk først om det allerede\nfinnes en shadow root, slik at markup som serveren har sendt i en deklarativ\nrot, blir beholdt og ikke slettet.\n\n**Sidens stiler forventes å nå inn.** CSS Shadow Parts kaller grensen en\nstylingbarriere og påpeker at den også gjør en komponent vanskeligere å style\nnår siden faktisk ønsker det. Eksponer elementene siden får style, med `part`,\nog style dem utenfra med `::part()`. En komponent inne i en annen trenger\n`exportparts` på den indre verten for å sende delene sine videre til siden. Bruk\ncustom properties satt på verten til farger og avstander som skal følge siden;\nde arves inn i komponentens shadow tree.\n\n**Innholdet finnes først etter skriptet.** En komponent som skriver all teksten\nsin fra JavaScript, viser ikke leserne noe av den før definisjonen er lastet, og\ningenting i det hele tatt hvis skriptet feiler. Hold innholdet i light tree og\ntilordne det til slots, slik produktkortet gjør, så oppgraderingen forbedrer det\nsom allerede står der. Der innhold må vente, skjuler HTML-standardens eget\neksempel det til `customElements.whenDefined()` er innfridd for hvert element\nsom matcher `:not(:defined)`.\n\n## Les mer\n\n- [HTML Standard: Custom elements](https://html.spec.whatwg.org/multipage/custom-elements.html)\n  — navneregler, krav til konstruktører, oppgraderinger, skjematilknyttede\n  elementer og `ElementInternals`, med gjennomgåtte eksempler.\n- [DOM Standard: Shadow tree](https://dom.spec.whatwg.org/#shadow-trees)\n  — shadow roots og vertene deres, slots og nodene som tilordnes dem, og\n  trinnene bak `attachShadow()`.\n- [HTML Standard: Scripting](https://html.spec.whatwg.org/multipage/scripting.html)\n  — elementet `template` med attributtet `shadowrootmode` og elementet `slot`.\n- [CSS Shadow Parts](https://www.w3.org/TR/css-shadow-parts-1/)\n  — W3Cs Working Draft fra 16. desember 2025, som definerer `part`,\n  `exportparts` og pseudoelementet `::part()`.\n\n\u003chttps://engineer.company/nb/glossary/web-components/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Hvordan custom elements, shadow trees og elementene template og slot gir et team egne HTML-tagger, med et gjennomgått eksempel og de vanlige fellene.","formats":{"gemtext":"https://engineer.company/nb/glossary/web-components/index.gmi","gopher":"https://engineer.company/nb/glossary/web-components/gophermap","html":"https://engineer.company/nb/glossary/web-components/","json":"https://engineer.company/nb/glossary/web-components/index.json","markdown":"https://engineer.company/nb/glossary/web-components/index.md","pdf":"https://engineer.company/nb/glossary/web-components/index.pdf"},"kind":"page","language":"nb","title":"Hva er web components?","url":"https://engineer.company/nb/glossary/web-components/","version":1}