Como criar um componente de histórias

Uma visão geral básica de como criar uma experiência semelhante ao Instagram Stories na Web.

Nesta postagem, quero compartilhar ideias sobre como criar um componente de Stories para a Web que seja responsivo, ofereça suporte à navegação pelo teclado e funcione em vários navegadores.

Demonstração

Se você preferir uma demonstração prática de como criar esse componente de Stories, confira o codelab do componente de Stories.

Se você prefere vídeos, confira a versão deste post no YouTube:

Visão geral

Dois exemplos conhecidos de UX de Stories são os Stories do Snapchat e do Instagram (sem mencionar os Fleets). Em termos gerais de UX, as Stories costumam ser um padrão exclusivo para dispositivos móveis, centrado em toques, para navegar por várias assinaturas. Por exemplo, no Instagram, os usuários abrem o story de um amigo e passam pelas fotos dele. Geralmente, eles fazem isso com muitos amigos ao mesmo tempo. Ao tocar no lado direito do dispositivo, o usuário pula para a próxima história desse amigo. Ao deslizar para a direita, o usuário pula para outro amigo. Um componente de matéria é bastante semelhante a um carrossel, mas permite navegar em uma matriz multidimensional, em vez de uma matriz unidimensional. É como se houvesse um carrossel dentro de cada carrossel. 🤯

Matriz multidimensional visualizada usando cards. Da esquerda para a direita, há uma pilha de cards com bordas roxas, e dentro de cada um deles há um ou mais cards com bordas ciano. Lista em uma lista.
1º carrossel de amigos
2º carrossel "empilhado" de histórias
👍 Lista em uma lista, ou seja, uma matriz multidimensional

Escolher as ferramentas certas para o trabalho

No geral, achei esse componente bem simples de criar, graças a alguns recursos essenciais da plataforma da Web. Vamos falar sobre eles.

Grade CSS

Nosso layout não foi um problema para a grade CSS, já que ela está equipada com algumas maneiras eficientes de organizar o conteúdo.

Layout de amigos

Nosso wrapper de componente .stories principal é uma visualização de rolagem horizontal que prioriza dispositivos móveis:

.stories {
  inline-size: 100vw;
  block-size: 100vh;

  display: grid;
  grid: 1fr / auto-flow 100%;
  gap: 1ch;

  overflow-x: auto;
  scroll-snap-type: x mandatory;
  overscroll-behavior: contain;
  touch-action: pan-x;
}

/* desktop constraint */
@media (hover: hover) and (min-width: 480px) {
  max-inline-size: 480px;
  max-block-size: 848px;
}
Uso do Modo de dispositivo do Chrome DevTools para destacar as colunas criadas pelo Grid

Vamos analisar o layout de grid:

  • Preenchemos explicitamente a janela de visualização em dispositivos móveis com 100vh e 100vw e limitamos o tamanho em computadores.
  • / separa nossos modelos de linha e coluna
  • auto-flow significa grid-auto-flow: column
  • O modelo de fluxo automático é 100%, que, neste caso, é a largura da janela de rolagem.

Em um smartphone, pense nisso como o tamanho da linha sendo a altura da janela de visualização e cada coluna sendo a largura da janela de visualização. Continuando com o exemplo das histórias do Snapchat e do Instagram, cada coluna será a história de um amigo. Queremos que as histórias dos amigos continuem fora da janela de visualização para que haja um lugar para rolar. A grade vai criar quantas colunas forem necessárias para organizar o HTML de cada história de amigo, criando um contêiner de rolagem dinâmico e responsivo. O Grid permitiu centralizar todo o efeito.

Acúmulo

Para cada amigo, precisamos das histórias em um estado pronto para paginação. Para me preparar para a animação e outros padrões divertidos, escolhi uma pilha. Quando digo "pilha", quero dizer como se você estivesse olhando para um sanduíche de cima, não de lado.

Com a grade CSS, podemos definir uma grade de célula única (ou seja, um quadrado), em que as linhas e colunas compartilham um alias ([story]), e cada filho é atribuído a esse espaço de célula única com alias:

.user {
  display: grid;
  grid: [story] 1fr / [story] 1fr;
  scroll-snap-align: start;
  scroll-snap-stop: always;
}
.story {
  grid-area: story;
  background-size: cover;
  …
}

Isso coloca o HTML no controle da ordem de empilhamento e também mantém todos os elementos no fluxo. Não foi preciso fazer nada com o posicionamento de absolute ou z-index, nem corrigir a caixa com height: 100% ou width: 100%. A grade pai já definiu o tamanho da janela de visualização da imagem da matéria, então nenhum desses componentes precisou ser instruído a preenchê-la.

Pontos de ajuste de rolagem CSS

A especificação de pontos de ajuste de rolagem do CSS (link em inglês) facilita o bloqueio de elementos na janela de visualização ao rolar. Antes de essas propriedades CSS existirem, era preciso usar JavaScript, e isso era… complicado, para dizer o mínimo. Confira Introducing CSS Scroll Snap Points (em inglês) de Sarah Drasner para uma ótima explicação de como usá-los.

Rolagem horizontal sem e com estilos scroll-snap-points. Sem ele, os usuários podem rolar livremente como de costume. Com ele, o navegador repousa suavemente em cada item.
familiar responsável
.stories {
  display: grid;
  grid: 1fr / auto-flow 100%;
  gap: 1ch;
  overflow-x: auto;
  scroll-snap-type: x mandatory;
  overscroll-behavior: contain;
  touch-action: pan-x;
}
O elemento pai com rolagem esticada define o comportamento de ajuste.
uma criança
.user {
  display: grid;
  grid: [story] 1fr / [story] 1fr;
  scroll-snap-align: start;
  scroll-snap-stop: always;
}
As crianças escolhem ser um alvo de ajuste.

Escolhi os pontos de ajuste de rolagem por alguns motivos:

  • Acessibilidade sem custo financeiro. A especificação de pontos de ajuste de rolagem afirma que pressionar as teclas seta para a esquerda e seta para a direita deve mover os pontos de ajuste por padrão.
  • Uma especificação em crescimento. A especificação de pontos de ajuste de rolagem está recebendo novos recursos e melhorias o tempo todo, o que significa que meu componente de Stories provavelmente só vai melhorar daqui em diante.
  • Facilidade de implementação. Os pontos de ajuste de rolagem são praticamente criados para o caso de uso de paginação horizontal centrada em toque.
  • Inércia livre no estilo de plataforma. Cada plataforma vai rolar e descansar no próprio estilo, ao contrário da inércia normalizada, que pode ter um estilo de rolagem e descanso estranho.

Compatibilidade com vários navegadores

Testamos no Opera, Firefox, Safari e Chrome, além do Android e do iOS. Confira um breve resumo dos recursos da Web em que encontramos diferenças de recursos e suporte.

No entanto, alguns CSSs não foram aplicados, então algumas plataformas estão sem as otimizações de UX. Gostei de não precisar gerenciar esses recursos e tenho certeza de que eles vão chegar a outros navegadores e plataformas.

scroll-snap-stop

Os carrosséis foram um dos principais casos de uso de UX que motivaram a criação da especificação de pontos de ajuste de rolagem do CSS. Ao contrário das histórias, um carrossel nem sempre precisa parar em cada imagem depois que um usuário interage com ele. Pode ser aceitável ou até incentivado percorrer o carrossel rapidamente. Por outro lado, as histórias são mais bem navegadas uma por uma, e é exatamente isso que o scroll-snap-stop oferece.

.user {
  scroll-snap-align: start;
  scroll-snap-stop: always;
}

No momento, o scroll-snap-stop só é compatível com navegadores baseados no Chromium. Confira as atualizações em Compatibilidade com navegadores. No entanto, isso não é um bloqueador. Isso significa apenas que, em navegadores não compatíveis, os usuários podem pular um amigo acidentalmente. Portanto, os usuários terão que ser mais cuidadosos ou precisaremos escrever um JavaScript para garantir que um amigo pulado não seja marcado como visualizado.

Leia mais na especificação se tiver interesse.

overscroll-behavior

Você já estava rolando um modal quando, de repente, começou a rolar o conteúdo por trás dele? overscroll-behavior permite que o desenvolvedor capture essa rolagem e nunca a deixe sair. É bom para todos os tipos de ocasiões. Meu componente de Stories o usa para evitar que outros gestos de deslizar e rolar saiam do componente.

.stories {
  overflow-x: auto;
  overscroll-behavior: contain;
}

O Safari e o Opera eram os dois navegadores que não ofereciam suporte a isso, e está tudo bem. Esses usuários vão ter uma experiência de rolagem esticada como estão acostumados e talvez nunca percebam essa melhoria. Eu gosto muito desse efeito e o incluo em quase todos os recursos de rolagem esticada que implemento. É uma adição inofensiva que só pode levar a uma melhoria na UX.

scrollIntoView({behavior: 'smooth'})

Quando um usuário toca ou clica e chega ao fim do conjunto de Stories de um amigo, é hora de passar para o próximo amigo no conjunto de pontos de ajuste de rolagem. Com o JavaScript, conseguimos referenciar o próximo amigo e solicitar que ele seja rolado para visualização. O suporte para os conceitos básicos é ótimo. Todos os navegadores rolaram para mostrar o elemento. Mas nem todos os navegadores faziam isso 'smooth'. Isso significa que ela é rolada para a visualização em vez de ser fixada.

element.scrollIntoView({
  behavior: 'smooth'
})

O Safari era o único navegador que não aceitava behavior: 'smooth' aqui. Confira as atualizações em Compatibilidade com navegadores.

Prático

Agora que você sabe como eu fiz, como você faria?! Vamos diversificar nossas abordagens e aprender todas as maneiras de criar na Web. Crie uma demonstração, envie um tweet com sua versão e eu vou adicioná-la à seção Remixes da comunidade abaixo.

Remixes da comunidade