ไวยากรณ์ data-* และแบบแผนการตั้งชื่อ

ทบทวน: แอตทริบิวต์ data-*

<div data-user-id="42" data-role="admin" data-active="true">
  User Card
</div>

กฎการตั้งชื่อที่ถูกต้อง

หลักการตั้งชื่อ

<!-- BEM-style: module__element--modifier -->
data-card="profile"
data-card-id="42"
data-card-state="expanded"

<!-- Descriptive: domain-concept -->
data-product-id="SKU-123"
data-analytics-event="click-cta"
data-feature-flag="dark-mode"

แอตทริบิวต์ข้อมูลหลายรายการ

<button
  type="button"
  data-action="delete"
  data-target-id="user-42"
  data-confirm="true"
  data-confirm-message="Delete this user permanently?"
>Delete</button>

ค่าเป็นสตริงเสมอ

const el = document.querySelector('[data-user-id]');

console.log(el.dataset.userId);              // '42' (string)
console.log(typeof el.dataset.userId);       // 'string'

// Parse to number:
const id = parseInt(el.dataset.userId, 10);   // 42 (number)

// Parse to boolean:
const active = el.dataset.active === 'true'; // true (boolean)

// Parse to JSON:
const config = JSON.parse(el.dataset.config); // object

การจัดเก็บ JSON ใน data-*

<div
  data-config='{"theme":"dark","locale":"en-US","pageSize":20}'
  id="app"
></div>

<script>
const el = document.getElementById('app');
const config = JSON.parse(el.dataset.config);
console.log(config.theme);    // 'dark'
console.log(config.pageSize); // 20
</script>

data-* เทียบกับองค์ประกอบกำหนดเอง

การใช้ data-* ในเฟรมเวิร์ก

<!-- Bootstrap: target collapsible elements -->
<button data-bs-toggle="collapse" data-bs-target="#menu">
  Toggle
</button>

<!-- Alpine.js: component data -->
<div x-data="{ open: false }">

<!-- Stimulus: controller identification -->
<div data-controller="menu" data-menu-open-value="false">

<!-- Testing libraries: stable selectors -->
<button data-testid="submit-btn">Submit</button>

การช่วยการเข้าถึงและ data-*

<!-- BAD: accessibility info in data-* -->
<button data-label="Close dialog">×</button>
<!-- Screen reader does NOT read data-label -->

<!-- GOOD: use aria-label for accessibility -->
<button aria-label="Close dialog">×</button>

ข้อควรพิจารณาด้านประสิทธิภาพ

สรุป: แนวทางปฏิบัติที่ดีสำหรับ data-*

ตรวจสอบอย่างรวดเร็ว

ทบทวน: ไวยากรณ์ของ data-*