이미지
이미지 주소를 넣고 폭과 정렬을 조절합니다. 주소는 http:, https: 또는 같은 사이트 경로만 기본으로 허용하며, 새 이미지는 가운데 정렬과 60% 폭으로 시작합니다.
폭은 정해진 단계 안에서만 저장되고 정렬은 이미지를 감싼 문단에 저장됩니다. blob:과 data:image/... 미리보기를 쓰려면 이미지 wing과 편집기 조립 쪽에서 각각 로컬 URL을 명시적으로 허용해야 합니다. SVG 데이터 URL은 허용되지 않습니다.
npm install nabi-noteimport {
createLocale, createNabiWith, mountSurface, mountToolbar,
mountContextToolbar, mountHints, watchSettle, tableWings, imageWing,
youtubeWing, mountViewTools,
} from 'nabi-note'
const selected = [
...tableWings,
imageWing,
youtubeWing,
]
const locale = createLocale('ko')
const { nabi, registry } = createNabiWith(selected, { locale })
const root = document.querySelector('.nabi')!
const content = document.querySelector('.nabi-content')!
// locale 이 글의 방향도 정한다 — 아랍어·우르두면 오른쪽에서 왼쪽으로 선다
mountSurface({ nabi, registry, root: content, locale })
const settle = watchSettle(document, { surface: content })
const shared = { nabi, registry, surface: content, settle, locale }
const toolbar = mountToolbar({ ...shared, root: document.querySelector('#toolbar')! })
const context = mountContextToolbar({ ...shared, root: document.querySelector('#context')! })
mountHints({ toolbar, context, root, surface: content })
// 미리보기·전체화면 두 단추 — 툴바 줄의 끝에 제 상자를 세워 앉는다
mountViewTools({ ...shared, root, container: document.querySelector('#toolbar')! })
// 값이 바뀔 때마다 — 여기에 당신의 코드를 건다
// nabi.onChange(() => user_callback(nabi.getHtml()))
// 언어 선택 이벤트에서 호출한다. 내용과 편집 이력은 유지된다.
// locale.setLocale('ko')const selected = wings().use('img', {
allowLocalUrls: false,
}).build()이 wing은 주소를 문서에 넣는 기능이며 파일 전송은 하지 않습니다. 파일을 서버로 보내려면 업로드 wing을 연결합니다.
이미지 선택창 연결하기
mountToolbar()의 panels.img로 이미지 버튼의 기본 URL 입력창을 서비스의 이미지 선택창으로 바꿀 수 있습니다. 키는 툴바 슬롯 이름이며, 생략한 도구는 기존 입력창을 사용합니다.
mode: 'modal'은 전체 화면 반투명 배경 위에 창을 엽니다. mode: 'inline'은 PC에서는 도구 버튼 근처에 열고 모바일에서는 전체 화면으로 표시합니다. 모바일 여부는 화면 폭과 --nabi-mobile-breakpoint로 정하며, inline 창이 열린 채로 이 기준을 넘으면 창을 닫습니다.
두 모드는 빈 root만 제공하며 제목·입력칸·버튼은 만들지 않습니다. render에서 원하는 HTML이나 UI를 넣고, 닫기 버튼은 close()에, 이미지 선택은 insertImage(url, 'pointer')에 연결합니다. 기존 img: renderer 함수형 설정의 표시 방식은 유지됩니다.
import { mountToolbar } from 'nabi-note'
const toolbar = mountToolbar({
nabi,
registry,
root: toolbarRoot,
surface: content,
panels: {
img: {
mode: 'inline',
render: ({ root, signal, close, insertImage }) =>
mountMyImagePicker(root, {
signal,
onClose: close,
onSelect: (url: string) => insertImage(url, 'pointer'),
}),
},
},
})mountMyImagePicker는 서비스에서 구현하는 함수입니다. 전달받은 root에 원하는 UI를 동기적으로 만들고 해제 함수를 반환합니다. 이미지 목록 조회·업로드 같은 비동기 작업에는 signal을 연결하고, 고른 이미지 URL을 onSelect에 넘깁니다. 이 API는 파일을 전송하지 않으며, URL에는 기존 이미지 허용 규칙이 적용됩니다.
insertImage(src, by?)는 run('insertImage', { src }, by)와 같으며 반환값과 선택 복원 규칙도 같습니다. by를 생략하면 'keyboard'를 사용합니다. render는 async 함수로 만들지 마세요.
창을 닫거나 툴바를 해제하면 signal이 중단되고 해제 함수가 실행됩니다. run()은 창을 닫고 열 당시 선택에 명령을 한 번 적용합니다. 이미 창이 닫혔거나 열린 뒤 문서 내용이 바뀌었다면 false를 반환하고 명령을 실행하지 않습니다.
커서만 다른 위치로 옮겼다면 창을 연 원래 위치에 삽입합니다. 표 셀이나 플로트 영역 안에서 열었다면 그 안에 이미지가 들어갑니다. 문서를 편집하거나 교체한 뒤 실행 취소로 내용이 같아졌더라도 삽입을 취소하고 안내하므로, 다시 창을 열어 이미지를 고르면 됩니다.
CSS 스타일
이미지는 .nabi-content img로 꾸밉니다. 저장된 폭과 정렬은 그대로 두고 테두리나 그림자처럼 모양만 바꾸세요.
.article-body img {
border-radius: 12px;
box-shadow: 0 8px 24px rgb(0 0 0 / 12%);
}
.dark .article-body img { box-shadow: 0 8px 24px rgb(0 0 0 / 35%); }max-inline-size, block-size, 폭과 정렬에 관한 기본 규칙은 유지하세요. 이미지 크기는 문서에 저장된 값이므로 CSS에서 강제로 고정하면 작성자가 정한 폭과 충돌할 수 있습니다.