LESSON-16 · TOPIC 02

classList 與 dataset

能以 dataset 讀 DOM 識別,並用 classList 切換呈現狀態。

code-edit安全 DOM 查找與可重複渲染|classList 與 dataset本頁只練一個責任

本頁只練什麼

能以 dataset 讀 DOM 識別,並用 classList 切換呈現狀態。

把狀態塞進完整 className 字串容易覆蓋既有類別;data-* 則提供 HTML/JS 都可讀的穩定識別。

要修改的檔案:files/starter/main.js

定位:先讀 classList.value 與 dataset.id。|依 starter-2 定位,只修改「classList 與 dataset」的責任。

任務情境

先結果,再原理;完成後要能說出自己看見的證據。

現在的問題

點選卡片後原本布局 class 被 className 覆蓋。

起始狀態:card class 存在,is-selected 不存在。

完成後要看到

dataId=s2、before=false、after=true、其他 class 保留。

驗收證據:dataId=s2、selected=true、baseClass=true

何時會用到

卡片選取、展開狀態與 DOM 上的資料 id。

常見混淆:dataset 值都是字串,不是自動轉成 number/Boolean。

觀念與最小範例

這段程式是理解起點,不是要你直接跳過 Starter。

classList 與 dataset Class list and data attributes

data-* 放元素資料;classList 只加減一個狀態 class,不重寫全部 class。

正式說法:dataset 映射 data-* attributes;classList 提供 DOMTokenList 的 add/remove/toggle/contains。

card.dataset.id;card.classList.toggle('is-selected')。

三步完成本主題

每一步都留下可觀察結果;如果沒看到,先看「卡住先查」。

  1. Step 1|先看見目前缺口,不急著貼答案。

    檔案:files/starter/main.js 定位:先讀 classList.value 與 dataset.id。

    要做:先重新載入 Starter,記錄目前畫面、DOM、Computed、Console 或文件內容。

    預期:能指出「先讀 classList.value 與 dataset.id。」目前的缺口。

    證據:保存 files/starter/main.js 的目前狀態,並指出下一步只會修改哪個檔案責任。

    卡住先查:確認開啟的是 files/starter/main.js,且定位到 先讀 classList.value 與 dataset.id。。

  2. Step 2|只修改本主題的一個責任。

    檔案:files/starter/main.js 定位:先讀 classList.value 與 dataset.id。

    要做:讀 data-id,切換 is-selected 並確認既有 card class 未消失。

    預期:dataId=s2、before=false、after=true、其他 class 保留。

    證據:dataId=s2、selected=true、baseClass=true

    卡住先查:先讀 classList.value 與 dataset.id。

  3. Step 3|重新載入並以證據驗收,不以『看起來差不多』判定完成。

    檔案:files/starter/main.js 定位:先讀 classList.value 與 dataset.id。

    要做:重新整理頁面,再逐項比對預期結果與 evidence。

    預期:dataId=s2、before=false、after=true、其他 class 保留。

    證據:dataId=s2、selected=true、baseClass=true

    卡住先查:先讀 classList.value 與 dataset.id。

觀察示範

這個示範只讓你看懂概念,不會替你修改 Starter,也不會自動宣告完成。

classList 與 datasetruntime fixture · read-only demo
本主題示範畫面:

驗收證據

勾選只是學習紀錄;真正完成仍要回到 Starter 的實際結果。

提示 1|方向

不要整段指定 className。

提示 2|關鍵片段

用 dataset.id 讀識別,以 classList.toggle 改單一 token。

提示 3|完整解答與原因

完整解答與原因:先讀 card.dataset.id,再 toggle is-selected;classList 只改指定 token,所以 card 基底類別會保留。

完成後進入下一階段,或回到入口選下一個 topic。

開始 Starter →回到主題清單