Guia de padrões
Guia de padrões
Os blocos que a gente usa para montar o site. Cada exemplo é o HTML de verdade: copia, troca o texto e pronto.
01
Princípios
Seis regras. Quando uma decisão ficar em dúvida, volta pra cá.
- Celular simples e pouca banda primeiro. O site tem que abrir rápido numa conexão ruim.
- 2D é a base, 3D é camada. O 3D enfeita por cima. Nunca é o único jeito de usar.
- Contraste e alvo de toque de 44 px. Se não dá pra ler e tocar, não serve.
- A gota é a assinatura. É metal em fusão: gradiente de fogo com grão. Gota nunca tem contorno.
- O nome CIBERLURGIA nunca é gradiente. Sempre preto, giz ou cor sólida. O fogo é só da gota, da faixa e da borda.
- Texto direto. Frase curta, verbo na frente, sem enfeite.
02
Cores
Cada cor tem um trabalho. Sem dúvida, use preto, concreto e giz. A forja aparece como fogo, não como texto de parágrafo.
Preto
--preto#000000
Texto, borda e fundo onde o fogo brilha.
Concreto
--concreto#D2D1CB
Fundo claro. Sempre com grão.
Giz
--giz#F5F4F0
Papel e cartões. Texto sobre preto.
Grafite
--grafite#4A4A47
Texto secundário sobre claro.
Cinza
--cinza#8A8984
Texto secundário sobre preto. Arame frio.
Cereja
--cereja#6E0000
Forja a cerca de 750 °C. Fundo do hover em Mais procurados.
Forja
--forja#E8180C
Forja a cerca de 900 °C. Texto só sobre preto, ou título grande no claro. Fundo de botão com texto preto.
Brasa
--brasa#FF5A00
Forja a cerca de 1.000 °C. Linha de hover do menu.
Fusão
--fusao#FFC400
Forja a cerca de 1.100 °C. Destaque sobre preto, grifo e foco no topo.
Incandescente
--incand#FFF4CF
Forja a cerca de 1.300 °C. Brilho da gota e texto claro sobre o fogo.
Arco
--arco#2D2DFF
Contraponto frio. Fundo de botão e linha. Texto em giz por cima.
Arco claro
--arco-claro#7C82FF
Texto e linha sobre preto.
Fogo
--fogogradiente
Gradiente só em gota, faixa (.fio-fogo) e borda, sempre sobre grão. Nunca em texto.
Regra da forja
Forja sobre preto: funciona.
Forja em texto pequeno sobre giz: não usa.
Uma amostra de cor (a grade acima é uma lista disso)
Ver código
<li class="pp-cor">
<span class="pp-cor__amostra" style="background:var(--forja)" aria-hidden="true"></span>
<div>
<p class="pp-cor__nome">Forja <code>--forja</code></p>
<p class="cota">#E8180C</p>
<p>Texto só sobre preto, ou título grande no claro.</p>
</div>
</li>03
Tipografia
Quatro famílias, cada uma com uma função. Não troca de lugar. Escala: texto 17 px, cota 14 px, subtítulo 22 px, seção 64 px, capa 120 px ou mais. O nome CIBERLURGIA é sempre preto ou cor sólida, sem gradiente.
--f-estencilCBL Estencil (Big Shoulders Stencil 900): título, palavra de ordem e número grande, em caixa alta.--f-geoCBL Jost 500 e 700: subtítulo, rótulo, botão e chamada.--f-tecCBL Normógrafo (Osifont): cota, carimbo, data e legenda.--f-textoAtkinson Hyperlegible 400 e 700: texto corrido e formulário.
Títulos e cotas
Santo André · ABC Paulista
Oficina aberta
Quem está na bancada
Ver HTML
<p class="cota">Santo André · ABC Paulista</p>
<h3 class="titulo-estencil">Oficina aberta</h3>
<p class="titulo-secao">Quem está na bancada</p>Título gigante: cor sólida, nunca gradiente (regra: o nome nunca tem gradiente)
Solda
Ver HTML
<p class="titulo-estencil titulo-estencil--gigante">Solda</p>Texto longo
Texto corrido vai nessa caixa. Ela limita a linha em cerca de 68 caracteres, que é o ponto em que a leitura não cansa.
Subtítulo de seção
Um parágrafo a mais, pra ver o espaço entre eles.
Ver HTML
<div class="texto-longo">
<p>Texto corrido vai nessa caixa. Ela limita a linha em cerca de 68 caracteres, que é o ponto em que a leitura não cansa.</p>
<h2>Subtítulo de seção</h2>
<p>Um parágrafo a mais, pra ver o espaço entre eles.</p>
</div>04
Faixas
Faixa é o fundo de uma seção. Preta pra destaque, concreto pra base, giz pra leitura. O fio-fogo é a régua de gradiente com grão, a única faixa de fogo.
Três faixas de fundo
faixa-preta
Capa e destaque. Texto em giz.
faixa-concreto
O padrão. Fundo com grão, texto preto.
faixa-giz
Papel liso, pra texto longo e leitura.
Ver HTML
<div class="faixa-preta pp-faixa"><p class="cota">faixa-preta</p><p>Capa e destaque. Texto em giz.</p></div>
<div class="faixa-concreto pp-faixa"><p class="cota">faixa-concreto</p><p>O padrão. Fundo com grão, texto preto.</p></div>
<div class="faixa-giz pp-faixa"><p class="cota">faixa-giz</p><p>Papel liso, pra texto longo e leitura.</p></div>
<div class="fio-fogo" role="presentation"></div>05
Gota
A gota é a assinatura do site. Aparece no mosaico da capa e nos cartões sem foto, sem contorno nenhum. A forma pulsa devagar, e para quando o aparelho pede movimento reduzido.
As cinco cores da gota
Ver HTML
<figure class="pp-gota"><span class="gota gota--forja" aria-hidden="true"></span><figcaption class="cota">gota--forja</figcaption></figure>
<figure class="pp-gota"><span class="gota gota--brasa" aria-hidden="true"></span><figcaption class="cota">gota--brasa</figcaption></figure>
<figure class="pp-gota"><span class="gota gota--fusao" aria-hidden="true"></span><figcaption class="cota">gota--fusao</figcaption></figure>
<figure class="pp-gota"><span class="gota gota--cereja" aria-hidden="true"></span><figcaption class="cota">gota--cereja</figcaption></figure>
<figure class="pp-gota"><span class="gota gota--arco" aria-hidden="true"></span><figcaption class="cota">gota--arco</figcaption></figure>data-gota e data-cor
Ver HTML
<a class="pp-gota-link" href="/linkoteca/" data-gota="linkoteca" data-cor="forja" data-transicao>
<span class="gota gota--forja" aria-hidden="true"></span>Linkoteca
</a>data-gota: identificador da gota. Todo elemento comdata-gotavira uma gota clicável no modo 3D.data-cor: a cor da gota. Uma deforja,brasa,fusao,arcooucereja.
06
Botões
O botão tem sombra e sobe no hover. O principal é o de fogo; os outros são apoio.
Botões
Ver HTML
<div class="pp-linha">
<a class="botao" href="#botoes">Giz</a>
<a class="botao botao--fogo" href="#botoes">Fogo</a>
<button class="botao botao--arco" type="button">Arco</button>
<button class="botao botao--icone" type="button" aria-label="Próxima">→</button>
</div>
<div class="faixa-preta pp-faixa">
<a class="botao" href="#botoes">Botão sobre preto</a>
</div>Um botão de fogo por bloco. Botão de só ícone precisa de aria-label. O botão é compacto (cerca de 32 px de altura); a área de toque de 44 px vem de um pseudo-elemento invisível.
07
Campos e busca
Campo tem borda preta, sem arredondar. Foco aparece em azul. Todo campo tem rótulo visível.
Busca e select
Ver HTML
<div class="busca" role="search">
<label class="busca__rotulo" for="pp-busca">O que você procura?</label>
<div class="busca__linha">
<input class="busca__campo" id="pp-busca" type="search" placeholder="certidão, edital, Mauá…" autocomplete="off">
<button class="botao botao--fogo" type="button">Buscar</button>
</div>
</div>
<label class="filtros__cidade">
<span class="cota">Cidade</span>
<select class="campo" id="pp-cidade">
<option>Todas</option>
<option>Santo André</option>
<option>Mauá</option>
</select>
</label>Campo de busca sem name: o texto fica no navegador e não vai para o servidor. Ids sempre com prefixo único.
08
Chips e selos
Chip filtra. Selo marca a categoria. A bolinha tem a cor da categoria.
Chips (filtros)
Ver HTML
<div class="pp-linha">
<a class="chip chip--ativo" href="#chips">Todas</a>
<a class="chip chip--forja" href="#chips">Editais</a>
<a class="chip chip--arco" href="#chips">Conselhos</a>
<button class="chip chip--brasa" type="button" aria-pressed="true">Tecnologia</button>
</div>Selos de categoria
Cultura Mídia livre Conselhos
Ver HTML
<p class="pp-linha">
<span class="selo-cat selo-cat--cereja">Cultura</span>
<span class="selo-cat selo-cat--fusao">Mídia livre</span>
<span class="selo-cat selo-cat--arco">Conselhos</span>
</p>Chip ativo: chip--ativo ou aria-pressed="true". Cores: forja, brasa, fusao, arco e cereja.
09
Cartões e listas
Cartão é a peça básica: topo com foto ou gota, título, texto e um botão. Listas usam as mesmas cores e fontes.
Cartão
Ver HTML
<article class="cartao">
<div class="cartao__corpo">
<p class="cota">Categoria ou data</p>
<h3 class="cartao__titulo"><a href="#cartoes">Título do cartão</a></h3>
<p>Um parágrafo curto, uma ou duas linhas.</p>
<a class="botao botao--fogo" href="#cartoes">Abrir</a>
</div>
</article>Item de lista de links
-
Nome do link
Para que serve, numa frase.
Ver HTML
<ul class="resultados">
<li class="link-item">
<a class="link-item__titulo" href="#cartoes">Nome do link <span aria-hidden="true">↗</span></a>
<p>Para que serve, numa frase.</p>
<p class="link-item__meta cota"><span class="selo-cat selo-cat--forja">Editais</span><span>Santo André</span><span>exemplo.org</span></p>
</li>
</ul>Mais procurados
Mais procurados
Ver HTML
<section class="procurados" aria-labelledby="pp-t-procurados">
<h3 class="titulo-secao" id="pp-t-procurados">Mais procurados</h3>
<ol class="procurados__lista">
<li><a href="#cartoes"><span class="procurados__n">1</span>Nome do link</a></li>
<li><a href="#cartoes"><span class="procurados__n">2</span>Outro link</a></li>
</ol>
</section>Pessoa do coletivo
-
Ricardo Palmieri
Na bancada
Uma frase sobre o que a pessoa faz na oficina.
Ver HTML
<ul class="carrossel" aria-label="Exemplo de pessoa">
<li class="pessoa" data-gota="pessoa-exemplo" data-cor="arco">
<div class="pessoa__retrato" aria-hidden="true"><span class="blob blob--arco"><span class="blob__iniciais">RP</span></span></div>
<h3 class="pessoa__nome">Ricardo Palmieri</h3>
<p class="cota pessoa__funcao">Na bancada</p>
<p class="pessoa__bio">Uma frase sobre o que a pessoa faz na oficina.</p>
<ul class="pessoa__contatos">
<li><a href="#cartoes">Contato</a></li>
</ul>
</li>
</ul>Lista de links da Linkoteca usa item_link(), em app/views/paginas.php. Não copie o HTML na mão.
11
Conteúdo editável
O que o painel edita, arquivo por arquivo. Campo de link e de imagem têm regra própria no núcleo.
Estas coleções ficam em conteudo/*.json e são editadas no painel, em /admin. A tabela sai de app/esquemas.php, então muda sozinha quando o esquema muda.
| Arquivo | Nome no painel | Formato | Campos (tipo) |
|---|---|---|---|
conteudo/site.json | Textos gerais | um registro só | Nome do coletivo texto Frase curta texto Descrição para buscadores textarea Chamada da capa textarea E-mail de contato email Redes e contatos links Texto do rodapé textarea |
conteudo/paginas.json | Páginas de texto | lista, chave: slug | Identificador slug Título texto Subtítulo texto Texto markdown Imagem imagem |
conteudo/categorias.json | Categorias da Linkoteca | lista, chave: slug | Identificador slug Nome texto Descrição textarea Cor da gota selecao |
conteudo/links.json | Linkoteca | lista, chave: id | Identificador slug Título texto Endereço url Para que serve textarea Categoria referencia Abrangência selecao Palavras-chave tags Destaque na capa da Linkoteca booleano Última verificação data |
conteudo/ferramentas.json | Ferramentas úteis | lista, chave: id | Identificador slug Nome texto Endereço url Para que serve textarea Imagem imagem Quem fez texto Palavras-chave tags |
conteudo/pessoas.json | Pessoas do coletivo | lista, chave: id | Identificador slug Nome texto Na bancada texto Mini bio textarea Foto imagem Contatos links |
conteudo/diario.json | Diário (posts) | lista, chave: slug | Identificador slug Título texto Data data Resumo textarea Texto markdown Imagem imagem Palavras-chave tags Publicado booleano |
Como o PHP lê uma coleção
Ver código
$pessoas = ler_colecao('pessoas'); // lista de arrays, um por pessoa12
Acessibilidade e peso
Antes de publicar uma página nova, passa por esta lista.
- Forja como texto só sobre preto, ou em título grande no claro.
- Alvo de toque de 44 px no mínimo (botão compacto com área invisível ao redor).
- Contraste AA: 4,5 para 1 em texto, 3 para 1 em título grande e borda.
- Gota sem contorno preto. Nome CIBERLURGIA sem gradiente.
- Foco de teclado visível: azul sobre claro, amarelo sobre preto.
- Toda imagem tem
alt. Se for decorativa,alt="". - Botão só com ícone tem
aria-label. - Imagem com
widtheheight, pra a tela não pular. - Imagens em webp ou svg, fontes em woff2. Nada de script novo sem motivo.
- Movimento: a gota pulsa devagar, e o CSS corta isso com movimento reduzido.
- A página abre e se lê sem JS. Teste desligando o JS.
- Sem CSS inline, a não ser a cor da amostra.
Dúvida ou coisa que falta aqui? A gente ajusta. Voltar ao manual.