TutuDocs · Thành phần có thể nhúng
Một dòng mã — thêm trình soạn thảo tài liệu vào trang của bạn trong vài giây
Nhúng trình soạn thảo tài liệu TutuDocs (bố cục / bảng / hình ảnh / dàn ý) vào bất kỳ trang web nào của bạn. Khách truy cập soạn tài liệu ngay trên trang của bạn, chủ đề có thể cấu hình, và các bản cập nhật sản phẩm tự động có hiệu lực — bạn không cần bảo trì gì cả.
Sao chép & dán — trước thẻ
</body> của trang bạn <script src="https://tutudocs.com/embed.js"
data-key="pk_live_YOUR_KEY"
data-mount="#tutudocs-editor" defer></script>Thay pk_live_YOUR_KEY bằng khóa mà bạn tự tạo trong bảng điều khiển (bất kỳ người dùng đã đăng ký nào — không cần duyệt, có hiệu lực ngay); vùng chứa #tutudocs-editor cần có chiều rộng và chiều cao. Đăng ký URL nhúng của bạn khi thiết lập (danh sách cho phép; với phát triển cục bộ hãy điền localhost); nó chỉ hiển thị trên các trang bạn đã đăng ký.
Trải nghiệm trực tiếp
Nhấn nút bên dưới để thử trình soạn thảo tài liệu được nhúng ngay tại đây.
JS API (cho callback / tùy chỉnh)
<script src="https://tutudocs.com/embed.js"></script>
<script>
const editor = TutuDocs.mount('#tutudocs-editor', {
key: 'pk_live_YOUR_KEY',
theme: 'auto', // auto | light | dark
onSave: (file) => {
// file.dataUrl = the exported Word document (.docx, base64)
upload(file.dataUrl);
}
});
// After the user clicks Done, onSave returns the .docx; or call it directly:
// const { dataUrl } = await editor.export();
</script>Toàn bộ tùy chọn cấu hình
| Tham số | Kiểu | Mô tả |
|---|---|---|
| key | string | Khóa công khai pk_ của bạn (tạo trong bảng điều khiển). Bắt buộc. |
| theme | 'auto'|'light'|'dark' | Chủ đề; auto theo chế độ sáng/tối của host/hệ thống. |
| saveText | string | Nhãn nút «Hoàn tất» (mặc định «Hoàn tất và gửi lại», ≤16 ký tự). Hiển thị trên thanh trên cùng gốc của trình soạn thảo (cạnh Chia sẻ/Lịch sử). |
| hideSuite | boolean | Ẩn trình khởi chạy bộ ứng dụng (ẩn theo mặc định khi nhúng để giảm phân tâm). |
Phương thức
editor.export()Xuất tài liệu hiện tại thành .docx → Promise<{dataUrl,mime,size}>.editor.setTheme('dark')Chuyển chủ đề khi đang chạy.editor.destroy()Gỡ thành phần (xóa iframe).
Callback sự kiện
onReady()Trình soạn thảo đã sẵn sàng.onSave(file)Người dùng nhấn «Hoàn tất» → file.dataUrl là tài liệu Word đã xuất (.docx).onError(e)e.message được viết dễ hiểu (chưa bật / không có quyền / tải thất bại).onClose()Lớp phủ toàn màn hình đã bị đóng.
Bảo mật · Tự động cập nhật
- · Tự phục vụ, tự động phê duyệt: bất kỳ người dùng đã đăng ký nào cũng đăng ký tên trang + URL nhúng trong bảng điều khiển và nhận được khóa hoạt động ngay.
- · Khóa là công khai; việc chống lạm dụng dựa vào danh sách cho phép/chặn URL đã đăng ký (danh sách chặn được ưu tiên). Tên miền chưa đăng ký sẽ bị từ chối kèm nhắc đăng ký; bạn có thể tạm dừng hoặc tiếp tục bất cứ lúc nào.
- · Thống kê nguồn thực: mỗi lần tải được tính theo Origin (kể cả lần bị chặn); bảng điều khiển hiển thị chi tiết theo từng nguồn, và bạn có thể thêm tên miền chưa đăng ký vào danh sách cho phép chỉ với một cú nhấp.
- · Trình soạn thảo chạy trên miền riêng của TutuDocs (cách ly); trang của bạn không thể truy cập bất kỳ thông tin xác thực nào của TutuDocs, và tài liệu riêng tư TutuDocs của khách truy cập không bao giờ xuất hiện trong thành phần được nhúng.
- · Thành phần được TutuDocs tự lưu trữ và tự động cập nhật — nâng cấp tính năng không cần thay đổi mã ở phía bạn; không cần bảo trì.