Installasjon
Relevante lenker
Bruk
Det skal være tilstrekkelig å legge til følgende der du har stylelint konfigurasjonen din (f.eks. .stylelintrc eller i package.json).
Om du vil at reglene skal bli strengere (warning -> error), så kan det gjøres i rules.
Regler
aksel/design-token-exists
Tester bruk av reserverte token prefikser --a og --ac mot Aksel. Gir error ved bruk av ikke-eksisterende token.
aksel/design-token-no-global-override
Tester overskriving av globale/semantiske tokens. Disse er ikke meningen at man skal overskrive, med unntak når man themer løsningen sin til et annet brand/sub-brand.
I de tilfellene man overskriver disse, anbefaler vi å trekke alle disse inn i en enkel config-fil, for så å slå av regelen for bare den filen.
aksel/design-token-no-component-reference
Tester mot bruk av komponent-tokens med prefix --ac. Disse er ment for å bare overskrives, men ikke tas i bruk i egne løsninger. Grunnen til dette er at de ikke er definert som standard, noe som kan føre til uventede sideeffekter.
aksel/no-internal-tokens
Forbyr bruk eller overstyring av interne CSS-variabler brukt i Aksel. Interne variabler bør ikke brukes utenfor designsystemet, og de kan endres eller fjernes uten varsel. Vær oppmerksom på at regelen bare sjekker prefikset til tokenet, og ikke om det faktisk finnes i designsystemet. Selv om de ikke eksisterer, bør prefiksene til designsystemet unngås.
aksel/no-class-override
Advarer når du prøver å overstyre stiler fra Aksel (@navikt/ds-css). Regelen sjekker om du bruker klasser som starter med .navds eller .navdsi.
Se dokumentasjon for theming hvis du ønsker å theme løsningen din.
Overstyring av stiler i designsystemet frarådes. Vi ønsker å ha et mest mulig konsistent utseende og følelse på tvers av applikasjoner fra NAV. Overstyring av klasser introduserer også teknisk gjeld i løsningene dine da dette lett kan brekke ved senere oppdateringer av designsystemet.
aksel/no-deprecated-classes
Advarer når du prøver å bruke utdaterte CSS klassenavn.