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
Emconfig/settings.schema.json:
settingsData da loja.
2. Declare themeLink no schema da section
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:
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:
resolveThemeSettingValue(prop, themeSettings, fallback) se tiver settingsData no contexto.
Checklist do dev de tema
- Id do global em
settings.schema.json(ex.:color_secondary) - Campo da section com
"themeLink": "color_secondary"e default@theme.color_secondary - Componente usa
useThemeSetting(prop, fallback) - Defaults em
schema.jsoncom@theme.color_secondaryonde aplicável - Testar: mudar Tema → Global e ver a section atualizar sem reabrir o inspector