Lily Design System™

“Hướng tới WCAG 2.2 AAA” ở đây nghĩa là gì

Từ hướng tới được chọn có chủ ý. Trang này nói chính xác điều gì được xác minh, bằng gì, điều gì không được xác minh bởi bất cứ thứ gì, và chúng tôi định làm gì với khoảng trống đó. Lily không bao giờ tuyên bố “tuân thủ” WCAG — không cuộc kiểm toán nào chứng minh điều đó.

Được xác minh liên tục

  • Phần tử ngữ nghĩa chuẩn, thuộc tính ARIA và móc lớp của mọi thành phần — được khẳng định bởi các bộ kiểm thử đơn vị theo từng framework (hơn 15.000 trường hợp trên bảy framework).
  • Mỗi trang demo trong số 571 trang thành phần ở ứng dụng ví dụ SvelteKit đều sạch theo axe (các bộ quy tắc WCAG 2.0/2.1 A+AA và 2.2 AA) — đợt quét toàn danh mục, lần đầu lập đường cơ sở 2026-08-27 và chạy lại 2026-10-06 — cộng với đường cơ sở theo từng ứng dụng cho trang chủ, danh mục và các tuyến ghép trong cả bảy ứng dụng ví dụ.
  • Hợp đồng bàn phím cho từng thành phần tương tác, được ghi lại trong siêu dữ liệu chuẩn của mỗi thành phần và được các bộ kiểm thử thực thi; các gói trợ thủ còn chạy thêm đặc tả Playwright trên trình duyệt thật.
  • Ngưỡng tối thiểu về kích thước mục tiêu theo WCAG 2.2 và biện pháp chống tràn trong cả 57 giao diện; liên kết bỏ qua, mốc điều hướng và không tràn ngang ở bốn khung nhìn cho mỗi ứng dụng; lang/dir việc áp dụng, bao gồm cả lật RTL.

Không được xác minh bởi bất cứ thứ gì

  • Chưa từng có cuộc kiểm toán tuân thủ nào được thực hiện. Không có VPAT, không có chứng nhận. Công cụ tự động chỉ bao phủ một thiểu số tiêu chí thành công của WCAG.
  • Các tiêu chí riêng của AAA (độ tương phản nâng cao, và những tiêu chí khác) là ý định thiết kế, không phải thuộc tính đã xác minh; các bộ quy tắc axe chạy ở mức A/AA. Hiện chưa có giao diện tương phản cao riêng.
  • Hành vi của trình đọc màn hình phần lớn chưa được kiểm thử. Các bộ kiểm thử khẳng định thuộc tính ARIA, không phải điều VoiceOver, NVDA hay JAWS đọc ra — và dự án này đã nhiều lần phát hành bộ kiểm thử xanh trên những lỗi thật, mỗi lần đều được ghi vào nhật ký thay đổi chính vì các bộ kiểm thử không thể nhìn thấy chúng.

Chúng tôi định làm gì về điều đó

Một cuộc kiểm toán khả năng tiếp cận độc lập là mục đích sử dụng đầu tiên được nêu tên của bất kỳ nguồn tài trợ nào cho dự án, và phạm vi mà kiểm toán viên cần đã được chuẩn bị. Cho đến lúc đó, các báo cáo từ trình đọc màn hình là đóng góp mà dự án này mong muốn nhất: “thành phần X đọc là Y, điều này sai vì Z” có thể xử lý ngay.

Báo cáo một vấn đề

Mở một issue tại github.com/LilyDesignSystem/lily-design-system hoặc gửi email tới joel@joelparkerhenderson.com. Nêu một tiêu chí WCAG sẽ có ích nhưng không bắt buộc — “tôi không thể thao tác X bằng bàn phím” là một báo cáo đầy đủ.

Bản tuyên bố đầy đủ, kèm bảng xác minh và lịch sử xem xét, nằm trong kho mã: docs/accessibility-statement.md.