문서 › 사진과 미디어
이미지 넣기와 편집
사진 넣기, 모서리 끌어 크기 조절, 배치, 대체 텍스트, 캡션, 사진에 링크.
글에 사진을 넣고, 넣은 사진을 눌러 크기·배치·캡션을 바꿉니다. 게시판 글, 블로그 글처럼 사진이 섞인 글이면 거의 다 씁니다.
직접 써 보기
사진을 눌러 보세요. 모서리를 끌면 크기가 바뀌고, 위에 뜨는 막대에서 배치·캡션·링크를 바꿀 수 있습니다.
왼쪽 배치(글 감싸기)를 고른 사진입니다. 글이 사진 오른쪽으로 흐릅니다. 사진을 누르고 막대에서 가운데나 글자처럼을 골라 보세요.
이 데모의 코드
createEditor('#editor', {
toolbar: 'image | alignLeft alignCenter alignRight | undo redo',
height: 400,
uploadImage: async (file) => URL.createObjectURL(file),
});넣는 방법
- 툴바의 이미지 단추(
image): 끌어다 놓는 칸을 누르거나 파일을 끌어 놓습니다. 여러 장을 한 번에 고를 수 있습니다. 아래 칸에 주소와 대체 텍스트를 적어 주소로 넣을 수도 있습니다. - 본문에 사진 파일을 끌어다 놓기, 캡처한 화면이나 복사한 사진을 Ctrl+V 로 붙여넣기.
- 빈 줄에서 / 를 치고 "이미지"나 "사진"을 찾기 (슬래시 메뉴).
어느 길로 넣든 먼저 화면에 미리보기가 뜨고, 올리기가 끝나면 서버 주소로 바뀝니다. 업로드 설정이 없으면 base64 로 글 안에 들어가니, 운영 사이트에서는 이미지 업로드를 설정하세요. 큰 사진 줄이기와 HEIC 변환은 사진 줄이기·변환에 있습니다.
크기 조절
사진을 누르면 네 모서리에 손잡이가 생기고 현재 크기(가로 × 세로)가 보입니다. 손잡이를 끌면 비율을 지키며 너비가 바뀝니다. 가장 작게는 24px, 가장 크게는 본문 너비까지입니다. 휴대폰에서도 손가락으로 끌 수 있습니다.
막대의 25% 50% 75% 100% 는 본문 너비에 대한 비율로, 1:1 은 원본 크기로 되돌립니다.
사진 막대
사진을 누르면 위에 막대가 뜹니다.
| 단추 | 하는 일 |
|---|---|
| 글자처럼 / 왼쪽 배치 / 가운데 / 오른쪽 배치 | 글자처럼은 글 줄 안에 둡니다. 왼쪽·오른쪽 배치는 float 로 글이 사진 옆을 감쌉니다. 가운데는 좌우 여백을 auto 로 둡니다. |
| 25% … 100%, 1:1 | 너비를 비율로 정하거나 원본 크기로 되돌립니다. |
| 대체 텍스트(설명) | alt 를 적습니다. 화면 낭독기가 읽고, 사진이 안 뜰 때 대신 보입니다. |
| 캡션 넣기 | 사진을 <figure> 로 감싸고 아래에 <figcaption> 을 붙입니다. 다시 누르면 캡션을 뺍니다. |
| 이미지 편집 | 자르기·돌리기·뒤집기 (이미지 편집). |
| 이미지에 링크 | 사진을 <a> 로 감쌉니다. 새 창, nofollow 도 고를 수 있습니다. 사진을 고른 채 Ctrl+K 도 같습니다. |
| 이미지 바꾸기 | 같은 자리, 같은 배치로 다른 사진을 올립니다. |
| 이미지 삭제 | 사진을 지웁니다. 사진을 고른 채 Backspace 나 Delete 도 같습니다. |
툴바의 alignLeft alignCenter alignRight 와 Ctrl+Shift+L/E/R 도 사진을 고른 상태에서는 사진에 적용됩니다. 이때 왼쪽은 "글자처럼"이 됩니다.
툴바에서의 위치
image 는 basic, board, full 프리셋의 첫 줄에 있습니다(minimal 에는 없음). 휴대폰에서는 한 줄 툴바의 맨 앞에 옵니다.
저장되는 HTML
<figure style="margin: 0 0 1em; display: table; margin-left: auto; margin-right: auto; text-align: center">
<img src="/files/a.jpg" alt="숲길 사진" style="width: 360px; height: auto; max-width: 100%" width="640" height="400">
<figcaption style="font-size: 0.875em; color: #667085; margin-top: 6px">캡션</figcaption>
</figure>
<p><img src="/files/b.jpg" alt="" style="float: left; margin: 0 16px 8px 0; width: 160px; height: auto; max-width: 100%" width="320" height="240" loading="lazy">글…</p>배치와 크기는 모두 인라인 스타일이라 보기 화면에 에디터 CSS 가 없어도 똑같이 보입니다. responsiveOutput(기본 켜짐)이 max-width: 100% 와 원본 width/height 를 붙여 휴대폰에서 넘치지 않고, lazyImages(기본 켜짐)가 두 번째 사진부터 loading="lazy" 를 붙입니다. 자세한 내용은 저장되는 HTML.
옵션
| 이름 | 타입 | 기본값 | 설명 |
|---|---|---|---|
image | toolbar item | 이미지 넣기 창을 엽니다. | |
uploadImage | (file, { onProgress }) => Promise<string> | 사진을 올리고 주소를 돌려주는 함수. 이미지 업로드 | |
uploadUrl | string | 함수 대신 이 주소로 POST 합니다. | |
imageAccept | string | 'image/*,.heic,.heif' | 고를 수 있는 파일 형식. |
imageMaxSize | number (byte) | 없음 | 사진 한 장의 최대 크기. |
responsiveOutput | boolean | true | 저장할 때 max-width: 100% 와 원본 크기를 붙입니다. |
lazyImages | boolean | true | 두 번째 사진부터 loading="lazy". |