Nền tảng

Độ nổi

Đã đặc tả

Hai bậc, không phải một thang. raised cho thứ nằm trên mặt phẳng trang; overlay cho thứ nổi trên nội dung và chặn nó. Bóng không bao giờ là ranh giới duy nhất của một control.

Render

Hai bậc, ở cả hai chế độ cạnh nhau

Cùng một token, hai chế độ — để thấy bóng gần như biến mất ở chế độ tối, đúng điều markdown nói.

nexoframe · light

raised

Unknown

overlay

Unknown

nexoframe · dark

raised

Unknown

overlay

Unknown

Luật

Bóng không phải ranh giới

Cảnh báo

Một control hay một panel không bao giờ chỉ được nhận ra nhờ bóng. Bóng ở alpha 0.10 không đạt ngưỡng tương phản phi-văn-bản 3:1 của WCAG 2.2 SC 1.4.11, bóng gần như biến mất trên nền tối, và forced-colors của hệ điều hành loại bỏ bóng hoàn toàn. Viền hoặc nền khác màu mới là thứ vạch ranh giới — bóng cộng thêm, không thay thế.

Vì sao

Vì sao chỉ hai bậc

Hệ thống có đúng hai quan hệ độ nổi: trên mặt phẳng trang, và trên nội dung. Thứ tự giữa các lớp nổi không do bóng quyết định mà do --nf-foundation-layer-* quyết định — một thang nhiều bậc sẽ mời người thiết kế diễn đạt thứ bậc bằng bóng, và thứ bậc đó sẽ mâu thuẫn với thứ tự z-index thật.

Quy tắc

Do / Don't

Do	Don't	Vì sao
Dùng raised cho thẻ và thanh dính	Dùng overlay cho thẻ	Thẻ không chặn nội dung; bóng lớn nói sai quan hệ
Dùng --nf-component-overlay-shadow từ primitive	Bind -shadow-overlay từ màn hình	Alias là chỗ rẽ nhánh sau này
Ghép bóng với viền và nền	Dùng bóng làm ranh giới duy nhất	Mất ở chế độ tối, mất ở forced-colors, và không đạt 3:1
Để thứ tự lớp cho layer-*	Diễn đạt thứ bậc bằng bóng đậm hơn	Hai hệ thứ bậc sẽ mâu thuẫn
Thêm bậc mới bằng một ADR	Gõ một box-shadow mới trong component	Một bóng gõ tay là bậc thứ ba không ai đặt tên

Chưa quyết

Open questions

Question	Owner	Resolves when
Chế độ tối có cần cách biểu đạt độ nổi riêng không, vì bóng gần như vô hình ở đó?	nexoboxvn@gmail.com	Cùng lúc với câu hỏi surface.base bằng surface.raised ở color.md
forced-colors có cần một block riêng không?	nexoboxvn@gmail.com	Một người dùng thật dùng chế độ đó