Lớp học lập trình: Xây dựng thành phần Stories

Lớp học lập trình này hướng dẫn bạn cách xây dựng trải nghiệm như Instagram Stories trên web. Chúng ta sẽ xây dựng thành phần này trong quá trình thực hiện, bắt đầu bằng HTML, sau đó là CSS, sau đó là JavaScript.

Hãy xem bài đăng trên blog của tôi về Xây dựng thành phần Tin để tìm hiểu về những điểm cải tiến tăng dần được thực hiện trong khi xây dựng thành phần này.

Thiết lập

  1. Nhấp vào Phối lại để chỉnh sửa để có thể chỉnh sửa dự án.
  2. Mở app/index.html.

HTML

Tôi luôn cố gắng sử dụng HTML có ngữ nghĩa. Vì mỗi người bạn có thể có số lượng câu chuyện bất kỳ, nên tôi nghĩ việc sử dụng phần tử <section> cho mỗi người bạn và phần tử <article> cho mỗi câu chuyện là hợp lý. Tuy nhiên, hãy bắt đầu từ đầu. Trước tiên, chúng ta cần một vùng chứa cho thành phần tin bài.

Thêm phần tử <div> vào <body>:

<div class="stories">

</div>

Thêm một số phần tử <section> để đại diện cho bạn bè:

<div class="stories">
  <section class="user"></section>
  <section class="user"></section>
  <section class="user"></section>
  <section class="user"></section>
</div>

Thêm một số phần tử <article> để thể hiện các câu chuyện:

<div class="stories">
  <section class="user">
    <article class="story" style="--bg: url(https://picsum.photos/480/840);"></article>
    <article class="story" style="--bg: url(https://picsum.photos/480/841);"></article>
  </section>
  <section class="user">
    <article class="story" style="--bg: url(https://picsum.photos/481/840);"></article>
  </section>
  <section class="user">
    <article class="story" style="--bg: url(https://picsum.photos/481/841);"></article>
  </section>
  <section class="user">
    <article class="story" style="--bg: url(https://picsum.photos/482/840);"></article>
    <article class="story" style="--bg: url(https://picsum.photos/482/843);"></article>
    <article class="story" style="--bg: url(https://picsum.photos/482/844);"></article>
  </section>
</div>
  • Chúng tôi đang sử dụng một dịch vụ hình ảnh (picsum.com) để tạo nguyên mẫu cho các câu chuyện.
  • Thuộc tính style trên mỗi <article> là một phần của kỹ thuật tải phần giữ chỗ mà bạn sẽ tìm hiểu thêm trong phần tiếp theo.

CSS

Nội dung của chúng ta đã sẵn sàng để tạo kiểu. Hãy biến những khung xương đó thành thứ mà mọi người muốn tương tác. Hôm nay, chúng ta sẽ ưu tiên thiết bị di động.

.stories

Đối với vùng chứa <div class="stories">, chúng ta muốn có một vùng chứa cuộn ngang. Chúng ta có thể đạt được điều này bằng cách:

  • Đặt vùng chứa thành Grid (Lưới)
  • Đặt mỗi thành phần con để lấp đầy dải hàng
  • Đặt chiều rộng của mỗi thành phần hiển thị con bằng chiều rộng của khung nhìn trên thiết bị di động

Lưới sẽ tiếp tục đặt các cột mới có chiều rộng 100vw sang bên phải của cột trước đó, cho đến khi đặt tất cả các phần tử HTML vào mã đánh dấu của bạn.

Chrome và Công cụ cho nhà phát triển mở ra với hình ảnh lưới cho thấy bố cục toàn chiều rộng
Chrome DevTools cho thấy cột lưới bị tràn, tạo ra thanh cuộn ngang.

Thêm CSS sau vào cuối app/css/index.css:

.stories {
  display: grid;
  grid: 1fr / auto-flow 100%;
  gap: 1ch;
}

Bây giờ, chúng ta đã có nội dung mở rộng ra ngoài khung nhìn, đã đến lúc cho vùng chứa đó biết cách xử lý nội dung. Thêm các dòng mã được đánh dấu vào bộ quy tắc .stories:

.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;
}

Chúng ta muốn cuộn theo chiều ngang, vì vậy, chúng ta sẽ đặt overflow-x thành auto. Khi người dùng cuộn, chúng ta muốn thành phần này dừng lại nhẹ nhàng ở tin tiếp theo, vì vậy, chúng ta sẽ sử dụng scroll-snap-type: x mandatory. Đọc thêm về CSS này trong phần Điểm cố định vị trí cuộn CSS và hành vi cuộn quá mức trong bài đăng trên blog của tôi.

Cả vùng chứa mẹ và các vùng chứa con đều phải đồng ý với tính năng cố định vị trí cuộn, vì vậy, hãy xử lý việc đó ngay bây giờ. Thêm mã sau vào cuối app/css/index.css:

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

Ứng dụng của bạn chưa hoạt động, nhưng video dưới đây cho thấy điều gì sẽ xảy ra khi scroll-snap-type được bật và tắt. Khi bật, mỗi thao tác cuộn ngang sẽ cố định vị trí cuộn đến câu chuyện tiếp theo. Khi bạn tắt chính sách này, trình duyệt sẽ sử dụng hành vi cuộn mặc định.

Thao tác này sẽ giúp bạn cuộn qua danh sách bạn bè, nhưng chúng ta vẫn còn một vấn đề cần giải quyết với các tin.

.user

Hãy tạo một bố cục trong phần .user để sắp xếp các phần tử câu chuyện con đó vào đúng vị trí. Chúng ta sẽ sử dụng một thủ thuật xếp chồng tiện lợi để giải quyết vấn đề này. Về cơ bản, chúng ta đang tạo một lưới 1x1, trong đó hàng và cột có cùng biệt hiệu Lưới là [story] và mỗi mục lưới tin bài sẽ cố gắng chiếm không gian đó, dẫn đến một ngăn xếp.

Thêm mã được đánh dấu vào bộ quy tắc .user:

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

Thêm bộ quy tắc sau vào cuối app/css/index.css:

.story {
  grid-area: story;
}

Bây giờ, không có vị trí tuyệt đối, phần tử nổi hoặc các lệnh bố cục khác đưa một phần tử ra khỏi luồng, chúng ta vẫn đang ở trong luồng. Ngoài ra, hầu như không có mã nào, hãy xem này! Video và bài đăng trên blog này sẽ trình bày chi tiết hơn về vấn đề này.

.story

Bây giờ, chúng ta chỉ cần tạo kiểu cho chính mục tin bài.

Trước đó, chúng tôi đã đề cập rằng thuộc tính style trên mỗi phần tử <article> là một phần của kỹ thuật tải phần giữ chỗ:

<article class="story" style="--bg: url(https://picsum.photos/480/840);"></article>

Chúng ta sẽ sử dụng thuộc tính background-image của CSS, cho phép chúng ta chỉ định nhiều hình nền. Chúng ta có thể sắp xếp theo thứ tự để ảnh người dùng nằm ở trên cùng và sẽ tự động xuất hiện khi tải xong. Để bật tính năng này, chúng ta sẽ đặt URL hình ảnh vào một thuộc tính tuỳ chỉnh (--bg) và sử dụng thuộc tính đó trong CSS để phân lớp bằng phần giữ chỗ đang tải.

Trước tiên, hãy cập nhật bộ quy tắc .story để thay thế dải chuyển màu bằng hình nền sau khi tải xong. Thêm mã được đánh dấu vào bộ quy tắc .story:

.story {
  grid-area: story;

  background-size: cover;
  background-image:
    var(--bg),
    linear-gradient(to top, lch(98 0 0), lch(90 0 0));
}

Việc đặt background-size thành cover đảm bảo không có khoảng trống trong khung nhìn vì hình ảnh của chúng ta sẽ lấp đầy khung nhìn đó. Việc xác định 2 hình nền cho phép chúng ta thực hiện một thủ thuật web CSS gọn gàng có tên là tải bia mộ:

  • Hình nền 1 (var(--bg)) là URL mà chúng ta đã truyền nội tuyến trong HTML
  • Hình nền 2 (linear-gradient(to top, lch(98 0 0), lch(90 0 0)) là dải chuyển màu để hiển thị trong khi URL đang tải

CSS sẽ tự động thay thế dải chuyển màu bằng hình ảnh sau khi tải xong hình ảnh.

Tiếp theo, chúng ta sẽ thêm một số CSS để xoá một số hành vi, giúp trình duyệt di chuyển nhanh hơn. Thêm mã được đánh dấu vào bộ quy tắc .story:

.story {
  grid-area: story;

  background-size: cover;
  background-image:
    var(--bg),
    linear-gradient(to top, lch(98 0 0), lch(90 0 0));

  user-select: none;
  touch-action: manipulation;
}
  • user-select: none ngăn người dùng vô tình chọn văn bản
  • touch-action: manipulation hướng dẫn trình duyệt rằng các lượt tương tác này nên được coi là sự kiện chạm, giúp trình duyệt không phải cố gắng quyết định xem bạn có đang nhấp vào một URL hay không

Cuối cùng, hãy thêm một chút CSS để tạo ảnh động cho quá trình chuyển đổi giữa các câu chuyện. Thêm mã được đánh dấu vào bộ quy tắc .story:

.story {
  grid-area: story;

  background-size: cover;
  background-image:
    var(--bg),
    linear-gradient(to top, lch(98 0 0), lch(90 0 0));

  user-select: none;
  touch-action: manipulation;

  transition: opacity .3s cubic-bezier(0.4, 0.0, 1, 1);

  &.seen {
    opacity: 0;
    pointer-events: none;
  }
}

Lớp .seen sẽ được thêm vào một câu chuyện cần có lối thoát. Tôi lấy hàm làm mượt tuỳ chỉnh (cubic-bezier(0.4, 0.0, 1,1)) từ hướng dẫn Làm mượt của Material Design (di chuyển đến phần Làm mượt tăng tốc).

Nếu tinh ý, có thể bạn đã nhận thấy nội dung khai báo pointer-events: none và đang thắc mắc về nội dung này. Tôi cho rằng đây là nhược điểm duy nhất của giải pháp này cho đến nay. Chúng ta cần điều này vì phần tử .seen.story sẽ nằm ở trên cùng và nhận được các lượt nhấn, ngay cả khi phần tử này không hiển thị. Bằng cách đặt pointer-events thành none, chúng ta biến câu chuyện kính thành một cửa sổ và không còn lấy đi lượt tương tác nào của người dùng nữa. Sự đánh đổi này không quá tệ, cũng không quá khó để quản lý trong CSS của chúng ta ngay lúc này. Chúng ta không tung hứng z-index. Tôi vẫn cảm thấy hài lòng về điều này.

JavaScript

Các hoạt động tương tác của thành phần Stories khá đơn giản đối với người dùng: nhấn vào bên phải để chuyển tiếp, nhấn vào bên trái để quay lại. Những điều đơn giản cho người dùng thường là việc khó cho nhà phát triển. Tuy nhiên, chúng tôi sẽ xử lý phần lớn các vấn đề.

Thiết lập

Để bắt đầu, hãy tính toán và lưu trữ nhiều thông tin nhất có thể. Thêm mã sau vào app/js/index.js:

const stories = document.querySelector('.stories')
const median = stories.offsetLeft + (stories.clientWidth / 2)

Dòng JavaScript đầu tiên của chúng ta lấy và lưu trữ tệp đối chiếu đến gốc phần tử HTML chính. Dòng tiếp theo tính toán vị trí giữa của phần tử, nhờ đó chúng ta có thể quyết định xem một lần nhấn là để tiến hay lùi.

Tiểu bang

Tiếp theo, chúng ta tạo một đối tượng nhỏ có một số trạng thái liên quan đến logic. Trong trường hợp này, chúng ta chỉ quan tâm đến câu chuyện hiện tại. Trong mã đánh dấu HTML, chúng ta có thể truy cập vào dữ liệu này bằng cách lấy người bạn đầu tiên và tin mới nhất của họ. Thêm mã được đánh dấu vào app/js/index.js:

const stories = document.querySelector('.stories')
const median = stories.offsetLeft + (stories.clientWidth / 2)

const state = {
  current_story: stories.firstElementChild.lastElementChild
}

Trình nghe

Bây giờ, chúng ta đã có đủ logic để bắt đầu theo dõi các sự kiện của người dùng và điều hướng các sự kiện đó.

Chuột

Hãy bắt đầu bằng cách lắng nghe sự kiện 'click' trên vùng chứa tin của chúng ta. Thêm mã được đánh dấu vào app/js/index.js:

const stories = document.querySelector('.stories')
const median = stories.offsetLeft + (stories.clientWidth / 2)

const state = {
  current_story: stories.firstElementChild.lastElementChild
}

stories.addEventListener('click', e => {
  if (e.target.nodeName !== 'ARTICLE')
    return

  navigateStories(
    e.clientX > median
      ? 'next'
      : 'prev')
})

Nếu một lượt nhấp xảy ra và không nằm trên phần tử <article>, chúng ta sẽ thoát và không làm gì cả. Nếu đó là một bài viết, chúng ta sẽ lấy vị trí ngang của chuột hoặc ngón tay bằng clientX. Chúng ta chưa triển khai navigateStories, nhưng đối số mà hàm này nhận sẽ chỉ định hướng chúng ta cần đi. Nếu vị trí của người dùng lớn hơn giá trị trung vị, chúng ta biết rằng mình cần chuyển đến next, nếu không thì chuyển đến prev (trước đó).

Bàn phím

Bây giờ, hãy theo dõi các thao tác nhấn phím. Nếu nhấn phím Mũi tên xuống, chúng ta sẽ chuyển đến next. Nếu là Mũi tên lên, chúng ta sẽ chuyển đến prev.

Thêm mã được đánh dấu vào app/js/index.js:

const stories = document.querySelector('.stories')
const median = stories.offsetLeft + (stories.clientWidth / 2)

const state = {
  current_story: stories.firstElementChild.lastElementChild
}

stories.addEventListener('click', e => {
  if (e.target.nodeName !== 'ARTICLE')
    return

  navigateStories(
    e.clientX > median
      ? 'next'
      : 'prev')
})

document.addEventListener('keydown', ({key}) => {
  if (key !== 'ArrowDown' || key !== 'ArrowUp')
    navigateStories(
      key === 'ArrowDown'
        ? 'next'
        : 'prev')
})

Di chuyển trong Stories

Đã đến lúc giải quyết logic kinh doanh độc đáo của tin và trải nghiệm người dùng đã làm nên tên tuổi của tin. Đoạn mã này trông có vẻ rườm rà và phức tạp, nhưng tôi nghĩ nếu bạn xem xét từng dòng, bạn sẽ thấy nó khá dễ hiểu.

Trước tiên, chúng ta sẽ lưu trữ một số bộ chọn giúp chúng ta quyết định xem có nên di chuyển đến một người bạn hay hiện/ẩn một câu chuyện hay không. Vì chúng ta đang làm việc trên HTML, nên chúng ta sẽ truy vấn HTML để tìm sự hiện diện của bạn bè (người dùng) hoặc tin bài (tin bài).

Những biến này sẽ giúp chúng ta trả lời các câu hỏi như: "với tin x, "tiếp theo" có nghĩa là chuyển sang một tin khác của cùng người bạn này hay của một người bạn khác?" Tôi đã làm được điều này bằng cách sử dụng cấu trúc cây mà chúng tôi đã xây dựng, tiếp cận các phần tử mẹ và phần tử con của chúng.

Thêm mã sau vào cuối app/js/index.js:

const navigateStories = direction => {
  const story = state.current_story
  const lastItemInUserStory = story.parentNode.firstElementChild
  const firstItemInUserStory = story.parentNode.lastElementChild
  const hasNextUserStory = story.parentElement.nextElementSibling
  const hasPrevUserStory = story.parentElement.previousElementSibling
}

Sau đây là mục tiêu logic nghiệp vụ của chúng ta, gần với ngôn ngữ tự nhiên nhất có thể:

  • Quyết định cách xử lý thao tác nhấn
    • Nếu có câu chuyện tiếp theo/trước đó: hiển thị câu chuyện đó
    • Nếu đó là tin cuối cùng/đầu tiên của bạn bè: hiển thị một người bạn mới
    • Nếu không có tin bài nào theo hướng đó: không làm gì cả
  • Lưu trữ câu chuyện hiện tại mới vào state

Thêm mã được đánh dấu vào hàm navigateStories:

const navigateStories = direction => {
  const story = state.current_story
  const lastItemInUserStory = story.parentNode.firstElementChild
  const firstItemInUserStory = story.parentNode.lastElementChild
  const hasNextUserStory = story.parentElement.nextElementSibling
  const hasPrevUserStory = story.parentElement.previousElementSibling

  if (direction === 'next') {
    if (lastItemInUserStory === story && !hasNextUserStory)
      return
    else if (lastItemInUserStory === story && hasNextUserStory) {
      state.current_story = story.parentElement.nextElementSibling.lastElementChild
      story.parentElement.nextElementSibling.scrollIntoView({
        behavior: 'smooth'
      })
    }
    else {
      story.classList.add('seen')
      state.current_story = story.previousElementSibling
    }
  }
  else if(direction === 'prev') {
    if (firstItemInUserStory === story && !hasPrevUserStory)
      return
    else if (firstItemInUserStory === story && hasPrevUserStory) {
      state.current_story = story.parentElement.previousElementSibling.firstElementChild
      story.parentElement.previousElementSibling.scrollIntoView({
        behavior: 'smooth'
      })
    }
    else {
      story.nextElementSibling.classList.remove('seen')
      state.current_story = story.nextElementSibling
    }
  }
}

Dùng thử

  • Để xem trước trang web, hãy nhấn vào View App (Xem ứng dụng). Sau đó, nhấn vào biểu tượng Fullscreen (Toàn màn hình) toàn màn hình.

Kết luận

Đó là phần tóm tắt về những nhu cầu của tôi đối với thành phần này. Bạn có thể thoải mái xây dựng, thúc đẩy bằng dữ liệu và biến nó thành của riêng bạn!