Jamdesk Documentation logo

Plano de fundo

Escolha uma decoração (gradiente, grade de pontos, manchas translúcidas ou plana), defina a cor de fundo da página por modo ou ajuste a cor e o tamanho do gradiente Jam.

O bloco background em docs.json controla o plano de fundo da página. Escolha um de quatro tratamentos de decoração, substitua a cor base por modo ou ajuste o gradiente padrão.

docs.json
{
  "theme": "jam",
  "background": {
    "decoration": "none",
    "color": {
      "light": "#faf7f2",
      "dark": "#0a0a0d"
    }
  }
}

Todos os campos são opcionais. Omita o bloco background inteiro para usar os padrões do tema.

decoration

Escolha o tratamento de plano de fundo para o modo claro do tema Jam. Cada valor renderiza um padrão distinto sobre a cor base --color-bg-primary. O modo escuro sempre renderiza sólido.

docs.json
{
  "background": {
    "decoration": "grid"
  }
}
ValorComportamento
gradient (padrão)Gradiente radial ancorado no topo. Ajustável pelo bloco gradient abaixo
gridPadrão sutil de grade de pontos: pontos de 1,5px em --color-primary com 8% de opacidade, espaçamento de 24px
windowsDuas manchas radiais suaves nos cantos superiores (visual translúcido estilo Windows 11)
nonePreenchimento plano --color-bg-primary, sem decoração

decoration afeta apenas o modo claro do tema Jam. Nebula e Pulsar renderizam fundos sólidos independentemente. O modo escuro do Jam sempre renderiza sólido.

color

Substitua a cor de fundo da página por modo. Aceita qualquer cor CSS: hex, rgb(...), rgba(...) ou hsl(...).

docs.json
{
  "background": {
    "color": {
      "light": "#faf7f2",
      "dark": "#0a0a0d"
    }
  }
}
CampoAplica-se a
color.lightFundo do corpo no modo claro
color.darkFundo do corpo no modo escuro

Defina apenas light para substituir o modo claro e manter o padrão escuro do tema. Defina apenas dark para o inverso. Isso funciona em todos os temas: Jam, Nebula, Pulsar, Halo e Dusk.

Combine decoration: "none" com uma substituição de color para um fundo plano e com a identidade da marca. Isso é comum em documentações de estilo editorial ou de marketing.

gradient

Ajuste o gradiente radial do modo claro do tema Jam. Todos os campos são opcionais e se aplicam de forma independente. Defina apenas color para mudar a cor, ou apenas size para reduzir ou ampliar.

docs.json
{
  "background": {
    "gradient": {
      "color": "#a855f7",
      "size": "800px",
      "position": "top center",
      "opacity": 0.25
    }
  }
}
CampoPadrãoDescrição
colorHerda colors.primaryCor do gradiente (qualquer cor CSS)
size500pxRaio. Qualquer comprimento CSS (px, rem, %, vh)
positiontop centerPonto central. Palavras-chave top/bottom/center/left/right, porcentagens ou coordenadas em pixels
opacity0.12Opacidade máxima no centro. Número entre 0 e 1

gradient só se aplica quando decoration é gradient (ou não definido). As decorações grid, windows e none ignoram este bloco. grid e windows usam a cor do padrão a partir de --color-primary. Altere-a no bloco colors.

Suporte dos navegadores

O gradiente paramétrico (consumo de variáveis CSS) usa color-mix(), que requer:

  • Chrome / Edge 111+
  • Firefox 113+
  • Safari 16.2+

Navegadores mais antigos voltam ao gradiente original do Jam e ignoram as substituições de gradient.

Receitas comuns

docs.json
{
  "background": {
    "decoration": "none",
    "color": {
      "light": "#faf7f2",
      "dark": "#0a0a0d"
    }
  }
}

Comum em documentações de estilo editorial. Funciona em qualquer tema.

docs.json
{
  "background": {
    "gradient": {
      "color": "#a855f7",
      "opacity": 0.15
    }
  }
}

Recolore o gradiente Jam sem alterar seu tamanho ou posição.

docs.json
{
  "background": {
    "gradient": {
      "size": "1200px",
      "position": "top left",
      "opacity": 0.2
    }
  }
}

Gradiente mais largo e difuso, ancorado no canto superior esquerdo.

docs.json
{
  "background": {
    "decoration": "grid"
  }
}

Pinta uma grade de pontos de 24px discreta na cor primária do seu tema. Altere a cor dos pontos com colors.primary em docs.json.

docs.json
{
  "background": {
    "decoration": "windows"
  }
}

Duas manchas radiais suaves nos cantos superiores, ancoradas à janela de visualização. Usa --color-primary para a cor das manchas.

docs.json
{
  "background": {
    "color": {
      "dark": "#0d0d12"
    }
  }
}

Mantém os padrões do tema no modo claro e define um fundo personalizado para o modo escuro.

O que vem a seguir?

Temas

Escolha um tema base e substitua cores

CSS personalizado

Substitua qualquer coisa que o CSS possa alterar

Identidade visual

Logotipos, favicons e recursos de marca