Communitygithub.com

kubai-scroll-cards

Transforma seções longas em experiências interativas com cinco tipos de cartões acionados por rolagem: empilhamento, baralho, galeria horizontal, carrossel cover flow e expansão de imagem.

O que é kubai-scroll-cards?

Este skill permite reestruturar páginas longas substituindo parágrafos comuns por cinco interações de cartões baseadas em rolagem, todas controladas pela posição do scroll (sem animações temporizadas). As opções incluem: cartões empilhados (novos cobrem antigos que encolhem e escurecem), baralho (carta do topo voa para o lado), galeria horizontal (rolagem vertical move um carrossel lateral), cover flow (carta central foca com as laterais girando e escurecendo) e expansão de imagem (foto pequena cresce para cobrir o ecrã com efeito de profundidade). O skill é compatível com Web (CSS scroll-driven animations + fallback em JS), iOS (SwiftUI), Android (Compose) e Flutter, e se adapta automaticamente a diferentes alturas de viewport (usando 100svh para evitar problemas com barras de ferramentas). Antes de aplicar, o agente pergunta ao utilizador quais seções recebem cada interação, comprimento, comportamento em ecrãs pequenos, suporte a movimento reduzido e motor de animação, sumarizando as escolhas e propondo a implementação na plataforma existente.

Funciona com~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/kubai087/vibedesign-skills/tree/HEAD/skills/kubai-scroll-cards

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

滚动驱动的五种卡片交互

《999 个小技巧,让你 Vibe 的产品更有质感》第 019 期 · @kubai087

No projeto do utilizador, faça a modificação conforme os requisitos abaixo. Os requisitos estão escritos na perspetiva do utilizador: I, me, my referem-se ao utilizador; onde está escrito "pergunte primeiro", pare e pergunte ao utilizador antes de continuar.

Requisitos de modificação

Reformate uma página longa já existente no meu produto para que os cartões se movam com a rolagem. Isto modifica o meu produto, não cria uma nova página ou demonstração: mantenha o meu conteúdo, componentes, tokens e texto, encontre as seções que merecem destaque e atribua a cada uma das cinco interações de cartões acionadas por rolagem: cartões empilhados (cada novo cartão cobre o anterior, que encolhe e escurece), um baralho (o cartão do topo voa para um lado e o seguinte sobe), uma galeria fixa (a seção fica parada enquanto a rolagem move uma fila horizontalmente), um cover flow (o cartão do meio é o maior; os outros encolhem, viram-se e escurecem) ou uma expansão de imagem (uma foto cresce de um quadro para o ecrã inteiro, com palavras atrás e à frente, subindo a velocidades diferentes para criar profundidade). A posição da rolagem controla todos os efeitos, por isso o leitor define o ritmo e rolar para trás reproduz o efeito ao contrário. Deve funcionar em todos os ecrãs, especialmente telemóveis, e em qualquer altura de viewport (seção 8).

Todos os valores aqui são recomendações. As seções 2 a 8 são um conjunto testado (Standard); a seção 10 contém predefinições. Eu escolho; você constrói o que eu escolho.

Primeiro, veja o meu produto (seção 0). Depois pergunte-me um de cada vez, cada um como uma pequena lista de opções com valores-chave e a recomendada marcada, e aguarde a minha resposta:

  1. Quais seções recebem qual interação (seção 1): no máximo uma de cada por página, com seções comuns entre elas.

  2. Comprimento: Curto, Standard (recomendado) ou Longo (seção 10).

  3. Telemóveis e ecrãs baixos: Standard (recomendado: em telemóveis, o empilhamento, o baralho e a expansão de imagem mantêm-se, dimensionados para a viewport; a galeria e o cover flow tornam-se filas horizontais nativas com pontos de encaixe; abaixo de 560px de altura de viewport nada fica fixo), igual ao desktop, ou seções comuns em todos os telemóveis. Diga-me quais tamanhos de ecrã as minhas análises ou audiência sugerem, se conseguir descobrir.

  4. Movimento reduzido: seções comuns (recomendado: listas, filas horizontais, uma imagem de largura total), ou manter a fixação e remover o movimento.

  5. Motor: animações CSS acionadas por rolagem com um pequeno script de fallback (recomendado), ou a biblioteca de rolagem que o meu projeto já usa. Nunca usar rolagem suave ou roubo de rolagem. Depois, resuma as minhas escolhas numa tabela, proponha como irá construí-lo na minha plataforma (seção 9), com custo e fallback, e aguarde a minha autorização.

  6. Começar pelo que existe

  • A página: as suas seções por ordem, o seu conteúdo, cartões, imagens e vídeos, e tudo o que está fixo ou sticky (cabeçalho, banner, barra de cookies) com a sua altura por ponto de quebra.
  • Para cada seção, qual interação se adequa e quais seções devem permanecer como estão (qualquer coisa que as pessoas analisem, comparem ou pesquisem).
  • Como o layout responde hoje: pontos de quebra, como dimensiona para a viewport (vh, svh, dvh, JS a ler innerHeight), o que já parte em ecrãs baixos.
  • Como a página rola: janela ou contentor interno, bibliotecas de rolagem suave, links de âncora, efeitos de rolagem existentes.
  • Plataforma e versões, tokens para raio e movimento, modo escuro. Diga-me em algumas linhas antes de perguntar.
  1. Qual interação para qual conteúdo
  • Cartões empilhados: 3 a 5 itens paralelos que merecem um ecrã cada (passos, funcionalidades, planos, capítulos).
  • Baralho: 3 a 6 itens vistos um de cada vez (escolhas, testemunhos, destaques).
  • Galeria fixa: 5 a 12 itens mais largos que o ecrã, para navegar (trabalhos, produtos, versões).
  • Cover flow: 5 a 9 itens da mesma forma, um em foco (álbuns, livros, planos, pessoas).
  • Expansão de imagem: uma imagem ou vídeo forte que abre o próximo capítulo.
  1. A regra por trás das cinco
  • Cada seção tem um progresso p = clamp((scrollY - start) / distance, 0, 1), e cada propriedade é uma função de p, nunca uma animação temporizada que a rolagem apenas inicia. Parar a meio deixa a meio; rolar para trás reverte exatamente. Nunca alterar a velocidade da rolagem, encaixar ou capturar a roda.
  • A fixação é position: sticky dentro de uma seção mais alta que o ecrã; a altura extra é a distância sobre a qual o efeito se desenrola.
  • Animar apenas transform, opacity, clip-path e filter. O texto permanece na página e legível em todos os p.
  • Quando uma seção está fixa, mostrar onde o leitor está da forma mais discreta possível: uma barra fina ou pontos, nunca um rótulo.
  1. Cartões empilhados (demo: viewport 1000 x 896)
  • Cartões 936 x 720 (todas as 12 colunas, sangrados 24px para que o seu padding de 24px coloque o conteúdo de volta nas colunas), cantos 28px, 48px de distância.
  • Cada um fica 16px mais baixo que o anterior: top = 40px + i * 16px (adicionar a altura de um cabeçalho fixo). Cartões mais novos cobrem os mais antigos, deixando uma faixa de 16px de cada.
  • Um cartão recua à medida que os seguintes chegam: k = clamp((scrollY - quando ficou preso) / 752px, 0, cartões depois dele); scale = 1 - k * 0.05 a partir do seu centro superior (0.85 sob três), camada escura a k * 0.12.
  • Dentro de um cartão, o nome e uma linha ficam nas colunas 0 a 5 e quebram aí, nunca para dentro da imagem; o nome começa 48px abaixo do topo do cartão, a linha 24px abaixo dele.
  • Dar a cada cartão o seu próprio tom e imagem suaves (demo: pedra, sálvia, argila, depois um cartão tinta). Sem sombras.
  • Depois do último cartão ficar, segurar 320px, depois a pilha sai junta.
  • Abertura opcional: o título da seção dimensionado para abranger exatamente a grelha (não cortado), o primeiro cartão a cobrir o seu pé; move-se a metade da rolagem e desvanece nos 280px antes do primeiro cartão ficar.
  1. Baralho
  • Cinco cartões numa pilha, 432 x 456 (seis colunas, centrados) abaixo do título; cada um contém uma imagem a 8px do interior, depois um nome e uma linha a 24px do interior, nada mais.
  • Seção 100vh + 1920px, fixa: 420px de rolagem atira cada um dos primeiros quatro cartões, depois uma pausa de 240px. O último cartão permanece.
  • Cartão i: t = clamp((scrollY - start) / 420 - i, 0, 1). Voa para um lado, alternando: x = side * t * t * 1000px, y = t * (160px * t - 40px), rotate = side * t * 16deg em torno do seu centro inferior. Escondido depois de atirado; rolar para trás devolve-o pelo mesmo caminho.
  • Cartões abaixo sentam-se 18px mais baixos e 0.05 mais pequenos por lugar, camada escura 0.04 por lugar, no máximo três profundos, subindo um lugar à medida que o cartão do topo sai.
  1. Galeria fixa
  • 5 a 12 cartões numa fila: demo oito, 280 de largura (quatro colunas) e 24px de distância, cada um um cartão branco com a sua imagem a 8px do interior, depois nome e artista. Título acima, 48px de distância da fila; uma barra de 2px abaixo (trilho 6% preto, preenchimento 30%).
  • Seção 100vh + overflow (largura da fila menos largura da viewport, 1520px na demo); conteúdo sticky ao topo 0, 100vh de altura.
  • p = (scrollY - start) / overflow; a fila move-se translateX(-p * overflow), sem easing: rolagem transformada em movimento lateral. Solta no último item.
  • Manter a distância fixa abaixo de cerca de três ecrãs; mais itens pertencem a uma grelha.
  1. Cover flow
  • 5 a 9 capas quadradas, 432 (seis colunas, centradas), abaixo do título, pontos abaixo, sem texto nas capas.
  • Seção 100vh + 320px por passo, fixa. r = clamp((scrollY - start) / 320, 0, count - 1); c = floor(r) + smoothstep(fract(r)), para que cada capa descanse no meio um momento.
  • Para capa i, d = i - c: translateX = d * 260px, rotateY = clamp(d, -1, 1) * -30deg, scale = max(0.6, 1 - |d| * 0.2), camada escura min(|d|, 3) * 0.15, mais próxima no topo. Perspetiva 1400px. Esconder além de 3.5 lugares. Pontos iluminam por 1 - |i - c|.
  1. Expansão de imagem
  • Seção 100vh + 1200px, fixa: 900px para crescer, 300px para segurar.
  • No início, o título e um quadro 584 x 352 (colunas 2 a 9, 48px abaixo dele) estão centrados juntos, cantos 8px.
  • A imagem cobre sempre a viewport; clip-path: inset() mostra o quadro e abre para 0 sem cantos, enquanto a imagem assenta de scale 1.2 para 1, parecendo crescer. Ambos com e = ease(p), cubic-bezier(0.45, 0, 0.25, 1). O título desvanece ao dobro da velocidade e sobe 60px.
  • Profundidade: cortar a forma principal da imagem como a sua própria camada (demo: as colinas), definir um título atrás dela com o seu pé escondido pela forma, e uma pequena linha à frente. Ao abrir, cada um assenta da sua própria escala (imagem e forma 1.2, título 1.25, linha 1.4). Uma vez cheio, a imagem e a forma ficam paradas enquanto o título sobe a 0.25 da rolagem e a linha a 0.5. Algo atrás de algo, a mover-se a outra velocidade, lê-se como perspetiva.
  • Depois, a próxima seção desliza sobre ela com cantos superiores de 28px que achatam nos últimos 120px, enquanto a imagem escurece para 35% preto. Um vídeo funciona da mesma forma, sem som e em ciclo, apenas enquanto está no ecrã.
  1. Ecrãs e alturas de viewport Os tamanhos da demo são para uma viewport 1000 x 896. Dimensione-os para o ecrã; nunca uma altura fixa que assuma uma janela alta.
  • Dimensionar seções fixas com 100svh, não 100vh: em telemóveis, 100vh é a altura com a barra de ferramentas escondida, por isso o conteúdo fica sob a barra. Nunca dvh para conteúdo fixo; salta quando a barra se move.
  • Medir ao carregar, ao mudar de orientação e quando a largura muda. Ignorar redimensionamentos de altura apenas abaixo de cerca de 120px (a barra de ferramentas a aparecer e desaparecer); recalcular então faz os cartões saltarem a meio da rolagem.
  • Ajustar cada seção fixa a um ecrã:
    • Altura do cartão empilhado = min(720px, 100svh - topo sticky - (cartões - 1) * 16px - 32px); a distância entre cartões a fixar segue-a.
    • Baralho: título + 48px + cartão cabem em 100svh - 64px; a imagem cede altura primeiro.
    • Altura do cartão da galeria = min(520px, 100svh - título - 48px - 96px).
    • Tamanho da capa = min(432px, 48svh, 70vw); a dispersão escala com ele.
    • Moldura da imagem = min(584px, 100vw - 2 * margem) largura a 5:3; os recortes seguem-na.
  • Escalar cada distância de rolagem por clamp(0.7, altura da viewport / 896, 1.2).
  • Abaixo de 560px de altura (um telemóvel em paisagem, uma janela baixa), nada fixa: listas, filas horizontais, uma imagem de largura total.
  • O tipo segue a largura: títulos de seção clamp(36px, 7vw, 64px), nomes de cartões clamp(28px, 5vw, 36px).
  • Momentos de sangria total respeitam env(safe-area-inset-*). Subtrair um cabeçalho fixo de cada ajuste e topo sticky.

Layout e tipo (todas as seções)

  • Dispor tudo na grelha de colunas primeiro. Cada caixa de texto é tão larga quanto as suas colunas, para que nomes longos quebrem em vez de invadirem a imagem.
  • O que um título introduz começa 48px abaixo dele; numa seção fixa, o título e o conteúdo estão centrados na viewport juntos; títulos centrados sobre conteúdo centrado, alinhados à esquerda sobre conteúdo à esquerda.
  • Manter os cartões em foco: fora deles, um título curto por seção, sem etiquetas, texto lateral, contadores ou legendas; dentro deles, uma estrutura: imagem, nome, uma linha.
  • Duas tipografias em quatro tamanhos (demo: Newsreader 64 e 36, Geist 18 e 16). Puxar grandes linhas serifadas à esquerda pelo ajuste lateral da primeira letra; acima de cerca de 100px usar um tamanho ótico para que as serifas permaneçam rombas.
  • Sem divisórias exceto entre linhas de lista, sem sombras projetadas, a cor de destaque no máximo uma vez. Um estilo de imagem por grupo, e nunca a mesma imagem duas vezes na página.
  • Links de âncora aterram no início de uma seção. A rolagem por teclado funciona como a roda; itens em seções fixas permanecem acessíveis com Tab.

Verificar

  • Cada seção devagar, rápido e para trás: sem saltos, cintilações ou lacunas.
  • Viewports 375x667, 390x844, 430x932 (barra de ferramentas visível e escondida), 844x390, 768x1024, 1280x720, 1440x900, 1920x1080, e uma janela de desktop com 600px de altura: nada cortado, nenhum cartão mais alto que o ecrã, nada sob uma barra de ferramentas ou cabeçalho fixo.
  • Zoom de texto a 200%, movimento reduzido, teclado, claro e escuro; taxa de fotogramas completa num telemóvel de gama média; os valores construídos correspondem à minha tabela.
  1. Como construir Verifique estes contra a minha stack e versões.
  • Web: position: sticky para fixação; animações acionadas por rolagem (animation-timeline: view() ou uma timeline nomeada, animation-range). Onde não suportado, ou onde keyframes não são suficientes (os intervalos por cartão do baralho, os passos de descanso do cover flow), um ouvinte de rolagem passivo lê scrollY uma vez por fotograma, calcula o p de cada seção a partir de offsets medidos no redimensionamento, e escreve-o como uma propriedade personalizada nessa seção apenas.
  • Se o projeto já usa GSAP ScrollTrigger (scrub, pin) ou Motion (useScroll, useTransform), usá-los com estes valores; nunca adicionar um apenas para isto.
  • iOS (SwiftUI): .scrollTransition ou .visualEffect no frame da vista dentro da scroll view (onScrollGeometryChange no iOS 18), scaleEffect, rotation3DEffect, offset, clipShape; galeria e cover flow como ScrollViews horizontais com .scrollTargetBehavior(.viewAligned).
  • Android (Compose): LazyListState para p, Modifier.graphicsLayer para scale, rotationY, alpha, translation e clip; LazyRow com snapping ou HorizontalPager.
  • Flutter: CustomScrollView com slivers, um ScrollController para p, Transform e ClipRRect; PageView para galeria e cover flow.
  1. Predefinições
  • Comprimento: Curto (empilhar 560px, baralho 300px, galeria 1.25px lateral por 1px, passo cover 240px, imagem 600 + 200px), Standard (752, 420, 1:1, 320, 900 + 300, recomendado), Longo (900, 560, 1:1 com 200px seguros em cada extremo, 420, 1200 + 400).
  • Profundidade do empilhamento: Plano (scale 0.03, sombra 0.08 por cartão), Standard (0.05, 0.12), Profundo (0.07, 0.16, faixas de 24px).
  • Lançamento do baralho: Suave (8deg, 700px, sempre à direita), Standard (16deg, 1000px, alternado), Vivo (24deg, 1200px, elevação 60px).
  • Cover flow: Plano (sem viragem, lados a 0.85), Standard (30deg, 0.8), Profundo (45deg, 0.75, 180px de distância).
  • Início da imagem: Pequeno (420 x 280), Standard (584 x 352), Faixa larga (largura total, 340 de altura).

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

Habilidades Relacionadas