Galeria de cases em scroll horizontal

Uma faixa de cases que sangra até as duas bordas da página e rola para o lado, com encaixe (scroll-snap) e barra de rolagem escondida. Cada card é uma foto 4:3 em cinza parcial que ganha cor e um passo de zoom sob o ponteiro; no canto de cima aparece um distintivo redondo na cor de marca, e no rodapé da própria imagem ficam o nome e o tipo do trabalho. O cabeçalho traz título à esquerda e, à direita, a dica "Arraste para ver" com uma seta que cutuca a cada 2,2s — mais dois botões que fazem a faixa andar de card em card.

É a segunda entrada da categoria mídia e a primeira galeria horizontal da biblioteca.

Quando usar

• Portfólio de capas: cases, projetos, imóveis, unidades, edições — coisas que se reconhecem pela foto e pelo nome, e que continuam existindo depois da terceira.
• Quando a lista é longa demais para uma grade e curta demais para uma página própria. A faixa mostra 2 ou 3 e promete o resto sem ocupar altura.
• Como dobra de respiro entre duas seções densas: uma faixa horizontal quebra o ritmo vertical da página sem precisar de contraste de tom.
• Quando cada item tem destino próprio (uma página de case). O card é um <a>; se não houver para onde ir, o componente promete algo que não entrega.

Quando não usar

• Menos de 4 cards. Em desktop largo eles cabem na tela, o trilho não sai do lugar, o script esconde a dica e os botões — e sobra um flex comum que uma grade faria melhor.
• Quando os itens precisam ser comparados. Scroll horizontal esconde o que está fora da tela; comparação exige tudo à vista.
• Quando o item tem texto. Aqui cabem duas linhas de legenda dentro da foto e nada mais. Item com descrição pede listas/leque-paineis.
• Acima da dobra. A faixa depende de um gesto lateral que ninguém faz antes de entender a página.
• Como única navegação para conteúdo importante. Faixa horizontal é vitrine; o índice completo tem de existir em outro lugar.

Contra os vizinhos

galeria-pasta é uma pilha que abre; aqui nada abre — a faixa já está aberta e só anda. leque-paineis mostra um item por vez em largura variável; aqui todos os cards têm o mesmo tamanho e a hierarquia é a ordem, não o foco.

Padrão editorial

Quantidade: 4 a 8. Abaixo de 4 não há faixa. Acima de 8, quem chega ao fim rolou por mais de duas telas e meia sem um índice — e a faixa vira um túnel.

Escreva os nomes juntos. A legenda é o único texto do card, e nomes de comprimentos muito diferentes fazem a linha de base dançar de um card para o outro.

Especificação das imagens

Por que ph-wide-* no preview. A caixa é 4:3 paisagem. Os ph-wide-* são 16:9 e perdem as laterais no recorte — perda pequena e realista. Os ph-* são retrato 3:4 e perderiam mais da metade da altura para caber em 4:3: o preview mostraria um recorte que ninguém entregaria de verdade. São cinco ph-wide-* na pasta de demonstração, e por isso o padrão tem cinco cards — repetir foto num portfólio lê como erro, não como placeholder.

Como usar

Cole markup.html, estilo.css e script.js. Depende do core (tokens, base, motion) e de mais nada.

A sangria — como o trilho sai da coluna

O contrato (§4) proíbe margem negativa e proíbe mexer na coluna. A solução aqui tem duas partes:

1. O trilho é irmão do .wrap, não filho. O cabeçalho fica dentro do .wrap e recebe a coluna; o <ul class="hgal-track"> é filho direto da <section> e por isso já nasce com a largura da página. Nada precisa ser puxado para fora de lugar nenhum.

2. O primeiro card se alinha à coluna por um recuo próprio, não por margem:

--hgal-inset:max(var(--pad),calc((100% - var(--max)) / 2 + var(--pad)));

É a mesma conta que o .wrap faz — metade da sobra da página, mais o respiro lateral — só que aplicada como padding-inline do trilho. Em tela estreita a sobra é negativa e o max() devolve --pad, que é exatamente onde a coluna encosta. O trilho lê os mesmos --pad e --max do tema: mudou a coluna, a faixa acompanha sozinha.

O mesmo valor vai em scroll-padding-inline, senão o encaixe alinha os cards na borda da tela e não na da coluna — e o scrollIntoView do script erra pelo mesmo tanto.

O 100% da conta é a largura da seção. Se o trilho for parar dentro de outro contêiner com respiro próprio, a conta passa a medir a caixa errada e o alinhamento quebra sem erro nenhum no console.

O acesso por teclado

O original não tinha nenhum: a faixa só andava com gesto de trackpad ou de toque. Quem usa mouse sem roda horizontal, teclado ou leitor de tela ficava no primeiro card — roda vertical não move contêiner que rola no eixo x, a página rola no lugar dele. São três camadas:

O deslocamento é sempre scrollIntoView({inline:'start', block:'nearest'}), nunca scrollLeft na mão — assim quem decide onde o card para continua sendo o scroll-padding do CSS. behavior vira auto sob prefers-reduced-motion, lendo LIB.reduce do core. O block:'nearest' é o que impede a página inteira de saltar na vertical a cada seta.

Quando o foco entra num card por Tab, o script rola a faixa até ele em vez de deixar o navegador dar o pulo seco. Nas setas o foco vai com preventScroll:true justamente para o pulo não acontecer antes do deslizar.

Ganchos

Variações

Gotchas

• As setas parecem quebradas no painel de preview do Claude Code, e não estão. O deslocamento usa scrollIntoView({behavior:'smooth'}); o browser embarcado do painel ignora smooth e não rola nada, enquanto 'auto' funciona normalmente. Em navegador de verdade as setas andam.

Como confirmar sem se enganar, pelo console do painel:

js const t = document.querySelector('.hgal-track'); t.querySelectorAll('.hgal-card')[1] .scrollIntoView({behavior:'auto', inline:'start', block:'nearest'}); t.scrollLeft; // > 0 significa que a lógica está certa

Se 'auto' rola e 'smooth' não, é o ambiente. A mesma armadilha atinge qualquer componente que dependa de rolagem suave.

• O trilho tem de ser filho direto da seção. O 100% de --hgal-inset mede a largura do pai. Embrulhou o trilho em outra caixa, o primeiro card desalinha da coluna e nada avisa.

• scroll-padding-inline não é decoração. Sem ele o encaixe e o scrollIntoView param os cards na borda da tela, colados na margem, enquanto o cabeçalho continua na coluna. O erro é discreto e constante.

• O script lê paddingLeft, não scrollPaddingLeft — e isso é obrigatório. O valor computado de scroll-padding guarda a função de math inteira ("max(71.25px, 50% - 548.75px)"), porque a propriedade aceita porcentagem e só resolve na hora do uso. parseFloat nisso devolve NaN, o recuo vira zero e os dois botões passam a rolar para o card em que já estão — falha silenciosa, sem erro no console. padding-inline computa em px e vale o mesmo número. Se você mudar um dos dois no CSS, mude o outro junto: é o único acoplamento entre a folha e o script.

• A barra de rolagem some nos três motores (scrollbar-width, -ms-overflow-style, ::-webkit-scrollbar). É a razão de os botões existirem: escondida a barra, some também o último indício visual de que há mais conteúdo. Se você tirar os botões, devolva a barra.

• Os cards fora da tela só revelam quando entram nela. data-rv usa IntersectionObserver, que considera o recorte do contêiner que rola: card à direita da faixa não está intersectando, então entra com fade e blur no momento em que a pessoa o traz. É comportamento desejado — mas quem espera todos prontos de saída vai achar que travou. Por isso só os três primeiros escalonam com data-d: do quarto em diante, delay atrasaria o que a pessoa acabou de pedir.

• loading="lazy" em todas as fotos é uma troca, não um consenso. A dobra está bem abaixo do topo e as fotos de fora da faixa custariam banda à toa. Em compensação, num arrasto muito rápido pode aparecer um card ainda em branco. Se isso incomodar no projeto, tire o lazy dos dois primeiros cards — nunca de todos.

• O texto sobre a foto lê --light, não --fg. O card é uma ilha escura: dentro dele o fundo é sempre a foto sob véu escuro, mesmo que a seção seja clara. Se trocar por --fg, a faixa quebra no dia em que alguém a puser numa .sec-paper — e só ali.

• A pílula do tipo é a .pill do core, retonalizada. .hgal-cap .hgal-type tem seletor duplo de propósito: .pill e .hgal-type têm a mesma especificidade, e o contrato §6 proíbe depender de qual folha carregou primeiro. Forma, respiro e tracking continuam vindo do core; só cor e borda mudam.

• overflow-y:hidden corta o anel de foco. O padding-block:6px 10px do trilho existe só para o outline de 2px com 3px de recuo caber. Tirou o padding, o foco do card fica cortado em cima e embaixo — e é o único sinal de onde o teclado está.

• Não usa .glass. São 4 a 8 cards dentro de um contêiner que rola: um backdrop-filter em cada custa quadro em scroll de toque, e .glass ainda pressupõe fundo escuro. Borda --rule e a própria foto entregam a mesma leitura de graça.

• Não usa .sec-head. A primitiva do core é cabeçalho centrado; este é de dois lados, com a dica olhando o título. Não é o mesmo objeto.

• Os dois botões são a primitiva .btn-disc do core, e o markup traz as duas classes (class="btn-disc hgal-btn"). A regra do disco estava copiada ao caractere em cinco pastas — midia/galeria-scroll-horizontal, midia/carrossel-anel-3d, midia/carrossel-foco-central, midia/pilha-swipe e midia/roda-de-cards — e foi promovida ao core/base.css em 2026-09-03, como o §6 do contrato manda fazer já na terceira. Forma, cor, hover e o estado desabilitado vêm de lá; o parafuso é --disc-size. Não é .btn: aquela é pílula de texto, com padding horizontal fixo. O aviso que esta ficha trazia — "se um terceiro componente pedir disco de ícone, promova ao core" — foi cumprido.

• @media (hover:none) acende o distintivo. Sem ponteiro não existe hover, e sem essa regra o disco de marca ficaria invisível para sempre em celular e tablet.

• Sob prefers-reduced-motion o hover não morre, encolhe. A seta para de cutucar, a foto para de dar zoom e o distintivo para de saltar — mas cor e opacidade continuam, senão o card deixa de responder ao ponteiro e vira uma foto morta.

Histórico

O que mudou na extração:

Calibragem no primeiro uso. Espere ajustar a largura do card e a quantidade — as duas decisões que dependem do acervo de fotos do cliente.