Skip to content

CTag ​

Nhãn trạng thái dạng pill: nền mờ, chữ đậm cùng tông, luôn bám design token nên đạt tương phản AA ở cả chế độ sáng và tối.

Dùng khi: hiển thị trạng thái của một bản ghi (đơn hàng, hồ sơ, phiếu), phân loại, hoặc điều kiện lọc đang áp dụng.

Không dùng khi: chỉ cần bật/tắt hai trạng thái — dùng CStatus cho gọn; cần nút bấm được — dùng CButton.

vue
<!-- Đăng ký global qua layer, không cần import -->
<CTag color="success" dot>Hoàn thành</CTag>

Cơ bản ​

Màu semantic ​

Bảy màu bám token; chọn theo ý nghĩa trạng thái chứ không theo thẩm mỹ.

Có chấm dẫn đầu ​

Đóng được ​

Nút ✕ là <button> thật nên bấm được bằng bàn phím; close-text trở thành aria-label, hãy nêu rõ điều kiện bị bỏ thay vì chỉ "Xoá". Đây cũng là cách CTable dựng thanh điều kiện lọc.

Trong cột trạng thái của CTable ​

API ​

Props

TênKiểuMặc địnhMô tả
color"default" | "primary" | "error" | "accent" | "success" | "warning" | "info"'default'Màu semantic của nhãn; nền mờ + chữ đậm cùng tông, luôn đạt tương phản AA.
dotbooleanfalseHiển thị chấm tròn dẫn đầu.
closablebooleanfalseHiện nút ✕ ở cuối (sự kiện close) — vd thẻ điều kiện lọc.
closeTextstring'Xoá'Nhãn đọc màn hình của nút ✕ — nên nêu rõ đối tượng bị xoá.

Sự kiện

TênPayloadMô tả
close[]Bấm nút ✕ (chỉ có khi `closable`) — trang tự bỏ nhãn khỏi danh sách.

Slot

TênProps của slotMô tả
#defaultanyNội dung nhãn.

Giao diện ​

Màu lấy từ cặp *-soft (nền) và màu chữ tương ứng của @tasco-fe/theme — ý nghĩa từng màu ở Màu & tương phản:

BiếnSángTối Tương phản
--tasco-color-success#089b00#22c55e3.68:1 / 7.15:1
--tasco-color-success-soft#ecfdf5#10241a1.05:1 / 1.00:1
--tasco-color-success-text#087e02#22c55e5.26:1 / 7.15:1

Cần đổi khoảng cách hay bo góc: ghi đè class BEM c-tag, c-tag--<color>, c-tag__dot, c-tag__close. Không hardcode mã màu — thêm token vào @tasco-fe/theme rồi dùng biến.

Khả năng tiếp cận ​

  • Nút ✕ là phần tử <button type="button">, focus và bấm được bằng bàn phím.
  • close-text là nhãn đọc màn hình duy nhất của nút đó, nên viết đủ nghĩa khi đứng một mình.
  • Màu không phải kênh thông tin duy nhất: luôn có chữ trong nhãn; dot chỉ là bổ trợ.

Lưu ý ​

  • Nhãn không tự cắt chữ dài — với nội dung dài, cắt ở tầng dữ liệu hoặc bọc trong CTooltip.
  • Đừng dùng CTag làm nút: không có trạng thái focus và không phát sự kiện click.
  • Map trạng thái sang màu ở một chỗ dùng chung (như demo cột trạng thái) để các màn hình không hiển thị khác nhau cho cùng một giá trị.

Liên quan ​

  • CStatus — chỉ báo hoạt động/ngừng hoạt động.
  • CTable — thanh điều kiện lọc dùng chính CTag đóng được.
  • Màu & tương phản — bảng màu và cặp tương phản.