TutuDocs · 삽입 가능한 컴포넌트
한 줄의 코드로,몇 초 만에 사이트에 문서 편집기를 추가하세요
TutuDocs 문서 편집기(레이아웃 / 표 / 이미지 / 개요)를 어떤 웹사이트에든 삽입하세요. 방문자는 사이트에서 바로 문서를 작성하고, 테마는 구성 가능하며, 제품 업데이트는 자동으로 적용됩니다 — 유지 관리는 전혀 필요 없습니다.
복사해서 붙여넣기 — 페이지의
</body> 태그 앞에 <script src="https://tutudocs.com/embed.js"
data-key="pk_live_YOUR_KEY"
data-mount="#tutudocs-editor" defer></script> pk_live_YOUR_KEY를 콘솔에서 직접 생성한 키(등록된 사용자라면 누구나 — 심사 없이 즉시 적용)로 바꾸세요. 컨테이너 #tutudocs-editor에는 너비와 높이가 필요합니다. 설정 시 삽입 URL을 등록하고(허용 목록, 로컬 개발에는 localhost 사용), 등록한 사이트에서만 표시됩니다.
라이브로 체험하기
아래 버튼을 클릭하면 삽입된 문서 편집기를 이 페이지에서 바로 체험할 수 있습니다.
JS API(콜백 / 사용자 지정이 필요할 때)
<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>전체 구성 옵션
| 매개변수 | 유형 | 설명 |
|---|---|---|
| key | string | 공개 키 pk_(콘솔에서 생성). 필수. |
| theme | 'auto'|'light'|'dark' | 테마. auto는 호스트/시스템의 라이트·다크 모드를 따릅니다. |
| saveText | string | 「완료」 버튼 문구(기본값 「완료 후 되돌려보내기」, 16자 이하). 편집기 기본 상단 바에 표시됩니다(공유/기록 옆). |
| hideSuite | boolean | 패밀리 런처를 숨깁니다(삽입 시 방해를 줄이기 위해 기본적으로 숨김). |
메서드
editor.export()현재 문서를 .docx로 내보냅니다 → Promise<{dataUrl,mime,size}>.editor.setTheme('dark')런타임에 테마를 전환합니다.editor.destroy()컴포넌트를 마운트 해제합니다(iframe 제거).
이벤트 콜백
onReady()편집기가 준비되었습니다.onSave(file)사용자가 「완료」를 클릭 → file.dataUrl은 내보낸 Word 문서(.docx)입니다.onError(e)e.message는 이해하기 쉬운 표현입니다(미활성화 / 권한 없음 / 로드 실패).onClose()전체 화면 오버레이가 닫혔습니다.
보안 · 자동 업데이트
- · 셀프 서비스, 자동 승인: 등록된 사용자라면 누구나 콘솔에서 사이트 이름 + 삽입 URL을 등록하면 즉시 작동하는 키를 받습니다.
- · 키는 공개되어 있으며, 등록 URL 허용/차단 목록으로 도용을 방지합니다(차단 목록 우선). 등록되지 않은 도메인은 등록 안내와 함께 거부되며, 언제든지 일시 중지하거나 다시 시작할 수 있습니다.
- · 실제 출처 통계: 로드될 때마다 Origin 단위로 집계되며(차단된 것도 포함), 콘솔에서 출처별 내역을 볼 수 있고, 등록되지 않은 도메인을 한 번의 클릭으로 허용 목록에 추가할 수 있습니다.
- · 편집기는 TutuDocs 자체 도메인에서(격리되어) 실행됩니다. 귀하의 페이지는 어떤 TutuDocs 자격 증명에도 접근할 수 없으며, 방문자의 TutuDocs 비공개 문서가 삽입된 컴포넌트에 나타나는 일도 없습니다.
- · 컴포넌트는 TutuDocs가 자체 호스팅하고 자동 업데이트합니다 —— 기능 업그레이드 시 귀하 측의 코드 변경이 필요 없으며 유지 관리가 전혀 없습니다.