Skip to content

tokens global and semantic

Ben Elan edited this page Oct 16, 2024 · 1 revision

tags: [tokens]

Global & Semantic Tokens

Global and Semantic tier tokens define design patterns shared across the system. The calcite component background scale color.foreground.1, color.foreground.2, color.foreground.3 is an example of Semantic tokens. While Global and Semantic tokens can be considered somewhat interchangeable, only Semantic tokens have compound values for specific context-modes like "light" and "dark". Global tokens always have a single value that is a reference to either a Semantic or Core token. The most common use case is for setting the system defaults. Global and Semantic tokens are used throughout the calcite components either directly or through component tokens like button.color.background.

corner-radius.default = corner-radius.sharp

That way, if the system ever needs to adjust the exact value of corner-radius.default we can do so without causing major breaking changes.

New Global & Semantic Tokens

Due to the cascade of effects changes to Global and Semantic tier tokens will cause. Updates must go through a long approval process. Please loop in Skye, Franco, and Ali