Đóng mở nội dung bằng details và summary
Dùng disclosure HTML cho mục hỏi đáp, giữ trạng thái và bàn phím gốc, kiểm tra sự kiện toggle rồi chọn có cần nhóm câu trả lời hay không.

Phần tử details tạo một điều khiển đóng mở nội dung bổ sung, thường gọi là disclosure, mà không cần JavaScript cho thao tác cơ bản. summary cung cấp nhãn luôn nhìn thấy. Với người đã biết HTML cơ bản, mục hỏi đáp ngắn về giao hàng là ví dụ phù hợp: trình duyệt quản lý trạng thái mở và cung cấp tương tác bàn phím cho nhãn.
Dùng disclosure cho thông tin mà người đọc có thể chọn xem thêm. Đừng giấu lời giải thích duy nhất về thao tác phá hủy dữ liệu hoặc hướng dẫn bắt buộc của biểu mẫu vào đó. Thu gọn thay đổi thời điểm người đọc gặp thông tin, nên quyết định cần dựa trên tầm quan trọng của nội dung, không chỉ mong muốn làm trang ngắn lại.
Bắt đầu bằng câu hỏi có nghĩa khi đang đóng
<details class="shipping-faq" id="delivery-date">
<summary>Tôi có thể chọn ngày giao hàng không?</summary>
<p>
Trong cửa hàng giả định này, bước thanh toán hiển thị các ngày
có thể giao trước khi gửi đơn. Lựa chọn phụ thuộc
vào khu vực giao hàng.
</p>
<p><a href="/delivery-policy/">Đọc chính sách giao hàng</a></p>
</details>
Đây là chính sách hư cấu để minh họa thành phần. Cửa hàng thật phải thay bằng điều khoản của mình. Câu hỏi vẫn rõ khi nội dung đóng, còn phần trả lời cung cấp đúng thông tin được hỏi.
Tài liệu details của MDN giải thích nhãn và trạng thái mở. Để viết HTML hợp lệ, đặt summary làm phần tử con đầu tiên bên trong details. Trình duyệt tìm phần tử con summary để thực hiện hành vi gốc, nhưng điều đó không cho phép tác giả đặt nội dung khác trước nhãn. Nếu thiếu nhãn có nghĩa, nhãn dự phòng của trình duyệt không thể mô tả riêng câu trả lời của bạn.
open là thuộc tính Boolean: chỉ cần hiện diện là nội dung mở. Viết open="false" vẫn giữ thuộc tính, nên không có nghĩa là đóng. Khi điều khiển bằng mã, hãy xóa thuộc tính hoặc đặt thuộc tính DOM open thành false.
Để trình duyệt quản lý trạng thái cơ bản
Một lỗi thường gặp là thêm bộ xử lý click để đảo một biến Boolean khác rồi để biến đó cạnh tranh với trạng thái open gốc. Hai bên có thể lệch khi người dùng thao tác bằng bàn phím hoặc mã khác sửa phần tử.
Nếu ứng dụng cần theo dõi thay đổi, nghe sự kiện toggle và đọc giá trị open hiện tại. Trình duyệt có thể gộp thông báo khi trạng thái đổi nhiều lần trước lúc phát sự kiện. Xem trạng thái cuối là nguồn thông tin, không đếm từng sự kiện như thể mỗi sự kiện đại diện một hành động người dùng riêng biệt, không thể đảo ngược.
Đo lường hành vi cũng cần phân biệt điều đó. Mã khởi tạo mở một câu trả lời chưa chắc là người đọc chủ động mở nó. Nếu số đo quan trọng, xác định tương tác cần đếm và ghi nhận ở đúng điểm. Chỉ quan sát thay đổi trạng thái chưa chứng minh được ý định.
Nhãn còn nguyên ở cả hai trạng thái. Sự liên tục giúp người đọc biết nội dung nào vừa mở, đồng thời giữ một điều khiển ổn định để đóng lại.
Tạo kiểu mà vẫn giữ ý nghĩa của điều khiển
Dấu chỉ trạng thái của trình duyệt có ích. Nếu thiết kế thay nó bằng biểu tượng mũi tên riêng, hai trạng thái vẫn phải phân biệt được bằng mắt. Đừng giữ nguyên dấu cộng sau khi mở rồi buộc người đọc suy ra trạng thái từ việc trang dài ra.
Giữ chỉ báo focus rõ trên summary. Đổi màu khi rê chuột không giúp người dùng bàn phím. Padding mở rộng vùng có thể kích hoạt mà không cần lồng một nút khác. Nhãn và dấu chỉ nên nằm trong cùng một vùng tương tác thống nhất.
Thận trọng với liên kết hoặc nút đặt ngay trong summary: chúng có thể tạo thao tác kích hoạt cạnh tranh và tên khó hiểu. Liên kết hỗ trợ nên nằm trong câu trả lời. Nếu bản thân nhãn cần nhiều hành động độc lập, một cấu trúc thành phần khác có thể dễ dùng hơn.
Hiệu ứng chuyển động là tùy chọn. Nội dung có thể đổi chiều cao, còn hoạt ảnh chiều cao có thể làm chậm việc đọc câu trả lời. Phần tử gốc không tự cung cấp hiệu ứng mở mượt. Chỉ thêm chuyển động sau khi hành vi tĩnh đã đúng và tôn trọng lựa chọn giảm chuyển động của người dùng.
Chừa đủ chỗ cho điều khiển gốc
CSS sau áp dụng cho ví dụ ở trên. Nó giữ cách hiển thị và dấu chỉ gốc của summary, đồng thời tăng vùng thao tác, cho phép xuống dòng và thêm viền focus bàn phím. Câu trả lời vẫn là nội dung bình thường, có liên kết riêng tới đường dẫn chính sách giả định. Trang thật phải cung cấp đường dẫn đó trước khi đưa ví dụ vào sử dụng.
.shipping-faq {
border: 1px solid #74785b;
border-radius: 0.75rem;
margin-block: 1rem;
}
.shipping-faq > summary {
cursor: pointer;
padding: 1rem;
overflow-wrap: anywhere;
}
.shipping-faq > summary:focus-visible {
outline: 3px solid #485b34;
outline-offset: 3px;
}
.shipping-faq > :not(summary) {
margin: 1rem;
}
Không có chiều cao cố định để cắt câu hỏi sau khi dịch hoặc tăng cỡ chữ. Hộp ngoài cũng không cắt phần tràn khiến viền focus biến mất. Khi câu trả lời đóng, bàn phím phải tới được nhãn và bỏ qua liên kết hỗ trợ đang ẩn. Mở câu trả lời xong, Tab tiếp theo đi tới liên kết theo thứ tự tài liệu bình thường. Thành phần không cần ép focus vào câu trả lời chỉ vì chiều cao vừa đổi.
Nếu một tiêu đề mô tả cả nhóm hỏi đáp, đặt tiêu đề đó ngoài summary. Tài liệu summary ghi nhận khác biệt giữa trình duyệt khi cung cấp vai trò của các phần tử con cho công nghệ hỗ trợ. Vì vậy, tiêu đề lồng trong summary không phải cách đáng tin cậy để đồng thời tạo điểm điều hướng theo tiêu đề và nhãn đóng mở. Hành vi gốc là điểm bắt đầu; vẫn cần kiểm tra những tổ hợp trình duyệt và trình đọc màn hình mà trang hỗ trợ.
Quan sát trạng thái thay vì dựng lại các lần click
Bộ nghe nhỏ dưới đây dùng để kiểm tra ví dụ giao hàng. Dán một lần vào console sau khi trang tải, hoặc chạy trong script đặt sau phần HTML. Nó ghi thông báo trạng thái, không hủy kích hoạt và không thêm biến thứ hai quyết định nội dung đang mở hay đóng.
const disclosure = document.querySelector('#delivery-date');
const observed = [];
disclosure.addEventListener('toggle', () => {
observed.push(disclosure.open);
console.log({ open: disclosure.open, notifications: observed.length });
});
Bắt đầu khi nội dung đóng và thông báo trước đó, nếu có, đã được phát. Chạy ba phép gán sau trong cùng một lần thực thi ở console:
disclosure.open = true;
disclosure.open = false;
disclosure.open = true;
Giá trị cuối của thuộc tính là true ngay lập tức. Trình duyệt có thể gộp các thông báo toggle đang chờ, nên chuỗi liên tục này tạo một thông báo về trạng thái mở cuối cùng, không phải nhật ký sự kiện cho đủ ba phép gán. Tài liệu sự kiện toggle mô tả hành vi gộp này. Đừng dùng số thông báo để dựng lại mọi trạng thái trung gian hoặc đếm lượt mua, lựa chọn của người đọc và những hành động ứng dụng khác.
Sơ đồ tách thay đổi thuộc tính khỏi thông báo đến sau. Nếu chèn ranh giới bất đồng bộ, trình duyệt có thể phát thông báo giữa các phép gán. Đó là thí nghiệm khác; khi giải thích số đếm, phải giữ lại những ranh giới ấy. Ví dụ không cam kết độ trễ cố định theo mili giây.
Tiếp theo, thử disclosure.setAttribute('open', 'false'). Câu trả lời vẫn mở vì thuộc tính hiện diện. Đặt disclosure.open = false rồi kiểm tra disclosure.hasAttribute('open'): kết quả là false. Bài tập nối cú pháp Boolean trong HTML với thuộc tính DOM phản chiếu nó. Chữ ghi bên trong thuộc tính không được phân tích như một giá trị Boolean của ứng dụng.
Quyết định có cho phép nhiều câu trả lời cùng mở
Hỏi đáp thường dễ so sánh hơn khi nhiều mục cùng mở. Một accordion loại trừ lẫn nhau có thể tiết kiệm chỗ nhưng cũng đóng thông tin người đọc còn đang dùng. Hãy chọn theo nhu cầu thay vì mặc định nhóm nào cũng cần giới hạn một mục.
Ở trình duyệt hỗ trợ, các details có chung name tạo nhóm chỉ cho một mục mở. Đặc tả HTML định nghĩa việc loại trừ theo tên nhóm khớp nhau, kể cả khi các phần tử không liền kề. Dùng tên riêng cho nhóm hỏi đáp này để thành phần khác trên trang không bất ngờ gia nhập cùng nhóm. Đặt các câu hỏi liên quan cạnh nhau dưới tiêu đề phần phù hợp.
Khả năng tương thích vẫn cần được kiểm tra. Nếu trình duyệt cũ được hỗ trợ cho nhiều mục cùng mở, đó có thể là phương án dự phòng chấp nhận được cho hỏi đáp, miễn nội dung đọc được và hướng dẫn không hứa chỉ một mục có thể mở.
Đừng dùng nhóm để che một chuỗi thao tác bắt buộc. Biểu mẫu nhiều bước cần điều hướng, xác minh dữ liệu và quản lý trạng thái mà nhóm disclosure không cung cấp. Trông giống nhau không có nghĩa là cùng quy tắc tương tác.
Kiểm tra nội dung cùng thao tác đóng mở
Đi tới từng nhãn bằng bàn phím và mở bằng phím kích hoạt gốc được hỗ trợ. Xác nhận focus nhìn rõ và mở câu trả lời không bất ngờ chuyển focus đi nơi khác. Khi tăng cỡ chữ, câu hỏi dài cần xuống dòng mà dấu chỉ không đè lên chữ.
Đọc trang với mọi câu trả lời cùng mở. Cách này phát hiện nội dung lặp, ngữ cảnh thiếu và liên kết chỉ có nghĩa nhờ một phần đang ẩn ở nơi khác. Nó cũng cho thấy nội dung có còn được tổ chức tốt khi bỏ hiệu ứng tiết kiệm chỗ hay không.
Với bản in, quyết định có cần mở sẵn các câu trả lời. Kiểm tra hành vi in của trình duyệt cùng CSS dự án. Bản in chỉ có câu hỏi không trở nên hữu ích chỉ vì bản tương tác chạy đúng.
Thành phần cuối có thể vẫn chủ yếu là HTML và CSS. Thêm script khi có yêu cầu cụ thể, đồng thời giữ nhãn, nội dung và trạng thái gốc dễ hiểu khi đứng riêng.