← Biblioteca componentes/listas/grade-artigos/ficha.md CódigoTela cheia
listas/grade-artigos

Grade de artigos com destaque

🟢 estavel complexidade baixa prefixo art- blog artigos conteudo carta analise data institucional

Incluir · as linhas que se colam num site novo, depois do core (CLAUDE.md §10)

<link rel="stylesheet" href="componentes/listas/grade-artigos/estilo.css">
<script src="componentes/listas/grade-artigos/script.js"></script>

markup.html · 99 linhas · 4,6 KB

<!-- ==========================================================================
     GRADE DE ARTIGOS — cartas, análises e relatórios, com data como estrutura
     Prefixo: art-
     Requer: core (tokens, base, motion.css, motion.js) + este estilo.css e
             este script.js (opcional: só concede o selo "Novo")

     Um artigo em destaque, com foto e o texto DENTRO dela, e ao lado uma
     lista tipográfica de três a quatro — sem foto, porque ninguém tem foto
     boa para cada carta mensal, e foto de banco em cada card é o que faz
     blog de assessoria parecer blog de assessoria.

     A DATA É ESTRUTURA, NÃO ENFEITE. Todo artigo traz <time datetime>, e é
     dela que o script tira o selo "Novo" — que NUNCA se escreve à mão no
     markup: selo escrito fica lá para sempre, e em seis meses a home diz
     "Novo" sobre uma carta de março. Concedido pela data, ele some sozinho.
     Mesmo método do dados/cards-cotacoes e da prova/manchetes-imprensa.

     O CARD INTEIRO É CLICÁVEL, com um link só: o <a> do título se estica
     sobre o card com ::after. Nada de segundo link nem onclick no <article>.

     HOVER NÃO MEXE NA FOTO (CLAUDE.md §6): o destaque acende o véu e
     sublinha o título, e só.
     ========================================================================== -->

<section class="sec-paper sec-pad art" data-art data-art-novo="14">
  <div class="wrap">

    <div class="art-topo">
      <div>
        <span class="eyebrow" data-rv>Conteúdos</span>
        <h2 class="sec-title ttl">Cartas e <em>análises</em></h2>
      </div>
      <a class="art-todos" href="#conteudos" data-rv>Ver todos os conteúdos
        <svg width="13" height="13" viewBox="0 0 14 14" fill="none" stroke="currentColor" stroke-width="1.5" stroke-linecap="round" stroke-linejoin="round" aria-hidden="true"><path d="M2 7H12M8 3L12 7L8 11"/></svg>
      </a>
    </div>

    <div class="art-grade">

      <div class="art-destaque-slot" data-rv>
        <article class="art-destaque sec-dark">
          <img class="art-img" src="../../../showroom/demo/ph-wide-2.webp" alt="" loading="lazy" decoding="async">
          <div class="art-legenda">
            <p class="art-meta">
              <span class="art-cat">Carta mensal</span>
              <time class="art-data" datetime="2026-09-24">24 set 2026</time>
              <span class="art-tempo">8 min de leitura</span>
            </p>
            <h3 class="art-titulo">
              <a class="art-link" href="#carta-setembro">Juros altos por mais tempo: o que muda na carteira de quem vive de renda</a>
            </h3>
            <p class="art-linha">Alongar prazo agora exige olhar a liquidez antes da taxa — e três perguntas antes de qualquer troca.</p>
          </div>
        </article>
      </div>

      <div class="art-lista" data-rv data-d="1">
        <article class="art-item">
          <p class="art-meta">
            <span class="art-cat">Sucessão</span>
            <time class="art-data" datetime="2026-09-11">11 set 2026</time>
            <span class="art-tempo">6 min</span>
          </p>
          <h3 class="art-titulo">
            <a class="art-link" href="#holding">Holding familiar não é para todo patrimônio — e como saber se é para o seu</a>
          </h3>
          <p class="art-linha">O custo de manter a estrutura, comparado ao do inventário que ela evita.</p>
        </article>

        <article class="art-item">
          <p class="art-meta">
            <span class="art-cat">Mercado</span>
            <time class="art-data" datetime="2026-08-28">28 ago 2026</time>
            <span class="art-tempo">5 min</span>
          </p>
          <h3 class="art-titulo">
            <a class="art-link" href="#credito-privado">Crédito privado depois da onda de recuperações judiciais</a>
          </h3>
          <p class="art-linha">O que olhar numa debênture além da taxa que ela paga.</p>
        </article>

        <article class="art-item">
          <p class="art-meta">
            <span class="art-cat">Internacional</span>
            <time class="art-data" datetime="2026-08-14">14 ago 2026</time>
            <span class="art-tempo">7 min</span>
          </p>
          <h3 class="art-titulo">
            <a class="art-link" href="#offshore">Offshore depois da nova tributação: o que ainda faz sentido</a>
          </h3>
          <p class="art-linha">Três estruturas que continuam de pé, e uma que deixou de valer a pena.</p>
        </article>
      </div>

    </div>

    <p class="nota art-nota" data-rv>Conteúdo informativo. Não constitui recomendação de investimento, oferta ou solicitação de compra ou venda de ativos.</p>
  </div>
</section>

estilo.css · 160 linhas · 6,5 KB

/* ==========================================================================
   GRADE DE ARTIGOS — art-
   Um destaque com foto e texto dentro dela, e uma lista tipográfica ao lado.
   Tokens usados: --bg --fg --fg-2 --fg-muted --rule --rule-2 --accent
                  --accent-ink --dark-rgb --display --radius-media --ease
   Parafuso local:
     --art-proporcao   proporção da foto do destaque (4 / 3.1)
   ========================================================================== */

/* ---------------------------------------------------------------- topo */
.art-topo{
  display:flex;align-items:flex-end;justify-content:space-between;
  gap:24px;flex-wrap:wrap;
}
.art-todos{
  display:inline-flex;align-items:center;gap:10px;
  font-family:var(--display);font-weight:700;font-size:11.5px;
  letter-spacing:.1em;text-transform:uppercase;color:var(--fg-2);
  padding-bottom:4px;border-bottom:1px solid var(--rule-2);
  transition:color .25s,border-color .25s;
}
.art-todos:hover{color:var(--accent-ink,var(--accent));border-color:currentColor}
/* A seta de 4px é a exceção nomeada do §6: ícone dentro do link, tipografia. */
.art-todos svg{transition:transform .3s var(--ease)}
.art-todos:hover svg{transform:translateX(4px)}
@media(prefers-reduced-motion:reduce){.art-todos:hover svg{transform:none}}

/* ---------------------------------------------------------------- grade */
.art-grade{
  display:grid;grid-template-columns:minmax(0,7fr) minmax(0,5fr);
  gap:clamp(24px,3.4vw,52px);
  margin-top:clamp(34px,5vh,52px);
  align-items:stretch;
}

/* ---------------------------------------------------------------- destaque
   Escopo .sec-dark no próprio markup (a exceção nomeada do §3): a foto é uma
   ilha escura dentro de uma seção de papel, e o texto sobre ela lê --fg do
   escopo escuro sem este arquivo redefinir cor nenhuma.

   O slot existe por causa do §5: o data-rv termina em transform:none e
   apagaria qualquer transform do mesmo nó. O reveal mora no slot. */
.art-destaque-slot{display:flex}
.art-destaque{
  position:relative;flex:1;
  display:flex;align-items:flex-end;
  min-height:420px;
  aspect-ratio:var(--art-proporcao,4 / 3.1);
  overflow:hidden;border-radius:var(--radius-media);
  background:var(--bg);
}
.art-img{
  position:absolute;inset:0;width:100%;height:100%;object-fit:cover;
  filter:brightness(.78);
  transition:filter .5s var(--ease);
}
/* HOVER NÃO MEXE NA FOTO (CLAUDE.md §6): ela só acende. */
.art-destaque:hover .art-img,
.art-destaque:focus-within .art-img{filter:brightness(.9)}

/* A legenda DENTRO da foto, ancorada embaixo (§6). O véu é da própria
   legenda (::before), medido pela altura dela e não do card: título de três
   linhas em tela estreita nunca sai do gradiente. Precedente:
   midia/grade-cases-foto. */
.art-legenda{
  position:relative;z-index:1;
  padding:clamp(22px,3vw,36px);
  display:grid;gap:12px;
}
.art-legenda::before{
  content:"";position:absolute;inset:-60px 0 0;z-index:-1;pointer-events:none;
  background:linear-gradient(to top,rgba(var(--dark-rgb),.92) 0%,rgba(var(--dark-rgb),.64) 55%,transparent 100%);
  backdrop-filter:blur(6px);-webkit-backdrop-filter:blur(6px);
  -webkit-mask-image:linear-gradient(to top,#000 0%,rgba(0,0,0,.9) 44%,transparent 100%);
  mask-image:linear-gradient(to top,#000 0%,rgba(0,0,0,.9) 44%,transparent 100%);
}
.art-destaque .art-titulo{
  font-size:clamp(22px,2.4vw,34px);line-height:1.12;letter-spacing:-.024em;
  max-width:26ch;
}
.art-destaque .art-linha{max-width:52ch}

/* ---------------------------------------------------------------- lista */
.art-lista{display:flex;flex-direction:column;border-top:1px solid var(--rule)}
.art-item{
  position:relative;flex:1;
  display:grid;align-content:start;gap:10px;
  padding:24px 0 26px;
  border-bottom:1px solid var(--rule);
}
/* Realce de hover em OPACIDADE de um véu, e não em background-color: trocar o
   escopo da seção travaria a cor antiga (medido na prova/manchetes-imprensa,
   que registrou o porquê). O véu sangra 14px para os lados para o realce não
   encostar no texto. */
.art-item::before{
  content:"";position:absolute;inset:0 -14px;z-index:0;pointer-events:none;
  background:var(--fg);opacity:0;
  border-radius:var(--radius-media);
  transition:opacity .35s var(--ease);
}
.art-item:hover::before,
.art-item:focus-within::before{opacity:.04}
.art-item > *{position:relative;z-index:1}

/* ---------------------------------------------------------------- tipografia comum */
.art-meta{
  display:flex;flex-wrap:wrap;align-items:center;gap:6px 14px;
  font-size:11.5px;letter-spacing:.06em;color:var(--fg-muted);
}
.art-cat{
  font-family:var(--display);font-weight:700;font-size:10.5px;
  letter-spacing:.14em;text-transform:uppercase;
  color:var(--accent-ink,var(--accent));
}
/* O --accent CRU só dentro do destaque: ali o fundo atrás do glifo é a foto
   com véu, não o --bg do escopo (MANUAL §3 — foto com véu lê --accent). */
.art-destaque .art-cat{color:var(--accent)}
.art-data,.art-tempo{white-space:nowrap}
.art-tempo::before{content:"·";margin-right:14px;opacity:.6}

/* O selo "Novo" não existe no markup: quem o põe é o script, pela data. */
.art-novo{
  font-family:var(--display);font-weight:700;font-size:9.5px;letter-spacing:.14em;
  text-transform:uppercase;color:var(--fg);
  border:1px solid var(--rule-2);border-radius:var(--radius-pill);padding:3px 9px;
}

.art-titulo{
  font-family:var(--display);font-weight:700;
  font-size:clamp(17px,1.5vw,20px);line-height:1.25;letter-spacing:-.014em;
  color:var(--fg);text-wrap:pretty;
}
.art-link{
  color:inherit;
  text-decoration:underline;text-decoration-color:transparent;
  text-underline-offset:.18em;text-decoration-thickness:1px;
  transition:text-decoration-color .3s;
}
/* Um link só, do tamanho do card. */
.art-link::after{content:"";position:absolute;inset:0;z-index:2}
.art-destaque:hover .art-link,
.art-item:hover .art-link{text-decoration-color:currentColor}
/* O anel fica no link, e não no card por :focus-within — este casaria também
   no clique do mouse, e todo card clicado ganharia um contorno. */
.art-link:focus-visible{outline:2px solid var(--accent);outline-offset:4px}

.art-linha{font-size:14.5px;line-height:1.6;color:var(--fg-2)}

/* A tipografia da ressalva é a primitiva .nota do core; aqui só a posição. */
.art-nota{margin-top:clamp(26px,4vh,40px)}

@media(max-width:900px){
  .art-grade{grid-template-columns:1fr}
  .art-destaque{min-height:380px;aspect-ratio:auto}
}
@media(max-width:520px){
  .art-destaque{min-height:440px}
  .art-meta{gap:4px 10px}
  .art-tempo::before{margin-right:10px}
}

script.js · 44 linhas · 2,0 KB

/* ==========================================================================
   GRADE DE ARTIGOS — art-
   Um trabalho só: CONCEDER o selo "Novo" a quem tem data recente.

   O selo nunca é escrito no markup. Escrito, ele fica — e em seis meses a
   home diz "Novo" sobre a carta de março, que é o defeito mais comum de blog
   de empresa. Aqui ele sai da <time datetime> de cada artigo, comparada com
   a data de hoje, e some sozinho quando a janela passa. Sem JavaScript não
   há selo nenhum: a peça nunca afirma novidade que não pode sustentar.

   A janela vem de data-art-novo na raiz, em dias (14 por padrão). Data no
   futuro não ganha selo — é erro de digitação, não novidade.

   Não anima nada e não assina rolagem.
   ========================================================================== */
(function () {
  var raizes = document.querySelectorAll('[data-art]');
  if (!raizes.length) return;                  // guard: sem o componente, saída silenciosa

  var DIA = 864e5;
  var hoje = Date.now();

  [].forEach.call(raizes, function (raiz) {
    var janela = parseInt(raiz.getAttribute('data-art-novo'), 10);
    if (!(janela > 0)) janela = 14;

    [].forEach.call(raiz.querySelectorAll('.art-data[datetime]'), function (t) {
      /* Só a parte AAAA-MM-DD, lida como meio-dia local: Date.parse de uma
         data sem hora a trata como UTC, e às 22h de Brasília o artigo de
         "hoje" já seria de amanhã. */
      var m = /^(\d{4})-(\d{2})-(\d{2})/.exec(t.getAttribute('datetime'));
      if (!m) return;
      var quando = new Date(+m[1], +m[2] - 1, +m[3], 12).getTime();
      var idade = (hoje - quando) / DIA;
      if (idade < -1 || idade > janela) return;
      if (t.parentNode.querySelector('.art-novo')) return;   // idempotente

      var selo = document.createElement('span');
      selo.className = 'art-novo';
      selo.textContent = 'Novo';
      t.parentNode.insertBefore(selo, t.parentNode.firstChild);
    });
  });
})();

A dobra de conteúdos de um site de assessoria: um artigo em destaque, com foto e o texto dentro dela, e ao lado uma lista tipográfica de três — categoria, data, tempo de leitura, título e linha fina. Cada card é um link inteiro. No pé, a ressalva de que conteúdo informativo não é recomendação.

O problema editorial que ela resolve: a carta mensal e a análise de mercado são a prova mais barata de competência que uma casa tem — e a mais mal apresentada. O blog de empresa típico é uma grade de cards iguais com foto de banco em cada um, e todos dizendo "Novo" há seis meses. Aqui só o destaque tem foto, a lista é tipografia, e a novidade é concedida pela data, não escrita.

Quando usar

Quando não usar

Padrão editorial

Slot Regra
Título da seção 2 a 6 palavras, o gênero: Cartas e análises, Research
Ver todos 2 a 5 palavras, leva ao arquivo. Sem arquivo, apague
Categoria 1 a 2 palavras por artigo, sempre do mesmo vocabulário
Título do artigo 6 a 16 palavras, o título real
Linha fina 8 a 22 palavras, por que ler. Ou todos têm, ou nenhum
Tempo de leitura medido: palavras do artigo ÷ 220
Ressalva obrigatória em site financeiro; redação final do jurídico

O que mantém a peça: o destaque é o mais recente. Destacar uma carta antiga porque a foto dela é melhor quebra a leitura cronológica que a lista ao lado promete.

Especificação dos assets

Como usar

<link rel="stylesheet" href="componentes/listas/grade-artigos/estilo.css">
<script src="componentes/listas/grade-artigos/script.js"></script>

O script é opcional: sem ele a dobra funciona inteira, só não aparece o selo "Novo".

Ganchos

Gancho Papel
[data-art] a raiz que o script procura
data-art-novo a janela do selo, em dias. 14
.art-data[datetime] a data de cada artigo, em AAAA-MM-DD. É a fonte do selo
.art-novo o selo, criado pelo script. Nunca escreva no markup
--art-proporcao proporção da foto do destaque. 4 / 3.1

Variações

Compliance

Gotchas

Movimento reduzido / toque

Nada anda sozinho: o que muda no hover é brilho e sublinhado, que o reduce mantém. A seta do "Ver todos" deixa de deslizar. No toque, o card inteiro é o alvo e não há nada que dependa de hover.

Histórico

Origem Quando O quê
autoral 2026-09-29 Construído do zero. Padrão de domínio comum, sem referência única

Origem. A seção de blog das bibliotecas de blocos e a home de research de gestoras e bancos privados — um padrão tão difundido que não tem dono. Nada foi copiado. O registro consolidado vai em projetos/autorais.md.

Por que agora. Comparada com a taxonomia das grandes bibliotecas de seção, a casa não tinha nenhuma forma para conteúdo com data. A tag de vitrine Artigos e agenda nasceu junto, com este componente e o listas/agenda-eventos.

Método herdado. O selo concedido pela data é o motor do dados/cards-cotacoes aplicado a outro objeto: quando a peça faz uma afirmação que não pode sustentar sozinha, o que falta vira estrutura do markup.