TAGS

Editing
  • account_tree
  • bug_report

<body>

웹 문서에서 가시적인 플로우 콘텐츠(flow content) 요소들을 배치하는 공간을 나타낸다.

  • 콘텐츠 분류

    NONE

  • 허용된 부모 요소 또는 위치

    <HTML>

    <html>요소의 두 번째 자식 요소

  • 허용된 자식 요소

  • 태그 생략

    시작 태그, 종료 태그 모두 작성

  • DOM Interface

    HTMLBodyElement

    [Exposed=Window]
    interface HTMLBodyElement : HTMLElement {
      [HTMLConstructor] constructor();
    
      // also has obsolete members
    };
    
    HTMLBodyElement includes WindowEventHandlers;
    

설명

<body> 요소는 웹 문서에서 하나만 존재한다. 시작 태그와 종료 태그는 아래와 같이 생략을 할 수 있는 각각의 조건이 있지만 특별한 경우가 아니라면 생략하지 않는 편이 좋다.

시작 태그를 생략할 수 있는 경우
  • <body> 요소가 비워져 있는 경우
  • 첫 번째 항목이 <meta>, <noscript>, <link>, <script>, <style> 또는<template> 요소인 경우를 제외하고 첫 번째 항목이 ASCII 공백이거나 주석이 아닌 경우 
종료 태그를 생략할 수 있는 경우
  • <body> 요소 바로 뒤에 주석이 오지 않는 경우

구문

마크업 형식
<body></body>
Example
<!DOCTYPE html>
<html lang="ko">
<head>
<meta charset="UTF-8">
<title>Example</title>
</head>
<body>
<!-- any contents -->
</body>
</html>

이벤트 핸들러

이벤트 등록은 자바스크립트 사용을 권장한다.

onafterprint

문서가 인쇄를 시작하거나 인쇄 미리보기가 닫힌 후에 발생한다.

사용 예

<body onafterprint="someFunction()">
onbeforeprint

문서가 인쇄되거나 인쇄를 위해 미리보기가 될 때 발생한다.

사용 예

<body onbeforeprint="someFunction()">
onbeforeunload

window, document, resources가 unload되려고 할 때 발생한다.

사용 예

<body onbeforeunload="someFunction()">
onhashchange

URL의 조각 식별자(hash)가 변경되면 발생한다.

사용 예

<body onhashchange="someFunction()">
onlanguagechange

사용자의 기본 언어가 변경될 때 발생한다.

사용 예

<body onlanguagechange="someFunction()">
onmessage

window.postMessage()를 호출하여 창이 메시지를 받았을 때 발생한다.

사용 예

<body onmessage="someFunction()">
onmessageerror

역직렬화를 할 수 없는 메시지를 수신할 때 window에서 발생한다.

사용 예

<body onmessageerror="someFunction()">
onoffline

웹브라우저가 네트워크에 대한 액세스 권한을 잃고 Navigator.onLine 값이 false로 전환되면 발생한다.

사용 예

<body onoffline="someFunction()">
ononline

웹브라우저가 네트워크에 액세스하고 Navigator.onLine의 값이 true로 전환되면 발생한다.

사용 예

<body ononline="someFunction()">
onpagehide

세션 기록과 다른 페이지를 표시하는 과정에서 웹브라우저가 현재 페이지를 숨기면 발생한다. 예를 들어서 사용자가 웹브라우저의 뒤로가기 버튼을 클릭하면 이전 페이지가 표시되기 전에 현재 페이지에서 페이지 숨기기 이벤트를 수신한다.

사용 예

<body onpagehide="someFunction()">
onpageshow

세션 기록 항목에 의해서 페이지가 보여질 때 발생한다.

사용 예

<body onpageshow="someFunction()">
onpopstate

사용자가 세션 기록을 탐색하는 동안 활성 기록 항목이 변경되면 발생한다.

사용 예

<body onpopstate="someFunction()">
onrejectionhandled

Promise가 거부될 때 명시된 거부를 처리 후 전역(Window, Worker) 스코프로 전송된다.

사용 예

<body onrejectionhandled="someFunction()">
onstorage

저장 영역(localStorage 또는 sessionStorage)이 다른 문서의 컨텍스트에서 수정되면 발생한다.

사용 예

<body onstorage="someFunction()">
onunhandledrejection

프로미스(promise)가 거부될 때 명시된 핸들러가 없는 경우 전역(Window, Worker) 컨텍스트(context)로 전송한다.

사용 예

<body onunhandledrejection="someFunction()">
onunload

문서나 하위 리소스가 언로드(unload)일 때 발생한다.

사용 예

<body onunload="someFunction()">

글로벌 애트리뷰트

일부 글로벌 애트리뷰트는 이 요소에서 사용되지 않을 수 있다.

글로벌 이벤트 핸들러

일부 글로벌 이벤트 핸들러는 이 요소에서 사용되지 않을 수 있다. 이벤트 등록은 자바스크립트 사용을 권장한다.

버전 명세

HTML Standard
#the-body-element

지원 웹브라우저