Skip to main content

Settings globais nas sections

Use este padrão quando um campo da section deve seguir o Tema → Global (ex.: cor de destaque), mas ainda permitir override local (“Personalizado”). Fluxo na Corvex Store:

1. Defina o token global

Em config/settings.schema.json:
Esse painel aparece em Theme → Global no editor. O valor salvo fica em settingsData da loja.
Em sections/promo-bar/schema.json:
Várias opções globais:

3. Resolva no componente React

Importe de @corvex/runtime (ou @corvex/theme-host):

API


4. Valor gravado no campo

O inspector grava isso automaticamente quando o lojista escolhe Usar global ou Personalizado.

5. CSS variables (alternativa)

Settings globais também viram CSS vars no canvas/preview: Em CSS do tema:
Use themeLink + useThemeSetting quando o lojista precisa escolher entre global e personalizado no inspector. Use só CSS var quando a section sempre segue o global.

6. Blocks e snippets

Blocks — mesmo padrão: themeLink no schema do block + useThemeSetting no JSX. Snippets — não têm inspector. Receba o valor já resolvido da section pai:
Ou use resolveThemeSettingValue(prop, themeSettings, fallback) se tiver settingsData no contexto.

Checklist do dev de tema

  1. Id do global em settings.schema.json (ex.: color_secondary)
  2. Campo da section com "themeLink": "color_secondary" e default @theme.color_secondary
  3. Componente usa useThemeSetting(prop, fallback)
  4. Defaults em schema.json com @theme.color_secondary onde aplicável
  5. Testar: mudar Tema → Global e ver a section atualizar sem reabrir o inspector