<base>

Baseline Widely available

This feature is well established and works across many devices and browser versions. It’s been available across browsers since July 2015.

HTML <base> 요소는 문서 안의 모든 상대 URL이 사용할 기준 URL을 지정합니다. 문서에는 하나의 <base> 요소만 존재할 수 있습니다.

문서의 기준 URL을 스크립트에서 접근해야할 땐 document.baseURI을 사용할 수 있습니다. 문서에 <base> 요소가 존재하지 않을 때 baseURI의 기본값은 location.href입니다.

콘텐츠 카테고리 메타데이터 콘텐츠.
가능한 콘텐츠 없음. 빈 요소입니다.
태그 생략 닫는 태그는 존재해선 안됩니다.
가능한 부모 요소 다른 <base> 요소를 포함하지 않는 <head> 요소.
암시적 ARIA 역할 대응하는 역할 없음
가능한 ARIA 역할 없음
DOM 인터페이스 HTMLBaseElement

특성

이 요소는 전역 특성을 포함합니다.

경고 : 다음 특성 중 하나라도 지정한 경우, 상대 URL을 특성에 사용한 모든 요소보다 <base>가 앞에 위치해야 합니다.

  • href

    • : 문서 내 상대 URL이 사용할 기준 URL. 절대 및 상대 URL을 사용할 수 있습니다.

  • target

    • : target 속성을 명시하지 않은 <a>, <area>, 또는 <form> 요소가 탐색을 유발했을 때, 그 결과를 보여줄 기본 브라우징 맥락. 키워드나 저작자 정의 이름으로 지정합니다.

    다음 키워드는 특별한 의미를 갖습니다.

    • _self (기본값): 결과를 현재 브라우징 맥락에 보여줍니다.
    • _blank: 결과를 새로 생성한, 이름 없는 브라우징 맥락에 보여줍니다.
    • _parent: 현재 페이지가 프레임 안에 존재하는 경우, 결과를 현재 브라우징 맥락의 부모에 보여줍니다. 부모가 없으면 _self와 동일합니다.
    • _top: 결과를 최상위 브라우징 맥락에 보여줍니다. 최상위 브라우징 맥락이란 현재 맥락의 조상 중 부모가 없는 맥락입니다. 현재 맥락이 부모를 가지지 않으면 _self와 동일합니다.

사용 일람

다중 <base> 요소

<base> 요소가 여러 개 존재하는 경우 첫 href와 첫 target만 사용하며 나머지는 모두 무시합니다.

페이지 내부 앵커

<a href="#some-id">처럼, 문서 프래그먼트를 가리키는 링크 주소도 <base>를 사용해 처리하므로, 기준 URL 뒤에 프래그먼트를 붙인 주소로 HTTP 요청을 유발합니다. 예를 들어,

  1. <base href="https://example.com">을 가정
  2. <a href="#anchor">Anker</a>를 가정
  3. 2번의 링크는 https://example.com/#anchor를 가리킵니다.

Open Graph

Open Graph 태그는 <base>를 인식하지 않으므로 항상 온전한 형태의 절대 URL을 지정해야 합니다.

html
<meta property="og:image" content="https://example.com/thumbnail.jpg" />

예제

html
<base href="http://www.example.com/page.html" />
<base target="_blank" />
<base target="_target" href="http://www.example.com/page.html" />

명세

Specification
HTML Standard
# the-base-element

브라우저 호환성

BCD tables only load in the browser