Codelab: การสร้างคอมโพเนนต์ Sidenav

Codelab นี้จะสอนวิธีสร้างคอมโพเนนต์เลย์เอาต์การนำทางด้านข้างแบบเลื่อนออกที่ปรับเปลี่ยนตามอุปกรณ์บนเว็บ เราจะสร้างคอมโพเนนต์ไปเรื่อยๆ โดยเริ่มจาก HTML, CSS แล้วตามด้วย JavaScript

ดูบล็อกโพสต์การสร้างคอมโพเนนต์ Sidenav เพื่อดูข้อมูลเกี่ยวกับฟีเจอร์แพลตฟอร์มเว็บ CSS ที่เลือกไว้สำหรับการสร้างคอมโพเนนต์นี้

ตั้งค่า

  1. คลิกรีมิกซ์เพื่อแก้ไขเพื่อให้โปรเจ็กต์แก้ไขได้
  2. เปิด app/index.html

HTML

ก่อนอื่น ให้ดูข้อมูลสำคัญเกี่ยวกับการตั้งค่า HTML เพื่อให้มีเนื้อหาและกล่องบางส่วนที่ใช้ทำงานได้

วาง HTML ต่อไปนี้ลงในแท็ก <body>

<aside></aside>
<main></main>

<aside> มีเมนูการนำทางเป็นองค์ประกอบเสริมของ <main> ซึ่งมีเนื้อหาหลักของหน้า

จากนั้นเราจะเติมองค์ประกอบเชิงความหมายเหล่านั้นด้วยเนื้อหาที่เหลือของหน้า

เพิ่มองค์ประกอบการนำทาง ลิงก์การนำทางบางส่วน และลิงก์ปิดภายในองค์ประกอบ <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>

ลิงก์จะทำงานได้ดีภายในองค์ประกอบ <nav> และองค์ประกอบ <nav> จะทำงานได้ดีในแถบด้านข้าง <aside> แต่เรายังคงปรับปรุงได้อีก

ในองค์ประกอบเนื้อหาหลัก ให้เพิ่มส่วนหัวและบทความเพื่อเก็บเนื้อหาเลย์เอาต์ตามความหมาย

<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>

ส่วนหัวมีลิงก์เปิดเมนู ส่วนด้านข้างมีปุ่มปิด เราจะแสดงและซ่อนองค์ประกอบตามขนาดวิวพอร์ตในเร็วๆ นี้

เราได้วางประโยคตัวยึดตำแหน่งไว้ในองค์ประกอบ <article> แทนที่ "" ด้วยเนื้อหาของคุณเอง หรือวางข้อความ Lorem ที่ระบุด้านล่าง

<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>

เนื้อหานี้และความยาวของเนื้อหาจะทำให้หน้าเว็บเลื่อนได้เมื่อมีความสูงเกินวิวพอร์ต

ตอนนี้คุณได้เพิ่มองค์ประกอบ aside ที่มี nav, ลิงก์ และวิธีปิด sidenav แล้ว นอกจากนี้ คุณยังเพิ่มส่วนหัว วิธีเปิดแถบนำทางด้านข้าง และบทความลงในองค์ประกอบหลักด้วย ซึ่งก็ดูสะอาดตา มีความหมาย และเหนือกาลเวลาอยู่แล้ว แต่เราสามารถทำให้สะอาดตาและชัดเจนยิ่งขึ้นสำหรับทุกคนได้ ลิงก์เปิดในแถบนำทางด้านข้าง ควรทำเครื่องหมายให้ชัดเจนกว่านี้

เพิ่มแอตทริบิวต์ title และ aria-label ลงในเอลิเมนต์ของลิงก์เปิดส่วนหัว ดังนี้

<a href="#sidenav-open" class="hamburger">
<a href="#sidenav-open" title="Open Menu" aria-label="Open Menu" class="hamburger">

ไอคอน SVG แบบเปิดควรมีการทำเครื่องหมายให้ชัดเจนยิ่งขึ้นด้วย เพิ่มแอตทริบิวต์ต่อไปนี้ลงใน SVG ภายในเอลิเมนต์ของลิงก์เปิด

<svg viewBox="0 0 50 40">
<svg viewBox="0 0 50 40" role="presentation" focusable="false" aria-label="trigram for heaven symbol">

ลิงก์ปิดในแถบนำทางด้านข้างควรมีการทำเครื่องหมายที่ชัดเจนกว่านี้ เพิ่มแอตทริบิวต์ title และ aria-label ลงในเอลิเมนต์ของลิงก์ปิดการนำทางด้านข้าง ดังนี้

<a href="#"></a>
<a href="#" title="Close Menu" aria-label="Close Menu"></a>

CSS

ได้เวลาจัดเลย์เอาต์องค์ประกอบแล้ว เนื้อหาหลักและแถบนำทางด้านข้างเป็นแท็กย่อยโดยตรงของแท็ก <body> ดังนั้นจึงควรเริ่มจากจุดนี้

เพิ่ม CSS ต่อไปนี้ลงใน css/sidenav.css เพื่อให้องค์ประกอบ <body> จัดวางองค์ประกอบย่อย

body {
  display: grid;
  grid: [stack] 1fr / min-content [stack] 1fr;

  @media (max-width: 540px) {
    & > :matches(aside, main) {
      grid-area: stack;
    }
  }
}

เลย์เอาต์นี้จะบอกว่าให้สร้างแถวที่มีชื่อว่า stack โดยมีทุกอย่างอยู่ในนั้น และมี 2 คอลัมน์ในแถวนั้น ซึ่งคอลัมน์ที่ 2 มีชื่อว่า stack ด้วย คอลัมน์แรกควรมีขนาดตามความต้องการเนื้อหาขั้นต่ำ และคอลัมน์ที่ 2 สามารถใช้พื้นที่ที่เหลือได้ จากนั้น หากอยู่ในวิวพอร์ตที่จำกัดขนาด 540px หรือน้อยกว่า ให้วางองค์ประกอบการนำทางด้านข้างและเนื้อหาหลักไว้ในแถวและคอลัมน์เดียวกัน ซึ่งจะทำให้องค์ประกอบทั้ง 2 อยู่ซ้อนกันในตารางกริดขนาด 1x1

เมื่อใช้ฟังก์ชันการซ้อนแบบปรับเปลี่ยนตามอุปกรณ์นี้เป็นฐาน ตอนนี้เราสามารถใช้ประโยชน์จากสถานะของแถบ URL เพื่อสลับระดับการมองเห็นและสไตล์การเปลี่ยนภาพของแถบนำทางด้านข้างได้

อัปเดตองค์ประกอบ <aside> กลับไปเป็น app/index.html โดยทำดังนี้

<aside>
<aside id="sidenav-open">

ซึ่งจะช่วยให้ CSS จับคู่องค์ประกอบและแฮช URL เข้าด้วยกันได้ ซึ่งเป็นสิ่งสำคัญสำหรับการใช้งาน :target ตอนนี้รหัสขององค์ประกอบจะตรงกับแฮช URL ที่เราจะตั้งค่าด้วยแท็ก <a>

นอกจากนี้ เพื่อให้กำหนดเป้าหมาย JavaScript ได้ง่ายขึ้น ให้เพิ่มรหัสสำหรับองค์ประกอบหลักที่ควบคุมการนำทางด้านข้าง ก่อนอื่น ให้เพิ่มรหัสลงในลิงก์เปิดแถบนำทางด้านข้าง ดังนี้

<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">

จากนั้นเพิ่มรหัสลงในลิงก์ปิดแถบนำทางด้านข้าง ดังนี้

<a href="#" title="Close Menu" aria-label="Close Menu"></a>
<a href="#" id="sidenav-close" title="Close Menu" aria-label="Close Menu"></a>

นั่นคือทั้งหมดของเลย์เอาต์การซ้อนกันแบบปรับเปลี่ยนตามพื้นที่โฆษณา<body>ในระดับมาโคร และยังเชื่อมโยงเราเข้ากับแถบ URL ด้วย มาลุยกันต่อเลย

<aside> ยังมีเลย์เอาต์ที่ดูเป็นระเบียบด้วย โดยมีองค์ประกอบย่อย 2 รายการ ได้แก่ <nav> ซึ่งเป็นคอมโพเนนต์ที่ดูเหมือนกระดาษที่เลื่อนออกมา และเอลิเมนต์ของลิงก์ <a> สำหรับปิดที่ตั้งค่า URL เป็น # ลิงก์จะมองไม่เห็นทางด้านขวาของแถบนำทางแบบเลื่อนออกของกระดาษ เพื่อให้ผู้ใช้สามารถ "คลิกปิด" คอมโพเนนต์ภาพเพื่อปิดได้

เพิ่ม CSS ต่อไปนี้ลงใน css/sidenav.css

#sidenav-open {
  display: grid;
  grid-template-columns: [nav] 2fr [escape] 1fr;
}

ฉันคิดว่าอัตราส่วนและชื่อเป็นสิ่งที่น่าสนใจมาก ซึ่ง Grid จะช่วยให้นักออกแบบควบคุมสิ่งต่างๆ ได้อย่างเต็มที่

ถัดไป ฉันต้องวางซ้อนเนื้อหาหลักแบบมีเงื่อนไขและคงตำแหน่งของฉันไว้ตลอดการเลื่อนเอกสาร งานนี้เหมาะสำหรับ position: sticky และ overscroll-behavior บางส่วน

เพิ่มรูปแบบต่อไปนี้สำหรับแถบนำทางด้านข้าง

#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 */
  }
}

รูปแบบเหล่านั้นช่วยให้มั่นใจว่าแถบนำทางด้านข้างมีความสูงเท่ากับวิวพอร์ต เลื่อนในแนวตั้ง และมีการเลื่อน และที่สำคัญคือจะซ่อนองค์ประกอบนั้น โดยค่าเริ่มต้น เมื่อวิวพอร์ตมีขนาด 540px หรือเล็กกว่า ให้ซ่อนแถบนำทางด้านข้างนั้น ยกเว้น!

เพิ่มตัวเลือกเทียม :target ลงในองค์ประกอบ #sidenav-open ดังนี้

#sidenav-open {

  @media (max-width: 540px) {

    &:target {
      visibility: visible;
    }
  }
}

เมื่อรหัสขององค์ประกอบนั้นและแถบ URL เหมือนกัน ให้ตั้งค่า visibility เป็น visible ลองเปิดเมนูด้านข้างหลังจากเลื่อนหน้าเว็บ หรือลองเลื่อนหน้าเว็บขณะที่แถบนำทางด้านข้างเปิดอยู่ คุณมีความคิดเห็นอย่างไร

เพิ่ม CSS ต่อไปนี้ที่ด้านล่างของ 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;
  }
}

สไตล์เหล่านี้กำหนดเป้าหมายไปที่ปุ่มเปิดและปิด ระบุสไตล์การแตะและการสัมผัส และยังซ่อนปุ่มเมื่อวิวพอร์ตมีขนาด 540px หรือใหญ่กว่า

มาเพิ่มการเปลี่ยนรูปแบบ CSS ที่คำนึงถึงการช่วยเหลือพิเศษเพื่อเพิ่มความน่าสนใจกัน เพิ่ม CSS ต่อไปนี้ลงใน 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;
  }
}
เดโมของการโต้ตอบที่มีและไม่มีระยะเวลาที่ใช้โดยอิงตามคิวรี่สื่อ `prefers-reduced-motion`

เพิ่ม JavaScript บางส่วน

แป้น Escape ควรปิดเมนู เพิ่ม JS นี้ลงใน js/index.js:

const sidenav = document.querySelector('#sidenav-open');

sidenav.addEventListener('keyup', e => {
  if (e.code === 'Escape') {
    document.location.hash = '';
  }
});

ซึ่งจะรอรับเหตุการณ์สำคัญในองค์ประกอบการนำทางด้านข้าง หากเป็น Escape ระบบจะตั้งค่าแฮช URL เป็นค่าว่าง ซึ่งจะทำให้แถบนำทางด้านข้างเปลี่ยนออก

UX JS ส่วนถัดไปคือการจัดการโฟกัส ฉันต้องการทำให้การเปิดและปิดเป็นเรื่องง่าย ฉันจึงรอจนกว่าการนำทางด้านข้างจะเปลี่ยนผ่านบางอย่างเสร็จสิ้น จากนั้นจึงตรวจสอบกับแฮช URL เพื่อดูว่าอยู่ในหรือนอก จากนั้นฉันใช้ JavaScript เพื่อตั้งค่าโฟกัสที่ปุ่มที่สอดคล้องกับปุ่มที่เพิ่งกด

เพิ่ม JavaScript ต่อไปนี้ลงใน 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();
});

ลองเลย

  • หากต้องการดูตัวอย่างเว็บไซต์ ให้กดดูแอป แล้วกดเต็มหน้าจอ เต็มหน้าจอ

บทสรุป

สรุปความต้องการที่ฉันมีเกี่ยวกับคอมโพเนนต์ คุณสามารถต่อยอดจากโค้ดนี้ ขับเคลื่อนด้วยสถานะ JavaScript แทน URL และปรับแต่งให้เป็นของคุณเองได้ ยังมีข้อมูลที่ต้องเพิ่ม หรือกรณีการใช้งานที่ต้องครอบคลุมอีกมากมาย

เปิด css/brandnav.css เพื่อดูสไตล์ที่ไม่เกี่ยวข้องกับเลย์เอาต์ที่ฉันใช้กับคอมโพเนนต์นี้ ผมไม่คิดว่าฟีเจอร์นี้สำคัญต่อชุดฟีเจอร์ที่ผมมุ่งเน้น และผมหวังว่าการแยกสไตล์ออกจากเลย์เอาต์จะช่วยส่งเสริมการคัดลอกและวาง คุณอาจได้เรียนรู้เพิ่มเติมจากที่นั่น

คุณจะสร้างคอมโพเนนต์แถบนำทางด้านข้างที่ปรับเปลี่ยนตามอุปกรณ์แบบเลื่อนออกได้อย่างไร คุณเคยมีมากกว่า 1 อันไหม เช่น มีข้างละอัน เราอยากนำเสนอโซลูชันของคุณในวิดีโอ YouTube ดังนั้นอย่าลืมทวีตหาเราหรือแสดงความคิดเห็นใน YouTube พร้อมโค้ดของคุณ ซึ่งจะช่วยทุกคนได้