Bu codelab'de, web'de duyarlı bir kayan yan gezinme düzeni bileşeni oluşturmayı öğreneceksiniz. Bileşeni adım adım oluşturacağız. Önce HTML, sonra CSS, ardından JavaScript ile çalışacağız.
Bu bileşeni oluşturmak için seçilen CSS web platformu özellikleri hakkında bilgi edinmek istiyorsanız Sidenav bileşeni oluşturma başlıklı blog yayınımı inceleyin.
Kurulum
- Projeyi düzenlenebilir hale getirmek için Düzenlemek için remiksle'yi tıklayın.
app/index.htmladlı kişiyi aç.
HTML
Öncelikle, üzerinde çalışabileceğiniz içerik ve kutular olması için HTML kurulumunun temel bilgilerini öğrenin.
Aşağıdaki HTML'yi <body> etiketine bırakın.
<aside></aside>
<main></main>
<aside>, birincil sayfa içeriğini barındıran <main> öğesinin tamamlayıcı öğesi olarak gezinme menüsünü barındırır.
Ardından, bu anlamsal öğeleri sayfa içeriğinin geri kalanıyla dolduracağız.
<aside> öğesinin içine bir gezinme öğesi, bazı gezinme bağlantıları ve bir kapatma bağlantısı ekleyin.
<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>
Bağlantılar <nav> öğelerinin içinde, <nav> öğeleri ise <aside> kenar çubuklarında çok iyi görünür.
Yine de daha iyi hale getirmek için yapabileceğimiz daha çok şey var.
Ana içerik öğesine, düzen içeriğini anlamsal olarak tutacak bir başlık ve makale ekleyin.
<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>
Başlıkta menü açma bağlantısı bulunur. Kenar çubuğunda kapat düğmesi bulunur. Yakında öğeleri görüntü alanı boyutuna göre gösterip gizleyeceğiz.
<article> öğesine bir yer tutucu cümle yapıştırdık. `` ifadesini kendi içeriğinizle değiştirin veya aşağıda verilen lorem metnini yapıştırın:
<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>
Bu içerik ve uzunluğu, görüntü alanı yüksekliğini aştığında sayfanın kaydırılabilir olmasını sağlar.
Şimdiye kadar, gezinme, bağlantılar ve yan gezinme panelini kapatma yöntemi içeren bir aside öğesi eklediniz. Ayrıca bir başlık, yan gezinme panelini açmanın bir yolunu ve ana öğeye bir makale eklediniz. Bu kod temiz, anlamlı ve zamansız bir kod ancak herkes için daha temiz ve anlaşılır hale getirebiliriz. Yan gezinme panelindeki açık bağlantı daha net bir şekilde işaretlenebilir.
Başlık açma bağlantı öğesine title ve aria-label özelliklerini ekleyin:
<a href="#sidenav-open" class="hamburger">
<a href="#sidenav-open" title="Open Menu" aria-label="Open Menu" class="hamburger">
Açık SVG simgesi de daha net bir şekilde işaretlenebilir. Açık bağlantı öğesinin içindeki SVG'ye aşağıdaki özellikleri ekleyin:
<svg viewBox="0 0 50 40">
<svg viewBox="0 0 50 40" role="presentation" focusable="false" aria-label="trigram for heaven symbol">
Yan gezinme panelindeki kapatma bağlantısı daha net bir şekilde işaretlenebilir.
Yan gezinme çubuğu kapatma bağlantısı öğesine title ve aria-label özelliklerini ekleyin:
<a href="#"></a>
<a href="#" title="Close Menu" aria-label="Close Menu"></a>
CSS
Öğeleri düzenleme zamanı. Ana içerik ve yan gezinme çubuğu, <body> etiketinin doğrudan alt öğeleridir. Bu nedenle, başlamak için iyi bir yerdir.
<body> öğesinin alt öğeleri düzenlemesi için css/sidenav.css öğesine aşağıdaki CSS'yi ekleyin.
body {
display: grid;
grid: [stack] 1fr / min-content [stack] 1fr;
@media (max-width: 540px) {
& > :matches(aside, main) {
grid-area: stack;
}
}
}
Bu düzen, her şeyi içeren stack adlı bir satır ve bu satırda 2 sütun oluşturur. İkinci sütunun adı da stack olur. İlk sütun, minimum içerik ihtiyaçlarına göre boyutlandırılmalı ve ikinci sütun geri kalan alanı kaplayabilmelidir.
Ardından, 540px veya daha küçük bir kısıtlanmış görüntü alanındaysa yan gezinme ve ana içerik öğelerini aynı satır ve sütuna yerleştirerek 1x1 ızgarada üst üste gelmelerini sağlayın.
Bu duyarlı yığınlama işlevini temel alarak, yan gezinme panelinin görünürlüğünü ve geçiş stilini değiştirmek için URL çubuğunun durumundan yararlanabiliriz.
app/index.html içinde <aside> öğesini güncelleyin:
<aside>
<aside id="sidenav-open">
Bu, CSS'nin bir öğeyi ve URL karma değerini birlikte eşleştirmesini sağlar. Bu, :target kullanımı için önemlidir.
Artık öğenin kimliği, <a> etiketleriyle ayarlayacağımız URL karma değeriyle eşleşebilir.
Ayrıca, JavaScript hedeflemeyi kolaylaştırmak için yan gezinme panelini kontrol eden önemli öğelere kimlikler ekleyin. Öncelikle, yan gezinme çubuğunu açma bağlantısına bir kimlik ekleyin:
<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">
Ardından, yan gezinme kapatma bağlantısına bir kimlik ekleyin:
<a href="#" title="Close Menu" aria-label="Close Menu"></a>
<a href="#" id="sidenav-close" title="Close Menu" aria-label="Close Menu"></a>
Böylece makro <body> duyarlı yığınlama düzenini tamamlamış ve URL çubuğuna bağlamış olduk.
Devam edelim.
<aside> da düzenli bir yerleşime sahiptir. İki alt öğesi vardır: kayarak açılan kağıt benzeri bileşen olan <nav> ve URL'yi # olarak ayarlayan kapanış <a> bağlantı öğesi.
Bağlantı, kağıt kaydırma gezinme çubuğunun sağında görünmez. Bu sayede kullanıcılar görsel bileşeni kapatmak için "tıklayabilir".
Aşağıdaki CSS'yi css/sidenav.css alanına ekleyin:
#sidenav-open {
display: grid;
grid-template-columns: [nav] 2fr [escape] 1fr;
}
Burada oran ve adların çok hoş bir dokunuş olduğunu düşündüm. Izgara burada parlayabilir ve tasarımcıya çok fazla kontrol verebilir.
Ardından, ana içeriği koşullu olarak yerleştirmem ve doküman kaydırılırken konumumu korumam gerekiyor. Bu, position: sticky ve bazı overscroll-behavior için harika bir iş.
Yan gezinme çubuğu için aşağıdaki stilleri ekleyin:
#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 */
}
}
Bu stiller, yan gezinme panelinin görüntü alanı yüksekliğinde olmasını, dikey olarak kaydırılmasını ve kaydırma çubuğunu içermesini sağlar. En önemlisi, öğeyi gizler. Varsayılan olarak, görüntüleme alanı 540px veya daha küçük olduğunda bu yan gezinme çubuğu gizlenir. Ancak bir istisna var.
#sidenav-open öğesine bir :target sözde seçici ekleyin:
#sidenav-open {
@media (max-width: 540px) {
&:target {
visibility: visible;
}
}
}
Bu öğenin kimliği ile URL çubuğu aynı olduğunda visibility değerini visible olarak ayarlayın. Sayfayı kaydırdıktan sonra yan menüyü açın veya yan gezinme menüsü açıkken sayfayı kaydırmayı deneyin. Ne düşünüyorsunuz?
app/sidenav.css dosyasının en altına aşağıdaki CSS'yi ekleyin:
#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;
}
}
Bu stiller, açma ve kapatma düğmelerimizi hedefleyerek dokunma stillerini belirtir ve görüntü alanları 540px veya daha büyük olduğunda bunları gizler.
Daha şık bir görünüm için erişilebilirlik kurallarına uygun CSS dönüşümleri ekleyelim.
Aşağıdaki CSS'yi css/sidenav.css alanına ekleyin:
#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;
}
}
JavaScript ekleme
Escape tuşu menüyü kapatmalıdır. Bu JS'yi js/index.js öğesine ekleyin:
const sidenav = document.querySelector('#sidenav-open');
sidenav.addEventListener('keyup', e => {
if (e.code === 'Escape') {
document.location.hash = '';
}
});
Bu, sidenav öğesindeki bir tuş etkinliğini dinler.
Escape ise URL karma değerini boş olarak ayarlar ve yan gezinme panelinin geçişini sağlar.
Bir sonraki UX JS parçası, odak yönetimidir. Açma ve kapatma işlemlerini kolaylaştırmak istiyorum. Bu nedenle, yan gezinme çubuğunun bir tür geçişi tamamlamasını bekliyorum, ardından URL hash'iyle karşılaştırarak içeri mi yoksa dışarı mı olduğunu belirliyorum. Ardından, JavaScript kullanarak odağı, kullanıcının az önce bastığı düğmeyi tamamlayan düğmeye ayarlıyorum.
js/index.js alanına aşağıdaki JavaScript'i ekleyin:
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();
});
Deneyin
- Siteyi önizlemek için Uygulamayı Görüntüle'ye basın. Ardından Tam Ekran'a
basın.
Sonuç
Bileşenle ilgili ihtiyaçlarım bu kadar. Bu örneği dilediğiniz gibi geliştirebilir, URL yerine JavaScript durumuyla çalıştırabilir ve genel olarak kendinize göre uyarlayabilirsiniz. Her zaman eklenecek daha fazla şey veya ele alınacak daha fazla kullanım alanı vardır.
Bu bileşene uyguladığım düzenle ilgili olmayan stilleri incelemek için css/brandnav.css dosyasını açın. Odaklandığım özellik grubu için önemli olduğunu düşünmüyordum ve stilleri düzenden ayırmanın kopyalama ve yapıştırmayı teşvik edeceğini umuyordum. Orada öğrenebileceğiniz daha çok şey olabilir.
Duyarlı yan gezinme bileşenlerini nasıl kaydırarak açarsınız? Hiç birden fazla, örneğin her iki tarafta birer tane olduğu oluyor mu? Çözümünüzü bir YouTube videosunda paylaşmak isterim. Kodunuzu bana tweet atarak veya YouTube'da yorum yaparak paylaşabilirsiniz. Bu sayede herkese yardımcı olabilirsiniz.