Field Notes
The Dimensional Model

Emphasis

How loudly a component communicates — the visual weight and intensity of its signal.

Definition

Emphasis controls the surface area and intensity of a sentiment's expression. It answers: how urgently must the user receive this signal?

Values

ValueMeaningVisual expression
highMaximum presenceSolid backgrounds, strong color, full visibility
mediumModerate presenceTinted or bordered surfaces
lowMinimal presenceReduced saturation, no background, reduced border

In Semantic Token Naming

The emphasis scale maps to token naming as:

weaker → weak → (standard/omitted) → strong

For example:

  • --background-neutral-weaker-rest — weakest neutral background at rest
  • --background-neutral-rest — standard neutral background
  • --border-neutral-strong-hover — strong neutral border on hover

The Emphasis-Sentiment Relationship

Emphasis and Sentiment are independent axes, but their combination carries semantic weight. Low emphasis degrades a sentiment's signal across multiple properties simultaneously — reducing color intensity, saturation, and the presence of background or border surfaces.

This is intentional: it enables advisory communication without alarming the user.

However, this degradation creates a legibility floor. A warning at low emphasis may visually approach neutral. This is only appropriate when the warning is genuinely advisory rather than critical.

Hard Rule

The combination of sentiment + emphasis must reflect the actual urgency of the content. Reducing emphasis to lower visual weight when the situation is genuinely critical is a semantic error — not an aesthetic choice.

Decision Guide

For action elements (buttons, links, interactive controls):

Content criticalityCorrect combination
User's action is blocked or irreversiblewarning + high
User should be aware but can proceedwarning + medium
User may want to know, not blockingwarning + low
Positive distinction, prominenthighlight + high
Positive distinction, ambienthighlight + low

For container elements (banners, cards, panels) — containers default to neutral with appropriate emphasis for visibility, escalating to a specific sentiment only when the situation is imminent or blocking. See Sentiment for the container vs action pattern.

On this page