{"canonical_url":"https://engineer.company/sv/glossary/web-components/","content_markdown":"# Web components\n\n## Vad det är\n\nWeb components, även skrivet Web Components med versaler, är det vanliga namnet\npå en grupp webbläsarfunktioner som låter utvecklare definiera sina egna\nHTML-element. En sida använder sedan ett sådant element som vilken annan tagg\nsom helst. Standarderna kallar delarna vid deras egna namn: custom elements och\nelementen `template` och `slot` i HTML-standarden, och shadow trees i\nDOM-standarden. Samlingsnamnet är titeln på\n[*Introduction to Web Components*](https://www.w3.org/TR/components-intro/), en\nWorking Group Note som W3C gav ut den 24 juli 2014 och sedan har avvecklat och\nmärkt som ett dokument som inte bör hänvisas till.\n\nEtt custom element definieras av en JavaScript-klass som utökar `HTMLElement`\noch registreras under ett namn med `customElements.define()`. Definitionen talar\nom för HTML-parsern hur elementet ska konstrueras och hur det ska reagera på\nändringar, och från och med då kan elementet skapas från markup, med\n`document.createElement()` eller med `new`. Namnet börjar med en liten\nASCII-bokstav, innehåller inga stora ASCII-bokstäver och måste innehålla ett\nbindestreck. Bindestrecket håller egna namn åtskilda från själva språket:\nHTML-standarden utlovar att inget element med bindestreck i namnet kommer att\nläggas till i HTML, SVG eller MathML framöver.\n\nDet finns två sorter. Ett autonomt custom element, som standardens eget\n`\u003cflag-icon country=\"nl\"\u003e`, utgår från ett vanligt element utan inbyggd\nbetydelse. Ett customized built-in element bygger ut ett befintligt element.\nStandardens exempel är en klass som utökar `HTMLButtonElement`, registreras med\n`{ extends: \"button\" }` och används som `\u003cbutton is=\"plastic-button\"\u003e`. Ett\nsådant element behåller allt som gör en knapp till en knapp, bland annat\nfokusbeteende, formulärinskickning och attributet `disabled`.\n\nEtt shadow tree är ett separat träd av noder som är kopplat till ett element,\nsom kallas dess värd; DOM-standarden kallar värdens vanliga träd för light tree.\n`attachShadow()` skapar en shadow root i läget open eller closed, och bara i\nläget open returnerar värdens egenskap `shadowRoot` den. Ett `slot`-element i\nvärdens shadow tree markerar var värdens egna barn visas. Det visar de noder som\nhar tilldelats det, eller sitt eget innehåll när inga har tilldelats, och en\nnamngiven slot tar de barn vars `slot`-attribut bär dess namn. Elementet\n`template` rymmer ett HTML-fragment som inte renderas och som ett skript kan\nklona. Med attributet `shadowrootmode` representerar en `template` en deklarativ\nshadow root, så att ett shadow tree också kan skrivas direkt i markupen.\n\n## Varför det spelar roll\n\nEn påhittad tagg var tidigare till liten nytta: HTML-standarden konstaterar att\nsådana element historiskt har stridit mot standarden och inte varit särskilt\nfunktionella. Ett custom element är en fullvärdig medlem av dokumentet. Parsern\nkonstruerar det, DOM-metoderna skapar det, och dess klass bestämmer vad som\nhänder när dess attribut ändras eller när det läggs in på eller tas bort från en\nsida.\n\nDefinitionen behöver inte komma först. Ett element som parsern redan har skapat\nblir ett custom element så snart en definition för dess namn registreras, och\nHTML-standarden kallar det en uppgradering. Fram till dess behandlas elementet\nsom ett odefinierat element, ungefär som en `span`, så texten och länkarna i det\nvisas som de är. Standarden säger rent ut att uppgraderingar gör det möjligt att\nförbättra innehållet i ett custom element progressivt.\n\nEtt custom element kan också delta i formulär och i tillgänglighetsträdet. En\nklass som sätter `static formAssociated = true` och anropar `attachInternals()`\nfår ett `ElementInternals`-objekt, och `setFormValue()` på det objektet ger\nelementet ett värde som formuläret skickar med precis som för vilken annan\nkontroll som helst. Samma objekt sätter en standardroll och standardtillstånd i\nARIA, som gäller om inte sidans författare åsidosätter dem med attributet `role`\neller motsvarande `aria-*`-attribut, och det kan hålla egna tillstånd som\nstilmallar matchar med pseudoklassen `:state()`.\n\nFör ett team är vinsten med ett shadow tree att komponenten blir självständig:\nvanliga selektorer på sidan når inte in i dess interna shadow tree, och\nkomponenten bestämmer vilka delar den ska exponera för styling utifrån.\nÄrvda värden och custom properties kan fortfarande nå in, och innehåll från\nlight tree som visas i slots påverkas fortfarande av sidans selektorer. Där flera bibliotek delar\nen sida erbjuder HTML-standarden scoped registries, som skapas med\n`new CustomElementRegistry()`, så att deras element kan samexistera utan att\nbiblioteken behöver samordna sina namn.\n\n## Så ser det ut i praktiken\n\nEtt produktkort visar delarna i samspel. Sidan har innehållet som vanlig markup,\nmed ett `slot`-attribut på det element som ska in i en namngiven slot:\n\n```html\n\u003cproduct-card\u003e\n  \u003cspan slot=\"name\"\u003eEkpall\u003c/span\u003e\n  \u003ca href=\"/butik/ekpall/\"\u003eSe detaljerna\u003c/a\u003e\n\u003c/product-card\u003e\n\u003cscript type=\"module\" src=\"product-card.mjs\"\u003e\u003c/script\u003e\n```\n\nModulen definierar elementet. Mallen byggs en gång, och varje kort får en egen\nkopia av den i en öppen shadow root:\n\n```js\nconst template = document.createElement(\"template\");\ntemplate.innerHTML = `\n  \u003ch2 part=\"title\"\u003e\u003cslot name=\"name\"\u003eNamnlös produkt\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\nSidan stylar rubriken genom den enda del som komponenten exponerar:\n\n```css\nproduct-card::part(title) {\n  font-size: 1.25rem;\n}\n```\n\nInnan `product-card.mjs` har körts är kortet ett odefinierat element, och\nläsaren ser produktnamnet och länken som vanligt innehåll i texten. När modulen\nkörs registrerar `define()` klassen, och kortet som redan finns på sidan\nuppgraderas. Konstruktorn kopplar en shadow root till kortet och fyller den med\nen klon av mallens innehåll. `span`-elementet tilldelas den slot som heter\n`name` och visas inne i rubriken. Länken saknar `slot`-attribut, så den hamnar i\nden namnlösa standardsloten. Ett kort utan namn visar i stället slottens eget\ninnehåll, ”Namnlös produkt”. Kontrollen med `customElements.get()` hindrar en\nextra kopia av modulen, som kommer med ett annat paket, från att få `define()`\natt kasta ett fel.\n\nGemensamma komponenter hjälper bara om folk använder dem, och webbplatsens\nportfölj har ett uppdrag som handlar om just det.\n[Liquid Glass-designsystemet för iOS 26](/sv/portfolio/designed-an-ios-26-liquid-glass-design-system/)\nutgår från ett gränssnitt där varje ny skärm uppfinner sina egna knappar, märken\noch kort, alla lite olika, tills varje ändring innebär att fem skräddarsydda\nversioner måste rättas. Svaret som sidan beskriver är en kanonisk uppsättning\nkomponenter som alla skärmar byggs av, bland dem Card, Label, Button,\nGlassIconButton och DirectoryGrid, med lintregler som avvisar ett hemsnickrat\nmärke eller chip och pekar mot den kanoniska komponenten. Sidan säger inte om\nkomponenterna är custom elements, men disciplinen går att föra över: en enda\ndefinition per komponent, upprätthållen av verktyg och inte av granskarens\nminne. Registret för custom elements upprätthåller den första halvan genom att\navvisa en ny definition för ett namn som redan används.\n\n## Var det går fel\n\n**Ett namn med bindestreck får ersätta en roll.** ”An autonomous custom element\ndoes not have any special meaning: it represents its children,” skriver\nHTML-standarden. Standardens exempel `taco-button` visar vad det kostar: för att\nbete sig som en knapp behöver elementet ett `tabindex`, ARIA-rollen `button`,\nett tillgängligt namn, `aria-disabled`, tangentbordshantering som gör Enter och\nmellanslag till klick, och stilar för det inaktiverade läget. Även då kan ett\ncustom element inte ange ett standardbeteende för fokus, så `tabindex=\"0\"`\nstämmer kanske inte med hur knappar beter sig på plattformen. Där elementet\nbygger på ett befintligt element säger standarden att ett customized built-in\nelement blir lättare att utveckla, underhålla och använda. Ge ett autonomt\nelement en standardroll och standardtillstånd via `ElementInternals` i stället\nför att lämna dem åt varje sida som använder det.\n\n**Konstruktorn gör jobbet.** HTML-standarden ställer krav på konstruktorer i\ncustom elements: `super()` utan argument kommer först, elementets attribut och\nbarn får inte undersökas, eftersom ett element som har skapats och inte\nuppgraderats inte har några, och konstruktorn får inte ge elementet attribut\neller barn. En konstruktor som bryter mot reglerna kan ge ett element som\nparsern eller DOM-metoderna inte kan skapa. Använd konstruktorn till\nstarttillstånd, standardvärden, händelselyssnare och shadow root, och flytta\nhämtning och rendering till `connectedCallback`.\n\n**`connectedCallback` förväntas köras en gång.** Den kan köras mer än en gång.\nSom standard leder en flytt av elementet till att `disconnectedCallback` och\nsedan `connectedCallback` körs, så att elementet nollställer sitt tillstånd som\nom det hade tagits bort och satts in igen. Skydda uppsättning som bara får ske\nen gång med en flagga, och städa i `disconnectedCallback` upp efter det som\n`connectedCallback` satte igång. Ska ett element behålla sitt tillstånd när det\nflyttas med `moveBefore()`, så definierar du `connectedMoveCallback`: att den\nfinns räcker för att ersätta standardparet, även med en tom kropp.\n\n**Ett namn definieras två gånger.** `customElements.define()` kastar ett\n`NotSupportedError` när namnet eller klassen redan är registrerad, och ett\n`SyntaxError` när namnet inte är giltigt, till exempel för att det saknar\nbindestreck eller innehåller en versal. Kontrollera med `customElements.get()`\ninnan du definierar, och ge ett bibliotek som måste samexistera med andra ett\neget scoped registry.\n\n**Läget closed tas för ett skydd.** Läget closed döljer roten för värdens\negenskap `shadowRoot` och döljer interna noder i en händelses composed path\nså som den ses av lyssnare utanför det slutna shadow tree-et. CSS Shadow Parts säger\nrent ut att shadow trees medvetet inte är en säkerhetsgräns, bara en\nbekvämlighet för sidförfattare. Håll hemligheter utanför komponenterna, och välj\nläget closed för dess effekt på kod utifrån, inte som ett lås.\n\n**`attachShadow()` anropas där det inte kan fungera.** DOM-standarden tillåter\nen shadow root bara på element med ett giltigt namn för custom elements och på\nen kort lista med inbyggda element, bland dem `div`, `section`, `p` och `span`,\nmen inte `button`. På en customized built-in knapp kastar anropet ett\n`NotSupportedError`. Det beter sig också annorlunda på ett element som redan har\nen rot: är roten deklarativ och i samma läge tömmer anropet den och returnerar\nden, och annars kastar det ett fel. Kontrollera först om det redan finns en\nshadow root, så att markup som servern har skickat i en deklarativ rot behålls i\nstället för att raderas.\n\n**Sidans stilar förväntas nå in.** CSS Shadow Parts kallar gränsen en\nstylingbarriär och påpekar att den också gör en komponent svårare att styla när\nsidan faktiskt vill det. Exponera de element som sidan får styla med `part`, och\nstyla dem utifrån med `::part()`. En komponent inuti en annan behöver\n`exportparts` på den inre värden för att skicka sina delar vidare till sidan.\nAnvänd custom properties som sätts på värden för färger och avstånd som ska\nfölja sidan; de ärvs in i komponentens shadow tree.\n\n**Innehållet finns först efter skriptet.** En komponent som skriver all sin text\nfrån JavaScript visar inget av den för läsarna förrän definitionen har laddats,\noch ingenting alls om skriptet fallerar. Håll innehållet i light tree och\ntilldela det till slots, som produktkortet gör, så att uppgraderingen förbättrar\ndet som redan finns där. Där innehåll måste vänta döljer HTML-standardens eget\nexempel det tills `customElements.whenDefined()` har uppfyllts för varje element\nsom matchar `:not(:defined)`.\n\n## Läs mer\n\n- [HTML Standard: Custom elements](https://html.spec.whatwg.org/multipage/custom-elements.html)\n  — namnregler, krav på konstruktorer, uppgraderingar, formulärkopplade element\n  och `ElementInternals`, med genomgångna exempel.\n- [DOM Standard: Shadow tree](https://dom.spec.whatwg.org/#shadow-trees)\n  — shadow roots och deras värdar, slots och de noder som tilldelas dem, och\n  stegen bakom `attachShadow()`.\n- [HTML Standard: Scripting](https://html.spec.whatwg.org/multipage/scripting.html)\n  — elementet `template` med attributet `shadowrootmode`, och elementet `slot`.\n- [CSS Shadow Parts](https://www.w3.org/TR/css-shadow-parts-1/)\n  — W3C:s Working Draft från den 16 december 2025, som definierar `part`,\n  `exportparts` och pseudoelementet `::part()`.\n\n\u003chttps://engineer.company/sv/glossary/web-components/\u003e\n","date_modified":"2026-11-09T21:50:25Z","description":"Hur custom elements, shadow trees och elementen template och slot ger ett team egna HTML-taggar, med ett genomgånget exempel och de vanliga fällorna.","formats":{"gemtext":"https://engineer.company/sv/glossary/web-components/index.gmi","gopher":"https://engineer.company/sv/glossary/web-components/gophermap","html":"https://engineer.company/sv/glossary/web-components/","json":"https://engineer.company/sv/glossary/web-components/index.json","markdown":"https://engineer.company/sv/glossary/web-components/index.md","pdf":"https://engineer.company/sv/glossary/web-components/index.pdf"},"kind":"page","language":"sv","title":"Vad är web components?","url":"https://engineer.company/sv/glossary/web-components/","version":1}