0Pricing
HTML Academy · 강의

사용자 정의 데이터 속성 data-*

data-* 속성으로 사용자 정의 데이터를 요소에 직접 저장합니다.

사용자 정의 데이터 속성 data-*은(는) CoddyKit의 무료 HTML Academy 강의입니다. 이것은 4개 중 4번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 HTML Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. HTML Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

data-* 속성이란 무엇인가요?

사용자 지정 데이터 속성을 사용하면 HTML 요소에 추가 정보를 직접 저장할 수 있습니다:

<button data-user-id="42" data-action="delete">Delete User</button>
<li data-category="frontend" data-level="beginner">HTML</li>

<!-- Format: data-[name]="value" -->
<!-- Any alphanumeric name after data- is valid -->
<!-- Values are always strings -->

data-*가 만들어진 이유

data-*가 생기기 전에는 개발자가 다음과 같은 곳에 추가 데이터를 저장했습니다:

  • 숨겨진 입력 필드(관리하기 어려움)
  • CSS 클래스 이름(취약함)
  • rel이나 title 같은 비표준 속성(유효하지 않은 HTML)

HTML5에서는 의미나 표현 방식에 영향을 주지 않고 사용자 지정 데이터를 삽입하는 공식 방법으로 data-*를 표준화했습니다.

이름 지정 규칙

data-* 속성 이름 지정 규칙입니다:

  • data-로 시작해야 합니다
  • 이름에는 소문자, 숫자, 하이픈, 밑줄, 마침표를 사용할 수 있습니다
  • 이름에 대문자를 사용할 수 없습니다(HTML 명세가 대문자를 소문자로 바꿉니다)
  • 이름은 xml로 시작할 수 없습니다
<div data-user-id="1">OK</div>
<div data-product-category="tools">OK</div>
<!-- <div data-XML-thing="1">BAD: starts with xml -->
<!-- <div data-MyProp="1">BAD: uppercase in name -->

JavaScript에서 data-* 읽기

dataset 속성을 통해 사용자 지정 데이터에 접근합니다:

<button id="btn"
  data-user-id="42"
  data-action="delete"
  data-confirm-message="Are you sure?"
>
  Delete
</button>

<script>
const btn = document.getElementById('btn');
console.log(btn.dataset.userId);          // '42'
console.log(btn.dataset.action);          // 'delete'
console.log(btn.dataset.confirmMessage);  // 'Are you sure?'
// Note: data-user-id → dataset.userId (camelCase conversion)
</script>

dataset으로 data-* 작성하기

dataset을 통해 데이터 속성을 설정하고 제거합니다:

const card = document.querySelector('.card');

// Set:
card.dataset.status = 'active';
// Now: <div class="card" data-status="active">

// Delete:
delete card.dataset.status;
// Now: data-status is removed

// Alternatively with setAttribute:
card.setAttribute('data-status', 'inactive');
card.removeAttribute('data-status');

하이픈을 camelCase로 변환하기

dataset API는 하이픈으로 구분된 이름을 camelCase로 변환합니다:

<!-- HTML attribute         JavaScript dataset property -->
data-user-id           →   dataset.userId
data-product-category  →   dataset.productCategory
data-max-retries       →   dataset.maxRetries
data-is-active         →   dataset.isActive

CSS 속성 선택자

CSS 선택자에서 데이터 속성을 사용합니다:

[data-status="active"] {
  color: green;
}

[data-status="inactive"] {
  color: gray;
  text-decoration: line-through;
}

/* Present but any value: */
[data-featured] {
  border: 2px solid gold;
}

툴팁 패턴

데이터 속성을 사용하여 순수 CSS 툴팁을 만듭니다:

<span data-tooltip="This is a tooltip">Hover me</span>

/* CSS: */
/*
[data-tooltip] {
  position: relative;
}
[data-tooltip]::after {
  content: attr(data-tooltip);  /* attr() reads the attribute value */
  position: absolute;
  background: #333;
  color: white;
  padding: 0.25rem 0.5rem;
  border-radius: 4px;
  white-space: nowrap;
  opacity: 0;
  pointer-events: none;
  transition: opacity 0.2s;
}
[data-tooltip]:hover::after { opacity: 1; }
*/

상태 추적 패턴

데이터 속성으로 구성 요소의 상태를 추적합니다:

<button data-state="off" id="toggle">Toggle</button>

<script>
document.getElementById('toggle').addEventListener('click', function() {
  const state = this.dataset.state;
  this.dataset.state = state === 'off' ? 'on' : 'off';
  this.textContent = this.dataset.state === 'on' ? 'Active' : 'Toggle';
});
</script>

/* CSS: */
/* [data-state="on"] { background: green; color: white; } */

data-*와 JavaScript 변수 비교

data-*를 사용할지 JavaScript에 데이터를 저장할지 결정하는 기준입니다:

  • DOM 요소에 직접 대응하고 CSS에서 읽을 수 있는 값에는 data-*를 사용합니다
  • 특정 요소와 연결되지 않은 복잡한 데이터 구조에는 JavaScript 변수나 객체를 사용합니다
  • 대용량 데이터나 민감한 데이터를 data-*에 저장하지 마십시오. DevTools에서 볼 수 있습니다

data-*는 표현을 위한 기능이 아닙니다

다음과 같은 일반적인 실수를 피하십시오:

<!-- BAD: storing presentation data in data-* -->
<div data-color="red" data-font-size="18">Text</div>
<!-- Use CSS classes instead: -->
<div class="text-danger text-lg">Text</div>

<!-- BAD: storing sensitive data -->
<div data-api-key="sk-123...">Content</div>
<!-- NEVER store secrets in HTML attributes -->

빠른 확인

dataset API는 data-product-id 속성에 어떻게 접근하나요?

복습: data-* 속성

사용자 지정 데이터 속성의 핵심 내용입니다:

  • data-name="value" — 요소에 사용자 지정 메타데이터를 저장합니다
  • element.dataset.camelCase를 통해 접근합니다
  • dataset API에서는 하이픈이 camelCase로 변환됩니다
  • [data-name="value"] 선택자를 사용하여 CSS에서 활용합니다
  • 민감한 데이터(키, 비밀번호)를 데이터 속성에 절대 저장하지 마십시오

자주 묻는 질문

“사용자 정의 데이터 속성 data-*” 강의는 무료인가요?

네 — “사용자 정의 데이터 속성 data-*” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 HTML Academy 강의 전체를 잠금 해제할 수 있습니다. HTML Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“사용자 정의 데이터 속성 data-*”에서 뭘 배우나요?

data-* 속성으로 사용자 정의 데이터를 요소에 직접 저장합니다. 브라우저에서 직접 실행하는 실습 코드로 HTML Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

HTML Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 HTML Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 4번째 강의입니다.

“사용자 정의 데이터 속성 data-*” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 HTML Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 HTML Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. id, class, style 및 title
  2. hidden 속성
  3. tabindex와 accesskey
  4. 사용자 정의 데이터 속성 data-*
← HTML Academy(으)로 돌아가기