editor

문서 › 사진과 미디어

지도·퍼가기 코드

구글 지도, 허용한 사이트의 iframe 코드 넣기. 카카오맵·네이버 지도는 링크 카드로.

찾아오는 길 지도, 설문, 예약 위젯처럼 다른 사이트가 주는 퍼가기(iframe) 코드를 글에 넣습니다. 허용한 사이트의 코드만 들어갑니다.

직접 써 보기

이 데모의 코드

createEditor('#editor', {
  toolbar: 'embed video | undo redo',
  height: 400,
  allowedIframeHosts: ['www.openstreetmap.org'],
});

넣는 방법

툴바의 지도·퍼가기 코드(embed) 단추를 누르고, 주소나 <iframe …> 코드를 붙여 넣습니다. 들어간 내용에 따라 이렇게 처리합니다.

넣은 것결과
동영상 주소나 동영상 iframe 코드동영상으로 넣습니다.
구글 지도 [공유 → 지도 퍼가기] 코드지도를 넣습니다. 기본으로 허용됩니다.
카카오맵·네이버 지도 주소 (map.kakao.com, kko.to, map.naver.com, naver.me)이 사이트들은 다른 사이트에 끼워 넣을 수 없어서 링크 카드로 넣고 안내를 띄웁니다.
allowedIframeHosts 에 있는 사이트의 코드나 https 주소그 iframe 을 넣습니다.
그 밖의 사이트"이 사이트는 넣을 수 없어요" 안내를 띄우고 넣지 않습니다.

iframe 코드에 height 가 있으면 그 높이를(150–1200px 사이로), 없으면 450px 을 씁니다. 너비는 항상 본문 너비에 맞춥니다.

사이트 허용하기

createEditor('#editor', {
  allowedIframeHosts: [
    'www.openstreetmap.org',
    'docs.google.com/forms',   // 주소 앞부분까지 적으면 그 경로만 허용
  ],
});

항목은 호스트 이름이고, / 뒤에 경로를 붙이면 그 경로로 시작하는 주소만 허용합니다. https 주소만 됩니다. 이 목록은 퍼가기 창뿐 아니라 setHTML, 붙여넣기, HTML 소스 보기에도 똑같이 적용됩니다.

저장되는 HTML

<div data-embed="" style="margin: 0.8em 0">
  <iframe src="https://www.google.com/maps/embed?pb=…" style="width: 100%; height: 450px; border: 0"
    loading="lazy" allowfullscreen="" title="embed"></iframe>
</div>

에디터 안에서는 한 덩어리로 다뤄집니다. 누르면 고를 수 있고 지우거나 Alt+Shift+↑/↓ 로 옮길 수 있습니다.

툴바에서의 위치

embed 는 board 와 full 프리셋의 ⋯ 더보기 메뉴에 있습니다.

옵션

이름타입기본값설명
embedtoolbar item주소 또는 퍼가기 코드를 넣는 창을 엽니다.
allowedIframeHostsstring[][]더 허용할 iframe 호스트. 호스트/경로 로 경로까지 제한할 수 있습니다.
fetchLinkMeta(url) => Promise<LinkMeta | null>카카오맵·네이버 지도를 카드로 넣을 때 제목과 사진을 가져옵니다.