릴리즈 3.3.2602 이상
사용 시 유의사항
임포트한 원본 문서와 익스포트된 문서 간의 표현 및 품질이 동일함을 보장하지는 않습니다.
웹 에디터 환경의 구조적 특성으로 인해 원본 문서 양식과의 1:1 매칭이 어려우며, 이로 인해 일부 객체가 누락되거나 비정상적으로 표시될 수 있습니다.
모듈 적용
문서를 익스포트하는 기능을 사용하기 위해서는 에디터 패키지 externals 폴더 아래에 포함된 임포트/익스포트 모듈인 SEDocModelParser를 적용해야 합니다.
<!-- 임포트/익스포트 모듈 --> <script src="externals/SEDocModelParser/SEDocModelParser.min.js"></script>
툴바 설정
에디터 툴바설정에 'export'추가 시 내보내기 다이얼로그를 사용할 수 있습니다.
{
'editor.toolbar': [..., 'export', ...]
}
내보내기 확장자 설정
릴리즈 3.3.2603 이상
내보내기 다이얼로그에 표시할 파일 형식을 설정합니다.
설정한 확장자는 배열에 입력한 순서대로 표시됩니다.
- 빈 배열로 설정하면 파일 형식 항목이 표시되지 않습니다.
- 1개만 설정하면 해당 항목만 표시되며, UI는 변경할 수 없도록 비활성화됩니다.
공식 지원 포맷은 hwpx입니다. hwp, docx는 변환 과정에서 일부 제한이 있을 수 있습니다.
{
'editor.export.extensions': ['docx', 'hwpx'] // defalut: ['docx', 'hwpx', 'hwp']
}
내보내기 기본 확장자 설정
릴리즈 3.3.2603 이상
내보내기 다이얼로그에서 기본으로 선택할 파일 형식을 설정합니다.
'editor.export.defaultExtension'을 설정한 경우, 해당 값이 'editor.export.extensions'에 포함되어 있으면 기본값으로 적용됩니다.
기본값 설정이 없거나 허용 목록에 없는 값인 경우에는 'editor.export.extensions'의 첫 번째 확장자를 기본값으로 사용합니다.
{
'editor.export.defaultExtension': 'docx' // defalut 'hwpx'
}
예시
| 설명 | 내보내기 확장자를 빈 배열로 설정하는 경우 | 내보내기 확장자를 1개만 설정하는 경우 | 내보내기 확장자를 2개 이상 설정하고 내보내기 기본 확장자를 수정한 경우 |
|---|---|---|---|
| 설정값 | synapeditor.config.js {
'editor.export.extensions': []
}
| synapeditor.config.js {
'editor.export.extensions': ['hwpx']
}
| synapeditor.config.js {
'editor.export.extensions': ['docx', 'hwpx'],
'editor.export.defaultExtension': 'docx'
}
|
| 결과화면 |
|
|
|
익스포트 UI 다이얼로그
| 항목 | 설명 | 값 |
|---|---|---|
| 파일형식 | 파일 포맷을 지정합니다. 공식 지원 포맷은 hwpx입니다. | HWPX(default) HWP DOCX |
| 용지방향 | 용지 방향을 설정합니다. | A4 세로(default) A4 가로 |
| 파일이름 | 저장할 파일명을 입력합니다. | 문자열 (미입력 시: untitled) |
내보내기 시 생성된 파일은 사용 중인 브라우저의 기본 다운로드 경로에 저장됩니다.