Neste codelab, você vai aprender a criar um componente de layout de navegação lateral deslizante responsivo na Web. Vamos criar o componente aos poucos, começando com HTML, depois CSS e, por fim, JavaScript.
Confira minha postagem do blog Como criar um componente Sidenav para aprender mais sobre os recursos da plataforma da Web CSS escolhidos para criar esse componente.
Configuração
- Clique em Remix to Edit para tornar o projeto editável.
- Abra
app/index.html.
HTML
Primeiro, entenda os conceitos básicos da configuração do HTML para que haja conteúdo e algumas caixas para trabalhar.
Insira o seguinte HTML na tag <body>.
<aside></aside>
<main></main>
O <aside> contém o menu de navegação como um elemento complementar ao <main>, que
contém o conteúdo principal da página.
Em seguida, vamos preencher esses elementos semânticos com o restante do conteúdo da página.
Adicione um elemento de navegação, alguns links de navegação e um link de fechamento dentro do elemento <aside>.
<aside>
<nav>
<h4>My</h4>
<a href="#">Dashboard</a>
<a href="#">Profile</a>
<a href="#">Preferences</a>
<a href="#">Archive</a>
<h4>Settings</h4>
<a href="#">Accessibility</a>
<a href="#">Theme</a>
<a href="#">Admin</a>
</nav>
<a href="#"></a>
</aside>
Os links funcionam muito bem dentro de elementos <nav>, e os elementos <nav> funcionam muito bem em barras laterais <aside>.
Ainda assim, podemos melhorar mais.
No elemento de conteúdo principal, adicione um cabeçalho e um artigo para manter semanticamente o conteúdo do layout.
<main>
<header>
<a href="#sidenav-open" class="hamburger">
<svg viewBox="0 0 50 40">
<line x1="0" x2="100%" y1="10%" y2="10%" />
<line x1="0" x2="100%" y1="50%" y2="50%" />
<line x1="0" x2="100%" y1="90%" y2="90%" />
</svg>
</a>
<h1>Site Title</h1>
</header>
<article>
{put some placeholder content here}
</article>
</main>
O cabeçalho tem o link para abrir o menu. O aside tem o botão de fechar. Em breve, vamos mostrar e ocultar elementos com base no tamanho da janela de visualização.
No elemento <article>, colamos uma frase de marcador de posição. Substitua `` pelo seu próprio conteúdo ou cole o lorem fornecido abaixo:
<h2>Totam Header</h2>
<p>Lorem ipsum dolor, sit amet consectetur adipisicing elit. Cum consectetur, necessitatibus velit officia ut impedit veritatis temporibus soluta? Totam odit cupiditate facilis nisi sunt hic necessitatibus voluptatem nihil doloribus! Enim.</p>
<p>Lorem ipsum dolor sit, amet consectetur adipisicing elit. Fugit rerum, amet odio explicabo voluptas eos cum libero, ex esse quasi optio incidunt soluta eligendi labore error corrupti! Dolore, cupiditate porro.</p>
<h3>Subhead Totam Odit</h3>
<p>Lorem ipsum dolor sit, amet consectetur adipisicing elit. Fugit rerum, amet odio explicabo voluptas eos cum libero, ex esse quasi optio incidunt soluta eligendi labore error corrupti! Dolore, cupiditate porro.</p>
<p>Lorem ipsum dolor sit, amet consectetur adipisicing elit. Fugit rerum, amet odio explicabo voluptas eos cum libero, ex esse quasi optio incidunt soluta eligendi labore error corrupti! Dolore, cupiditate porro.</p>
<h3>Subhead</h3>
<p>Lorem ipsum dolor sit, amet consectetur adipisicing elit. Fugit rerum, amet odio explicabo voluptas eos cum libero, ex esse quasi optio incidunt soluta eligendi labore error corrupti! Dolore, cupiditate porro.</p>
<p>Lorem ipsum dolor sit, amet consectetur adipisicing elit. Fugit rerum, amet odio explicabo voluptas eos cum libero, ex esse quasi optio incidunt soluta eligendi labore error corrupti! Dolore, cupiditate porro.</p>
Esse conteúdo e o tamanho dele vão fazer com que a página seja rolável quando exceder a altura da janela de visualização.
Até agora, você adicionou um elemento aside, com um nav, links e uma maneira de fechar o sidenav. Você também adicionou um cabeçalho, uma forma de abrir a navegação lateral e um artigo ao elemento principal. Isso já é limpo, semântico e atemporal, mas podemos deixar ainda mais limpo e claro para todo mundo. O link aberto na navegação lateral poderia ser marcado de forma mais clara.
Adicione os atributos title e aria-label ao elemento do link de abertura do cabeçalho:
<a href="#sidenav-open" class="hamburger">
<a href="#sidenav-open" title="Open Menu" aria-label="Open Menu" class="hamburger">
O ícone de SVG aberto também poderia ser marcado de forma mais clara. Adicione os seguintes atributos ao SVG dentro do elemento do link aberto:
<svg viewBox="0 0 50 40">
<svg viewBox="0 0 50 40" role="presentation" focusable="false" aria-label="trigram for heaven symbol">
O link de fechamento na navegação lateral poderia ser mais claro.
Adicione os atributos title e aria-label ao elemento do link de fechamento da barra de navegação lateral:
<a href="#"></a>
<a href="#" title="Close Menu" aria-label="Close Menu"></a>
CSS
Hora de organizar os elementos. O conteúdo principal
e a navegação lateral são filhos diretos da tag <body>, então esse é um bom lugar para começar.
Adicione o CSS abaixo a css/sidenav.css para que o elemento <body> organize os filhos.
body {
display: grid;
grid: [stack] 1fr / min-content [stack] 1fr;
@media (max-width: 540px) {
& > :matches(aside, main) {
grid-area: stack;
}
}
}
Esse layout basicamente diz: crie uma linha chamada stack com tudo nela
e duas colunas nessa linha, sendo que a segunda também se chama stack. A primeira coluna
precisa ser dimensionada de acordo com as necessidades mínimas de conteúdo, e a segunda pode ocupar o restante.
Em seguida, se estiver em uma janela de visualização restrita de 540px ou menos, coloque os elementos de navegação lateral e de conteúdo principal
na mesma linha e coluna, resultando em uma sobreposição em uma grade de 1x1.
Com essa funcionalidade de empilhamento responsivo como base, agora podemos usar o estado da barra de URL para alternar a visibilidade e o estilo de transição da navegação lateral.
Atualize o elemento <aside> em app/index.html:
<aside>
<aside id="sidenav-open">
Isso permite que o CSS corresponda a um elemento e ao hash do URL. Isso é importante para o uso do :target.
Agora, o ID do elemento pode corresponder ao hash do URL que vamos definir com as tags <a>.
Além disso, para facilitar a segmentação de JavaScript, adicione IDs para os elementos principais que controlam a navegação lateral. Primeiro, adicione um ID ao link de abertura da barra de navegação lateral:
<a href="#sidenav-open" class="hamburger" title="Open Menu" aria-label="Open Menu">
<a href="#sidenav-open" id="sidenav-button" class="hamburger" title="Open Menu" aria-label="Open Menu">
Em seguida, adicione um ID ao link de fechamento da barra de navegação lateral:
<a href="#" title="Close Menu" aria-label="Close Menu"></a>
<a href="#" id="sidenav-close" title="Close Menu" aria-label="Close Menu"></a>
Isso conclui o layout de empilhamento responsivo da macro <body> e nos vincula à barra de URL.
Vamos continuar.
O <aside> também tem um layout bem organizado. Ele tem dois filhos: um <nav>, que é o componente que parece papel e desliza para fora, e um elemento do link de fechamento <a> que define o URL como #.
O link fica invisível à direita do menu de navegação deslizante. Ele serve para que as pessoas possam "clicar fora" do componente
visual para dispensá-lo.
Adicione o seguinte CSS a css/sidenav.css:
#sidenav-open {
display: grid;
grid-template-columns: [nav] 2fr [escape] 1fr;
}
Acho que a proporção e os nomes foram um toque muito legal aqui, em que a grade pode se destacar e dar muito controle ao designer.
Em seguida, preciso sobrepor condicionalmente o conteúdo principal e manter minha posição
durante qualquer rolagem do documento. Essa é uma ótima tarefa para position: sticky e
alguns overscroll-behavior.
Adicione os seguintes estilos para a barra de navegação lateral:
#sidenav-open {
display: grid;
grid-template-columns: [nav] 2fr [escape] 1fr;
@media (max-width: 540px) {
position: sticky;
top: 0;
max-height: 100vh;
overflow: hidden auto;
overscroll-behavior: contain;
visibility: hidden; /* not keyboard accessible when closed */
}
}
Esses estilos garantem que a navegação lateral tenha a altura da janela de visualização, role verticalmente
e contenha a rolagem. E, o mais importante, ele oculta o elemento. Por padrão,
quando a janela de visualização for 540px ou menor, oculte essa navegação lateral. A menos que…
Adicione um pseudosseletor :target ao elemento #sidenav-open:
#sidenav-open {
@media (max-width: 540px) {
&:target {
visibility: visible;
}
}
}
Quando o ID desse elemento e a barra de URL forem iguais,
defina visibility como visible. Abra o menu lateral depois de rolar a página
ou tente rolar a página com o menu lateral aberto. O que você acha?
Adicione o seguinte CSS à parte de baixo de app/sidenav.css:
#sidenav-button,
#sidenav-close {
-webkit-tap-highlight-color: transparent;
-webkit-touch-callout: none;
user-select: none;
touch-action: manipulation;
@media (min-width: 540px) {
display: none;
}
}
Esses estilos segmentam os botões de abrir e fechar, especificam os estilos de toque
e também os ocultam quando as janelas de visualização são 540px ou maiores.
Para dar um toque especial, vamos adicionar transformações de CSS com acessibilidade respeitosa.
Adicione o seguinte CSS a css/sidenav.css:
#sidenav-open {
--easeOutExpo: cubic-bezier(0.16, 1, 0.3, 1);
--duration: .6s;
...
@media (max-width: 540px) {
...
transform: translateX(-110vw);
will-change: transform;
transition:
transform var(--duration) var(--easeOutExpo),
visibility 0s linear var(--duration);
&:target {
visibility: visible;
transform: translateX(0);
transition: transform var(--duration) var(--easeOutExpo);
}
}
@media (prefers-reduced-motion: reduce) {
--duration: 1ms;
}
}
Adicionar um pouco de JavaScript
A tecla Escape deve fechar o menu. Adicione este JS a js/index.js:
const sidenav = document.querySelector('#sidenav-open');
sidenav.addEventListener('keyup', e => {
if (e.code === 'Escape') {
document.location.hash = '';
}
});
Isso detecta um evento de tecla no elemento sidenav.
Se for Escape, ele define o hash do URL como vazio, fazendo com que a navegação lateral seja removida.
A próxima parte do JS de UX é o gerenciamento de foco. Quero facilitar a abertura e o fechamento, então espero até que a navegação lateral tenha concluído uma transição de algum tipo e, em seguida, faço uma verificação cruzada com o hash do URL para determinar se ela está dentro ou fora. Em seguida, uso JavaScript para definir o foco no botão complementar ao que eles acabaram de pressionar.
Adicione o seguinte JavaScript a js/index.js:
const closenav = document.querySelector('#sidenav-close');
const opennav = document.querySelector('#sidenav-button');
sidenav.addEventListener('transitionend', e => {
if (e.propertyName !== 'transform') {
return;
}
const isOpen = document.location.hash === '#sidenav-open';
isOpen
? closenav.focus()
: opennav.focus();
});
Faça um teste
- Para visualizar o site, pressione View App. Em seguida, pressione
Fullscreen
.
Conclusão
Isso é tudo que eu precisava do componente. Fique à vontade para desenvolver com base nele, usar o estado do JavaScript em vez do URL e, em geral, deixá-lo do seu jeito. Sempre há mais a adicionar ou mais casos de uso a cobrir.
Abra css/brandnav.css para conferir os estilos não relacionados ao layout que apliquei a
esse componente. Não achei que isso fosse importante para o conjunto de atributos em que eu estava me concentrando e esperava que separar os estilos do layout incentivasse a cópia e colagem. Você pode aprender mais lá.
Como criar componentes de navegação lateral responsivos que deslizam para fora? Você já teve mais de um, tipo um de cada lado? Eu adoraria mostrar sua solução em um vídeo do YouTube. Mande um tweet para mim ou comente no YouTube com seu código. Isso vai ajudar todo mundo!