Navngivningskonventioner for tokens

Uensartede tokennavne gør det umuligt at forudsige, hvad en token gør, uden at læse dens værdi. En klar og forudsigelig navngivningskonvention er grundlæggende for et skalerbart tokensystem.

Et almindeligt mønster er: [category]-[property]-[variant]. Eksempler: color-text-primary, color-text-secondary, spacing-inset-sm. Hvert segment indsnævrer betydningen gradvist.

Undgå paletnavne som blue-500 i komponenter. Brug semantiske navne: color-action-default, color-feedback-error. Semantiske navne forbliver gyldige, når brandfarver ændres, uden at komponenterne skal opdateres.

Tilføj tilstanden til sidst: color-button-bg-default, color-button-bg-hover, color-button-bg-disabled. Ensartede endelser for tilstande gør tokensæt forudsigelige og komplette.

Brug enten T-shirt-størrelser (xs, sm, md, lg, xl) eller numeriske skalaer (100, 200...900) konsekvent. Numeriske skalaer gør det muligt at indsætte mellemliggende værdier, mens T-shirt-størrelser er mere læsevenlige i små sæt.

I systemer med flere brands eller produkter skal du sætte et navnerum foran tokens: brand-a-color-primary kontra brand-b-color-primary. Navnerum forhindrer konflikter, når tokensæt flettes sammen.

Kebab-case kan oversættes direkte til CSS-brugerdefinerede egenskaber: color-text-primary bliver til --color-text-primary. Tokens i camel-case kræver en transformation, mens tokens i kebab-case ikke gør.

Gode navne er selvforklarende: spacing-stack-md (lodret afstand mellem stablede elementer, mellemstor) kommunikerer hensigten uden en kommentar. Dårlige navne som s3 kræver ekstern dokumentation for at kunne forstås.

Når tokens først er taget i brug, er omdøbninger inkompatible ændringer. Brug aliasser til forældede tokens: Behold det gamle navn, men lad det referere til den nye token. Giv de systemer, der bruger tokenen, en migreringsperiode, før du fjerner forældede tokens.

Kontrollér tokennavne med brugerdefinerede regler i Style Dictionary eller et CI-script. Afvis tokens, der ikke følger navngivningsmønsteret. Automatisk håndhævelse forhindrer navneafvigelser, efterhånden som systemet vokser.

Udgiv en navngivningsvejledning med eksempler på korrekte og ukorrekte navne. Afhold en kort workshop, så design- og udviklingsteams er enige om konventionerne, før systemet skaleres. Ensartethed kræver en fælles forståelse, ikke kun dokumentation.

En konsekvent navngivningskonvention for tokens, der bruger mønstre af typen kategori-egenskab-variant, semantiske navne, tilstandssuffikser og navneområdeforpræfikser, gør tokensystemer forudsigelige, selvforklarende og robuste over for brandændringer uden at ødelægge komponentkoden.