Design Tokens (DTCG) format (.tokens)

Formatet Design Tokens (DTCG) leser W3C Design Tokens Community Group-tokenfiler (.tokens / .tokens.json), JSON-utvekslingsformatet som brukes av Style Dictionary, Tokens Studio og lignende verktøy.

Tokenverdier er typede designdata (farger, dimensjoner, skriftfamilier, aliaser), ikke naturlig språk, så formatet trekker ut bare den lesbare $description-dokumentasjonen på tokens og grupper som tekstinnhold; alle token-$value-, $type- og $extensions-felt samt den omkringliggende strukturen passerer gjennom urørt. Deteksjon krever den unike .tokens-utvidelsen og sjekker DTCG-innhold ($value + $type); .tokens.json-filer løses til JSON-formatet basert på utvidelsen med mindre -f designtokens er angitt. Rundtur er byte-tro, arvet fra JSON-leseren/skriveren.

IDdesigntokens

SourceBuilt-in

Extensions.tokens

CapabilitiesRead + Write

Parameters

Parameter	Type	Default	Description
extractDescriptions	boolean	true	Pakk ut $description-verdier (lesbar token- og gruppedokumentasjon) som oversettbare blokker. Dette er det eneste naturlige språkfeltet i DTCG; $value er alltid en typet designverdi (farge, dimensjon, skriftnavn, …) og pakkes aldri ut. Deaktiver for å lese filen som en fullstendig ikke-oversettbar struktur.

Configure it live

Configuration

Loading form…

Configuration output

vs defaults no changes

apiVersion: neokapi/v1
kind: DesigntokensFormatConfig
metadata:
  name: designtokens
spec:
  # (default configuration)

Examples

Deaktiver uttrekk av beskrivelser

Behandle filen som fullstendig ikke-oversettbar.

extractDescriptions: false

Processing notes

• Kun $description trekkes ut; tokenverdier og struktur er ikke-oversettbar gjennomstrømning.

• En tokenfil uten $description gir null blokker, noe som er forventet for maskinegenererte tokensett.

← Back to the Format Reference