Shared UI@xyflow/react

Flow Editor

Bộ ví dụ tương tác cho canvas đồ thị dùng chung. Khám phá các cách xây dựng trình thiết kế, sơ đồ chỉ xem và trải nghiệm chỉnh sửa trên máy tính hoặc màn hình cảm ứng.

Dữ liệu mẫu chỉ nằm trong bộ nhớ và được đặt lại khi đổi ví dụ hoặc tải lại trang. Ví dụ bất đồng bộ dùng mô phỏng, không gửi dữ liệu lên server.

Canvas cơ bản

Hover để nhận biết node. Kéo dây hoặc chạm đầu ra rồi đầu vào: đích hợp lệ màu xanh, đích bị từ chối màu đỏ. Node “Không nhận kết nối” minh họa validation; cạnh trùng và chu trình cũng bị chặn.

Thử nối “Tiếp nhận” → “Phê duyệt” để thấy đích hợp lệ màu xanh, hoặc tới “Không nhận kết nối” để thấy đích bị từ chối màu đỏ. Có thể kéo dây hoặc chạm đầu ra rồi đầu vào; dây không hợp lệ sẽ không được thêm.

Sẵn sàng5 phần tử · 3 dây nối · 0 đang chọn

Thử trên bàn phím và cảm ứng

  • Kéo nền để pan; chụm hai ngón hoặc dùng controls để zoom.
  • Trên cảm ứng, kéo tay nắm phía trên node để di chuyển, nhấn giữ để mở thao tác.
  • Chọn nhiều bằng nút công cụ, chạm từng node hoặc kéo một vùng chọn.
  • Nhấn Escape hoặc Hủy thao tác để kết thúc; shortcuts trong ô nhập vẫn hoạt động bình thường.
  • Bật chỉ xem để thử xem thông tin và pan/zoom khi các mutation bị khóa.

Tích hợp tối thiểu

Mỗi canvas có một provider và graph controlled. Truyền callback nghiệp vụ cho các capability cần hỗ trợ.

import {
  FlowEditor, FlowEditorProvider, useFlowProjection,
} from '~/components/flow-editor';

function Canvas() {
  const graph = useFlowProjection(initialGraph);
  return (
    <div className="h-140">
      <FlowEditor
        nodes={graph.nodes}
        edges={graph.edges}
        onNodesChange={graph.onNodesChange}
        onEdgesChange={graph.onEdgesChange}
        onMoveNodes={graph.onMoveNodes}
        capabilities={{ select: true, move: true }}
        fitView
      />
    </div>
  );
}

export default function Example() {
  return <FlowEditorProvider><Canvas /></FlowEditorProvider>;
}
© 2026. FlatVn All rights reserved. Version 4.4.2