파일을 하나씩 싣고, 옵션은 페이지 코드에 적습니다
에디터 코어와 쓸 플러그인 파일을 <script> 로 하나씩 싣고, new WebEditor() 에 옵션을 직접 적는 가장 기본적인 방법입니다. 모든 버전에서 같고, 실리는 파일과 켜지는 기능을 개발자가 정확히 정합니다.
new WebEditor('#editor', { plugins: [...], toolbar: [...] })
준비할 파일
dist/webeditor.min.css— 에디터 스타일dist/webeditor.min.js— 코어(내장 플러그인 11종 포함: 서식 · 그림 · 표 · 링크 · 이모지 · 동영상 · HTML 소스 · 삽입 · 찾기 · 문서 배경 · 도형)dist/plugins/*-native.min.js— 쓸 선택 플러그인만(이 예제는 Word 가져오기wordimport-native.min.js)
적용 순서
- CSS 를
<head>에 싣습니다. - 코어 번들을 싣습니다.
- 쓸 플러그인 파일을 코어 다음에 싣습니다.
new WebEditor('#editor', 옵션)으로 만듭니다.plugins에 실은 플러그인 이름을 넣습니다.
좋은 점
- 실리는 파일 · 켜지는 기능을 정확히 정할 수 있습니다.
- 버전이 바뀌어도 쓰는 법이 같습니다.
- 서버 템플릿 · 번들러에 넣기 쉽습니다.
주의할 점
- 플러그인을 더할 때
<script>와plugins배열을 함께 고쳐야 합니다. - 설정을 바꾸려면 페이지 코드를 고쳐 다시 배포합니다.
license: 'WED2-PMRH-AIR2-EJ3W-KIRM-EJSC-EOS3-EJ3X-O5ZO-MRSX-Q5DF-MRUX-I33S-FZRW-63JC-FQRG-IZLW-FZSG-K6DU-ONXW-Y5LU-NFXW-4LTD-N5WS-ELBC-O53X-OLTE-MV4H-I43P-NR2X-I2LP-NYXG-G33N-EJOS-YITF-EI5D-ALBC-OQRD-UITQ-MVZG-2IRM-EJRS-EORC-MRSX-Q5BC-PULU-NEPL-C4RG-LUX5-AC4H-TLSY-QTPJ-MBCV-VGHG-PVXP-ATQQ-XARS-VCZP-PDWE-HYHW-MUSO-2KH6-QH45-ZPBZ-USBK-EFFR-ABPB-USSS-UETX-LJ2U-DOAV-A'은 localhost 전용 키입니다. 운영에서는 도메인 키로 바꿉니다.
실행 화면
아래 에디터는 이 칸에 들어 있는 예제 코드(아래 「복사해 쓸 코드」와 같음)로 떠 있습니다. 머리글 · 안내는 데모 화면일 뿐 예제에 들어가지 않습니다.
복사해 쓸 코드
빈 HTML 파일에 붙여 넣으면 그대로 동작합니다. dist/ 경로는 에디터 파일을 둔 위치에 맞게 고칩니다.
<!DOCTYPE html>
<html lang="ko">
<head>
<meta charset="UTF-8">
<title>설정 방법 1 — 기존 방식</title>
<link rel="stylesheet" href="dist/webeditor.min.css">
</head>
<body>
<div id="editor"></div>
<!-- ① 코어 번들 -->
<script src="dist/webeditor.min.js"></script>
<!-- ② 쓸 플러그인 파일을 하나씩(여기서는 Word 가져오기 하나) -->
<script src="dist/plugins/wordimport-native.min.js"></script>
<script>
// ③ 옵션을 페이지 코드에 직접 적는다
var editor = new WebEditor('#editor', {
license: 'WED2-PMRH-AIR2-EJ3W-KIRM-EJSC-EOS3-EJ3X-O5ZO-MRSX-Q5DF-MRUX-I33S-FZRW-63JC-FQRG-IZLW-FZSG-K6DU-ONXW-Y5LU-NFXW-4LTD-N5WS-ELBC-O53X-OLTE-MV4H-I43P-NR2X-I2LP-NYXG-G33N-EJOS-YITF-EI5D-ALBC-OQRD-UITQ-MVZG-2IRM-EJRS-EORC-MRSX-Q5BC-PULU-NEPL-C4RG-LUX5-AC4H-TLSY-QTPJ-MBCV-VGHG-PVXP-ATQQ-XARS-VCZP-PDWE-HYHW-MUSO-2KH6-QH45-ZPBZ-USBK-EFFR-ABPB-USSS-UETX-LJ2U-DOAV-A', // localhost 전용 키 — 운영에서는 도메인 키로 바꾼다
height: '360px',
plugins: ['format', 'image', 'table', 'link', 'wordimport'],
toolbar: [['undo', 'redo', '|', 'bold', 'italic', 'underline', '|', 'insertTable', 'insertImage', 'insertLink', '|', 'importDocument']]
});
</script>
</body>
</html>
세 방법 비교
| ① 기존 방식 | ② 한 줄 설정 | ③ 설정 파일 | |
|---|---|---|---|
| 페이지에 싣는 파일 | CSS · 코어 · 쓸 플러그인 파일을 하나씩 | CSS · 코어 둘만 | 설정 파일 → CSS · 코어(선택 플러그인은 ① · ② 처럼) |
| 옵션을 적는 곳 | new WebEditor() 의 옵션 | preset: 'full' + 필요한 옵션 | dee-editor.config.js (페이지 코드에는 없음) |
| 켜지는 기능 | plugins 에 적은 것만 | 문서 가져오기 6종 · 마크다운 · 글자 인식 · 차트 · 메뉴바까지 전부 | 설정 파일에 고른 대로 |
| 설정을 바꿀 때 | 페이지 코드를 고쳐 다시 배포 | 페이지 코드를 고쳐 다시 배포 | 관리자가 도구로 파일만 바꿔 올림 |
| 이럴 때 알맞음 | 실을 파일을 정확히 정하고 싶을 때 · 기존 화면 | 빠르게 전부 켜서 쓰고 싶을 때 | 여러 화면의 설정을 한 곳에서 관리할 때 |
더 알아보기
안내서: 문서/01_시작하기/설정방법_1_기존방식