@ark-ui/react/editableTailwind CSS v4

Ark Editable

Thành phần chỉnh sửa nội dung tại chỗ (inline editing) mạnh mẽ, chuẩn WAI-ARIA, kết hợp máy trạng thái của Ark UI và hệ thống token thiết kế ChillCMS.

Chưa có thao tác commit

Cơ bản (Basic Uncontrolled)

Hiển thị xem trước, nhấn vào để chuyển sang input, hỗ trợ phím Enter để lưu và Escape để hủy.

Trang chủ ChillCMS v2

Shorthand API tiện lợi

Sử dụng trực tiếp component <ArkEditable /> để tạo nhanh form field có đầy đủ control triggers.

Bàn phím cơ không dây ChillPro

Component <ArkEditable label="..." defaultValue="..." showControls /> tự động lắp ráp Area, Preview, Input và Control triggers mà không cần viết compound thủ công.

Controlled State

Quản lý giá trị từ React state bên ngoài với value, onValueChange và onValueCommit.

Chiến dịch Mùa Thu 2026
Giá trị hiện tại: Chiến dịch Mùa Thu 2026

Kích hoạt nhấp đúp (Double-Click)

Chỉ cho phép chuyển sang chỉnh sửa khi nhấp đúp chuột, thích hợp cho tài liệu và danh sách dày đặc.

Nhấp đúp (Double click) vào dòng này để sửa tiêu đề

Với activationMode="dblclick", người dùng cần nhấp đúp để vào chế độ chỉnh sửa, tránh kích hoạt nhầm khi duyệt văn bản.

Ma trận kích thước (Sizes)

Hỗ trợ đầy đủ 4 kích cỡ xs, sm, md, lg tương thích với hệ thống ControlSize của ChillCMS.

Dữ liệu mẫu kích thước MD

Đồng bộ Design Tokens ChillCMS

Kích thước md tự động áp dụng biến chiều cao, padding, khoảng cách gap và cỡ chữ qua --control-height và --control-font-size.

Các biến thể giao diện (Variants)

Cung cấp 4 phong cách giao diện: default, subtle, flushed và card cho từng ngữ cảnh hiển thị.

Nội dung với variant="default"
Nội dung với variant="subtle"
Nội dung với variant="flushed"
Nội dung với variant="card"

Tự co giãn chiều rộng Inline (Inline Auto-resize Width)

Chiều rộng input tự co giãn theo ký tự nhập ([field-sizing:content] và size dynamic), lý tưởng cho tiêu đề tài liệu và văn bản inline thay vì chiếm full width.

1. Đặt inline trong câu văn (In-sentence Text Flow)

Xin chào
Nguyễn Văn A
, bạn có5 nhiệm vụ mớicần giải quyết trong ngày hôm nay.

💡 Nhấp vào tên người dùng và gõ thử để thấy câu văn tự động dạt ra hoặc co lại theo từng ký tự.

2. Tiêu đề tài liệu / Header thanh công cụ (Document Title Toolbar)

Kế hoạch kinh doanh Q4

🛠 Kỹ thuật triển khai Inline Auto-resize:

  • Shorthand tiện lợi: Sử dụng <ArkEditable autoResize /> để tự động áp dụng container inline-flex và co giãn chiều rộng input theo nội dung.
  • Compound linh hoạt:
    • ArkEditable.Root: Đặt className="inline-flex w-auto items-center" thay cho w-full grid.
    • ArkEditable.Area: Đặt className="w-auto inline-flex" để không chiếm 100% chiều rộng container.
    • ArkEditable.Input: Thêm class [field-sizing:content] (chuẩn CSS mới) kết hợp size={Math.max((editable.value || "").length, 1)} trong <ArkEditable.Context> để co giãn mượt mà trên mọi trình duyệt.

Văn bản nhiều dòng (Textarea với asChild)

ArkEditable.Input hỗ trợ render thẻ textarea nhiều dòng thông qua cơ chế asChild đa hình.

ArkEditable hỗ trợ hiển thị nhiều dòng và textarea hoàn chỉnh nhờ thuộc tính asChild của Ark UI Input.

Sử dụng <ArkEditable.Input asChild><textarea /></ArkEditable.Input> để xử lý văn bản nhiều dòng mượt mà.

Điều khiển bên ngoài (useEditable & RootProvider)

Tách biệt state machine với hook useEditable và truyền vào ArkEditable.RootProvider.

Dữ liệu được điều khiển hoàn toàn từ useEditable

Trạng thái Form (Readonly, Disabled, Invalid)

Tích hợp chuẩn accessibility data attributes và styling tương ứng cho validation.

Văn bản không thể chỉnh sửa khi bật cờ
Bắt buộc nhập trường này...

Cấu trúc Anatomy & Hướng dẫn sử dụng

Thành phần (Subcomponent)Vai tròMô tả
ArkEditable.RootRoot containerChứa state machine Zag và cung cấp context kích thước/biến thể.
ArkEditable.LabelNhãn tiêu đềNhãn gắn với input qua id tương ứng, tự động đánh dấu required.
ArkEditable.AreaVùng nhập liệuBao bọc Preview và Input, nhận style border/background/focus-within.
ArkEditable.PreviewXem trướcHiển thị khi ở chế độ preview, có focus ring và hỗ trợ click/dblclick.
ArkEditable.InputÔ nhập liệuChỉ hiện khi ở chế độ edit, hỗ trợ asChild cho textarea. Khi dùng [field-sizing:content] hoặc autoResize, input tự co giãn chiều rộng theo từng ký tự.
ArkEditable.ControlThanh nút bấmChứa các nút hành động (EditTrigger, SubmitTrigger, CancelTrigger).
ArkEditable.EditTriggerNút sửaChuyển sang chế độ chỉnh sửa khi bấm.
ArkEditable.SubmitTriggerNút lưuXác nhận thay đổi và gọi onValueCommit.
ArkEditable.CancelTriggerNút hủyHủy bỏ các thay đổi và khôi phục giá trị trước đó.
ArkEditable.ContextContext consumerCung cấp quyền truy cập máy trạng thái (editing, value, edit(), cancel(), submit()).
© 2026. FlatVn All rights reserved. Version 4.4.2