从数据到视图:可持久化的待办清单
难度 · 入门项目目标
支持新增、勾选完成、删除、按状态筛选、清除已完成,并且刷新页面后数据仍然存在。 这个项目的重点不是界面,而是把一句话落到实处:数据是唯一真相,视图只是数据的投影。 只要这句话守住了,后面无论加编辑、排序还是拖拽,都不会把代码写乱。
技术点
涉及的知识在基础篇与 DOM 篇都出现过:数组方法负责“改数据”,DOM API 负责“画界面”, 事件委托负责“接住操作”,localStorage 负责“把数据留下来”。这里做的事情是把它们组装起来。
分步实现
-
先定数据结构,再想界面。每条待办只需要三个字段:
id、text、done。 整个应用只有一个todos数组,任何界面变化都必须先改数组,再调用render()。 读取时用try/catch包住,避免存储里的脏数据让页面直接白屏。const STORAGE_KEY = 'todolist-demo'; let todos = load(); let filter = 'all'; // 'all' | 'active' | 'done' function load() { try { const raw = localStorage.getItem(STORAGE_KEY); const list = raw ? JSON.parse(raw) : []; return Array.isArray(list) ? list : []; } catch (err) { return []; // 数据损坏时退回空列表 } } function save() { try { localStorage.setItem(STORAGE_KEY, JSON.stringify(todos)); } catch (err) { // 隐私模式或超出配额:保留内存中的数据即可 } } -
渲染函数只做一件事:把数据翻译成 DOM。每次全量清空再重建,写法朴素但状态最可控。 用户输入一律用
textContent写入,不要拼innerHTML, 否则一条<img onerror=...>就能变成脚本。function render() { const list = document.getElementById('todoList'); const items = visibleTodos(); list.innerHTML = ''; if (items.length === 0) { const empty = document.createElement('li'); empty.className = 'empty'; empty.textContent = '还没有待办,先写一条。'; list.appendChild(empty); } items.forEach(todo => { const li = document.createElement('li'); li.dataset.id = todo.id; li.className = todo.done ? 'done' : ''; const box = document.createElement('input'); box.type = 'checkbox'; box.checked = todo.done; box.dataset.act = 'toggle'; const text = document.createElement('span'); text.className = 'text'; text.textContent = todo.text; // 不解析 HTML const del = document.createElement('button'); del.type = 'button'; del.className = 'del'; del.dataset.act = 'del'; del.textContent = '删除'; li.append(box, text, del); list.appendChild(li); }); } -
用事件委托接住所有交互。列表项会不断增删,逐个绑定监听器既繁琐又容易泄漏。 把
change与click挂在ul上, 用event.target.closest('li[data-id]')找到被操作的条目,再读data-act判断动作。const list = document.getElementById('todoList'); list.addEventListener('change', event => { const li = event.target.closest('li[data-id]'); if (!li || event.target.dataset.act !== 'toggle') return; todos = todos.map(todo => { return todo.id === li.dataset.id ? { ...todo, done: !todo.done } : todo; }); commit(); }); list.addEventListener('click', event => { if (event.target.dataset.act !== 'del') return; const li = event.target.closest('li[data-id]'); if (!li) return; todos = todos.filter(todo => todo.id !== li.dataset.id); commit(); }); -
把“保存 + 渲染”收成一个提交函数。新增、切换、删除、清除都走同一条路径, 避免某处忘记持久化。
map与filter都会返回新数组, 这样每次变更都发生在唯一入口commit(),调试时只需要盯住一个地方。function commit() { save(); render(); } document.getElementById('addForm').addEventListener('submit', event => { event.preventDefault(); const input = document.getElementById('todoInput'); const text = input.value.trim(); if (!text) return; // 空输入不产生数据 const id = Date.now().toString(36) + Math.random().toString(36).slice(2, 6); todos = [{ id, text, done: false }, ...todos]; input.value = ''; commit(); }); document.getElementById('filters').addEventListener('click', event => { const btn = event.target.closest('button[data-filter]'); if (!btn) return; filter = btn.dataset.filter; btn.parentElement.querySelectorAll('button').forEach(item => { item.classList.toggle('on', item === btn); }); render(); // 只改筛选,不必重新保存 });
待办文本来自用户,属于不可信内容。拼接 innerHTML 会让标签被解析,
轻则布局错乱,重则执行脚本。示例统一用 textContent,需要富文本时也应先转义或使用白名单过滤。
完整可运行代码
把下面的内容保存为 todo.html,双击用浏览器打开即可。数据写入当前源的
localStorage,键名为 todolist-demo。代码包含完整的样式、结构与逻辑,
不依赖任何外部文件。
<!DOCTYPE html>
<html lang="zh-CN">
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>待办清单 · TodoList</title>
<style>
:root {
--paper: #fffdf8;
--bg: #f7f4ee;
--ink: #2c352e;
--mute: #8b968c;
--line: #dfe3db;
--sage: #7ba58a;
--sage-deep: #4f7a60;
--rose: #c98f8f;
}
* { box-sizing: border-box; }
body {
margin: 0;
padding: 48px 18px;
background: var(--bg);
color: var(--ink);
font: 15px/1.7 "PingFang SC", "Microsoft YaHei", sans-serif;
}
.app {
max-width: 520px;
margin: 0 auto;
padding: 28px 26px 22px;
background: var(--paper);
border: 1px solid var(--line);
border-radius: 18px;
}
h1 { margin: 0 0 2px; font-size: 23px; }
.sub { margin: 0 0 22px; font-size: 11px; letter-spacing: 0.18em; color: var(--mute); }
form { display: flex; gap: 8px; }
#todoInput {
flex: 1;
min-width: 0;
padding: 10px 13px;
border: 1px solid var(--line);
border-radius: 10px;
font: inherit;
outline: none;
}
#todoInput:focus { border-color: var(--sage); }
form button {
padding: 10px 18px;
border: 0;
border-radius: 10px;
background: var(--sage);
color: #fff;
font: inherit;
cursor: pointer;
}
.filters { display: flex; gap: 6px; margin: 18px 0 6px; }
.filters button {
padding: 4px 13px;
border: 1px solid var(--line);
border-radius: 999px;
background: transparent;
color: #5c6a5f;
font-size: 12px;
cursor: pointer;
}
.filters button.on { background: #e4eee6; border-color: #e4eee6; color: var(--sage-deep); }
ul { list-style: none; margin: 0; padding: 0; }
li {
display: flex;
align-items: center;
gap: 10px;
padding: 11px 2px;
border-bottom: 1px dashed var(--line);
}
li .text { flex: 1; }
li.done .text { color: var(--mute); text-decoration: line-through; }
li .del {
padding: 2px 6px;
border: 0;
background: transparent;
color: var(--rose);
font-size: 12px;
cursor: pointer;
}
.empty { padding: 18px 2px; color: var(--mute); font-size: 13px; }
.foot {
display: flex;
justify-content: space-between;
align-items: center;
margin-top: 14px;
font-size: 12px;
color: var(--mute);
}
.foot button { border: 0; background: none; color: var(--mute); cursor: pointer; }
</style>
</head>
<body>
<div class="app">
<h1>待办清单</h1>
<p class="sub">TODOLIST / 数据驱动视图</p>
<form id="addForm">
<input id="todoInput" type="text" maxlength="80" placeholder="今天要做什么?" autocomplete="off">
<button type="submit">添加</button>
</form>
<div class="filters" id="filters">
<button type="button" data-filter="all" class="on">全部</button>
<button type="button" data-filter="active">未完成</button>
<button type="button" data-filter="done">已完成</button>
</div>
<ul id="todoList"></ul>
<div class="foot">
<span id="counter">共 0 项</span>
<button type="button" id="clearDone">清除已完成</button>
</div>
</div>
<script>
const STORAGE_KEY = 'todolist-demo';
let todos = load();
let filter = 'all';
function load() {
try {
const raw = localStorage.getItem(STORAGE_KEY);
const list = raw ? JSON.parse(raw) : [];
return Array.isArray(list) ? list : [];
} catch (err) {
return [];
}
}
function save() {
try {
localStorage.setItem(STORAGE_KEY, JSON.stringify(todos));
} catch (err) {
// 隐私模式或超出配额时,保留内存中的数据
}
}
function visibleTodos() {
if (filter === 'active') return todos.filter(todo => !todo.done);
if (filter === 'done') return todos.filter(todo => todo.done);
return todos;
}
function render() {
const list = document.getElementById('todoList');
const items = visibleTodos();
list.innerHTML = '';
if (items.length === 0) {
const empty = document.createElement('li');
empty.className = 'empty';
empty.textContent = filter === 'all'
? '还没有待办,先写一条。'
: '这个分类下暂时没有内容。';
list.appendChild(empty);
}
items.forEach(todo => {
const li = document.createElement('li');
li.dataset.id = todo.id;
li.className = todo.done ? 'done' : '';
const box = document.createElement('input');
box.type = 'checkbox';
box.checked = todo.done;
box.dataset.act = 'toggle';
const text = document.createElement('span');
text.className = 'text';
text.textContent = todo.text;
const del = document.createElement('button');
del.type = 'button';
del.className = 'del';
del.dataset.act = 'del';
del.textContent = '删除';
li.append(box, text, del);
list.appendChild(li);
});
const doneCount = todos.filter(todo => todo.done).length;
document.getElementById('counter').textContent =
'共 ' + todos.length + ' 项 · 已完成 ' + doneCount + ' 项';
}
function commit() {
save();
render();
}
document.getElementById('addForm').addEventListener('submit', event => {
event.preventDefault();
const input = document.getElementById('todoInput');
const text = input.value.trim();
if (!text) return;
const id = Date.now().toString(36) + Math.random().toString(36).slice(2, 6);
todos = [{ id, text, done: false }, ...todos];
input.value = '';
commit();
});
document.getElementById('filters').addEventListener('click', event => {
const btn = event.target.closest('button[data-filter]');
if (!btn) return;
filter = btn.dataset.filter;
btn.parentElement.querySelectorAll('button').forEach(item => {
item.classList.toggle('on', item === btn);
});
render();
});
document.getElementById('todoList').addEventListener('change', event => {
const li = event.target.closest('li[data-id]');
if (!li || event.target.dataset.act !== 'toggle') return;
todos = todos.map(todo => {
return todo.id === li.dataset.id
? { ...todo, done: !todo.done }
: todo;
});
commit();
});
document.getElementById('todoList').addEventListener('click', event => {
if (event.target.dataset.act !== 'del') return;
const li = event.target.closest('li[data-id]');
if (!li) return;
todos = todos.filter(todo => todo.id !== li.dataset.id);
commit();
});
document.getElementById('clearDone').addEventListener('click', () => {
todos = todos.filter(todo => !todo.done);
commit();
});
render();
</script>
</body>
</html>
可以继续优化的方向
- 双击编辑:把
span.text临时替换成input,回车提交、失焦提交、Esc 取消,并做一次非空校验。 - 筛选写进地址:用
#/active这样的 hash 保存筛选状态,刷新后仍然停在当前分类,也为第 5 章的 hash 路由做铺垫。 - 减少重排:先拼好
DocumentFragment再一次性插入,或只更新发生变化的列表项,避免每次全量重建。 - 拖拽排序:在
pointerdown时记录起点,pointermove时交换数组位置,结束时把新顺序写回存储。 - 抽出数据层:把
todos的读写封装成 store,为第 4 章的状态管理库留出接入点,让列表只负责订阅渲染。
筛选已经具备 all、active、done 三种状态,新增分类只需给数据加字段,
在 visibleTodos() 里增加一个分支,按钮继续复用 data-filter 与事件委托,渲染函数不用改。
编辑则从 dblclick 开始:把当前 span 换成 input 并写入原文本,
回车或失焦时提交,Esc 取消;提交前 trim 并校验非空,然后用 todos.map
生成包含新 text 的数组,最后仍然调用 commit()。不要直接改 DOM 文本,
否则刷新后编辑就丢了。
现场演示
下面这个演示把数据放在内存里,刷新页面即清空,用来直观看到“新增 → 渲染 → 勾选 → 删除 → 计数”的闭环。 它和上面的完整代码共用同一套思路,只是省掉了持久化。