HTML:把内容安放在正确的位置

HTML 不是「画页面」的语言,而是描述内容结构的语言。学会用正确的标签表达正确的内容,是一切前端功夫的地基。

Chapter 01 基础 → 进阶 14 个知识点 预计 45 分钟

01HTML 是什么

HTML 全称 HyperText Markup Language,即超文本标记语言。它由一系列「标签」组成, 用来告诉浏览器:这段文字是标题,那段文字是段落,这里是一张图片,那里是一个可以点击的链接。

浏览器解析 HTML 的过程,大致可以理解为「读取标签 → 构建 DOM 树 → 结合 CSS 计算样式 → 绘制到屏幕」。 因此 HTML 决定了页面的内容与结构,CSS 决定外观,JavaScript 决定行为。 三者各司其职,不要混用。

i

核心观念:用最「贴切」的标签描述内容。标题就用 h1,导航就用 nav,不要为了样式把所有东西都写成 div。

一个最小的 HTML 页面

index.html
<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">
  <title>我的第一个网页</title>
</head>
<body>
  <h1>你好,世界</h1>
  <p>这是我写下的第一行网页内容。</p>
</body>
</html>

<!DOCTYPE html> 声明使用 HTML5 标准; lang="zh-CN" 告诉浏览器和读屏软件页面语言是中文; meta charset 保证中文不乱码; viewport 则是移动端适配的前提,缺了它页面会被缩小。

02文档骨架与元信息

一个规范页面的骨架,通常包含以下几层结构。head 里的内容不会直接显示在页面上,却是页面的「身份证」。

structure.html
<!DOCTYPE html>
<html lang="zh-CN">
<head>
  <meta charset="UTF-8">
  <meta name="viewport" content="width=device-width, initial-scale=1.0">

  <!-- 页面标题:显示在浏览器标签页,也是搜索结果的主标题 -->
  <title>拾光前端 · 学习手记</title>

  <!-- 页面描述:搜索结果中的摘要 -->
  <meta name="description" content="一个小清新风格的前端学习网站">

  <!-- 作者与关键词 -->
  <meta name="author" content="拾光">
  <meta name="keywords" content="HTML,CSS,JavaScript,前端">

  <!-- 社交分享卡片(Open Graph) -->
  <meta property="og:title" content="拾光前端">
  <meta property="og:description" content="从零到进阶的前端学习路径">
  <meta property="og:image" content="/cover.jpg">

  <!-- 站点图标 -->
  <link rel="icon" href="favicon.ico">
  <!-- 外部样式 -->
  <link rel="stylesheet" href="style.css">
</head>
<body>
  <!-- 页面可见内容 -->
</body>
</html>

为什么 head 的顺序也有讲究

  • charset 应尽量靠前,让浏览器尽早知道如何解码文本,避免中文闪烁或乱码。
  • viewport 紧随其后,保证移动端一开始就按设备宽度布局。
  • 样式表放在 head 中,避免页面先以无样式状态闪现(FOUC)。
  • 脚本通常放在 </body> 前,或加 defer 属性,避免阻塞页面渲染。

03常用标签速览

先建立一个整体印象:HTML 标签大致分为「文本内容」「结构分区」「媒体嵌入」「表单交互」四大类。

标签作用使用要点
h1 ~ h6六级标题每页只保留一个 h1,标题层级不要跳级
p段落用于成段文字,不要拿来做间距
a超链接href 必填,外链可加 rel="noopener"
strong / em重要 / 强调有语义,屏幕阅读器会重读;b、i 仅视觉
ul / ol / li无序 / 有序列表导航、菜单本质上是列表
img图片alt 必填,宽高建议写明以避免布局抖动
figure / figcaption插图与图注适合文章配图、代码截图
blockquote引用块配合 cite 标注出处
code / pre行内代码 / 代码块pre 保留换行与空格
hr主题分隔表示语义转折,不是画一条装饰线
br强制换行仅用于诗歌、地址等需要断行处

文本与行内元素示例

text.html
<h1>山中笔记</h1>
<p>
  清晨的雾还没散,<strong>山径湿滑</strong>,请慢行。
  我在石阶上坐了许久,读完了<em>《瓦尔登湖》</em>的第三章。
</p>

<blockquote cite="https://example.com/walden">
  我步入丛林,因为我希望生活得有意义。
  <cite>—— 梭罗</cite>
</blockquote>

<p>计算面积:<code>side * side</code></p>

<pre><code>function greet(name) {
  return `你好,${name}`;
}</code></pre>
!

注意:在 pre 内部写 HTML 代码时,必须把 < 写成 &lt;,> 写成 &gt;,否则会被浏览器当成真实标签解析。

HTML 实体字符

有些字符在 HTML 中有特殊含义,需要用实体表示。记住最常用的几个即可:

字符实体写法说明
<&lt;小于号,常用来展示标签
>&gt;大于号
&&amp;和号
"&quot;双引号
©&copy;版权符号
空格&nbsp;不换行空格

04语义化:从 div 汤里走出来

语义化是指使用能够表达内容含义的标签。它带来的好处是实实在在的: 阅读性更好、利于 SEO、对屏幕阅读器更友好, 也让团队协作时一眼就能看懂结构。

语义标签代表什么典型内容
header页头或区块头部Logo、主导航、标题
nav导航集合菜单、面包屑、翻页
main页面主体每页只出现一次
article独立完整的内容博客文章、商品卡片
section有主题的内容分区通常带一个标题
aside周边或补充内容侧边栏、广告、相关阅读
footer页脚或区块底部版权、联系方式
figure独立插图单元图片 + 图注
time日期或时间配合 datetime 属性

对比:不语义 vs 语义化

semantic.html
<!-- 不推荐:全是 div,看不出结构 -->
<div class="top">
  <div class="logo">拾光前端</div>
  <div class="menu">...</div>
</div>
<div class="content">
  <div class="post">
    <div class="title">文章标题</div>
  </div>
</div>

<!-- 推荐:标签本身就在说明内容 -->
<header>
  <a class="logo" href="/">拾光前端</a>
  <nav aria-label="主导航">
    <ul>
      <li><a href="/html">HTML</a></li>
      <li><a href="/css">CSS</a></li>
    </ul>
  </nav>
</header>

<main>
  <article>
    <header>
      <h1>文章标题</h1>
      <time datetime="2026-03-18">2026 年 3 月 18 日</time>
    </header>
    <p>正文内容……</p>
    <footer>作者:拾光</footer>
  </article>
</main>
结构示意 · 语义分区visual
header · 页头 / 导航
main
article · h1 + p + footer
aside
footer · 版权信息
?

section 还是 div?如果这块内容有一个可以命名的主题(通常会有标题),用 section;如果只是为了布局包一层,用 div 就好。

05链接、图片与媒体

超链接的四种常见形态

links.html
<!-- 1. 站内跳转 -->
<a href="/about.html">关于我</a>

<!-- 2. 站外跳转:新标签页打开,防止 opener 攻击 -->
<a href="https://developer.mozilla.org" target="_blank" rel="noopener noreferrer">
  MDN 文档
</a>

<!-- 3. 页内锚点:跳到 id 为 comments 的位置 -->
<a href="#comments">跳到评论</a>

<!-- 4. 功能性链接 -->
<a href="mailto:hi@example.com">给我写邮件</a>
<a href="tel:+8613800000000">拨打电话</a>
<a href="report.pdf" download>下载报告</a>

图片:alt 不是可选项

image.html
<!-- 基础写法:宽度高度能避免加载时的布局抖动 -->
<img src="mountain.jpg" alt="清晨被薄雾笼罩的山谷" width="800" height="533">

<!-- 响应式图片:根据屏幕宽度选择不同尺寸 -->
<img
  src="photo-800.jpg"
  srcset="photo-400.jpg 400w, photo-800.jpg 800w, photo-1600.jpg 1600w"
  sizes="(max-width: 600px) 100vw, 800px"
  alt="山谷晨雾"
  loading="lazy">

<!-- 带图注的插图:figure 是语义化容器 -->
<figure>
  <img src="note.jpg" alt="手写笔记的一页">
  <figcaption>图 1:我在山中所记的笔记</figcaption>
</figure>
  • alt 描述图片内容,供读屏软件朗读;纯装饰图可以写 alt=""。
  • loading="lazy" 让首屏外的图片延迟加载,是零成本的性能优化。
  • 现代浏览器建议用 <picture> 或 srcset 提供多分辨率资源。

音视频

media.html
<video controls width="640" poster="cover.jpg" preload="metadata">
  <source src="film.mp4" type="video/mp4">
  <source src="film.webm" type="video/webm">
  <track kind="subtitles" src="film.zh.vtt" srclang="zh" label="中文字幕" default>
  你的浏览器不支持 video 标签,<a href="film.mp4">点击下载</a>。
</video>

<audio controls src="rain.mp3">你的浏览器不支持音频播放。</audio>

controls 显示浏览器原生控制条;poster 是视频封面; 标签内部的文字是降级提示。注意:自动播放带声音的媒体通常会被浏览器拦截,需静音 muted 才可能自动播放。

06表格:展示二维数据

表格只应该用来展示数据,不要用它来做页面布局。一个规范的数据表格需要包含标题、表头与表体。

table.html
<table>
  <caption>本周学习计划</caption>
  <thead>
    <tr>
      <th scope="col">日期</th>
      <th scope="col">内容</th>
      <th scope="col">状态</th>
    </tr>
  </thead>
  <tbody>
    <tr>
      <th scope="row">周一</th>
      <td>HTML 语义化</td>
      <td>已完成</td>
    </tr>
    <tr>
      <th scope="row">周二</th>
      <td>CSS 盒模型</td>
      <td>进行中</td>
    </tr>
  </tbody>
  <tfoot>
    <tr>
      <td colspan="2">合计</td>
      <td>2 项</td>
    </tr>
  </tfoot>
</table>
实际效果table
本周学习计划
日期内容状态
周一HTML 语义化已完成
周二CSS 盒模型进行中
周三JavaScript 基础未开始

scope="col" 和 scope="row" 能帮助读屏软件把单元格与表头正确关联,是表格无障碍的关键细节。

07表单:与用户对话

表单是网页收集信息的主要方式。一个易用、可访问的表单,核心在于每个输入控件都要有与之关联的 label。

完整表单结构

form.html
<form action="/subscribe" method="post" novalidate>
  <!-- 文本输入:for 与 id 关联,点击文字也能聚焦 -->
  <div class="field">
    <label for="username">昵称</label>
    <input
      id="username"
      name="username"
      type="text"
      placeholder="请输入昵称"
      required
      minlength="2"
      maxlength="20"
      autocomplete="nickname">
  </div>

  <!-- 邮箱:type 会触发对应的键盘与校验 -->
  <div class="field">
    <label for="email">邮箱</label>
    <input id="email" name="email" type="email" required>
  </div>

  <!-- 下拉选择 -->
  <div class="field">
    <label for="level">当前水平</label>
    <select id="level" name="level">
      <option value="">请选择</option>
      <option value="beginner">刚入门</option>
      <option value="intermediate">能写页面</option>
      <option value="advanced">熟悉工程化</option>
    </select>
  </div>

  <!-- 单选:相同 name 才会互斥 -->
  <fieldset>
    <legend>学习频率</legend>
    <label><input type="radio" name="freq" value="daily" checked> 每天</label>
    <label><input type="radio" name="freq" value="weekly"> 每周几次</label>
  </fieldset>

  <!-- 多选 -->
  <label><input type="checkbox" name="topics" value="css"> CSS</label>
  <label><input type="checkbox" name="topics" value="js"> JavaScript</label>

  <!-- 多行文本 -->
  <label for="msg">想说的话</label>
  <textarea id="msg" name="msg" rows="5"></textarea>

  <button type="submit">提交</button>
</form>
表单交互演示live
至少 2 个字符
输入后自动校验格式

常用 input 类型

type用途特性
text单行文本最基础,可配 minlength / maxlength
email邮箱移动端弹出带 @ 的键盘,自带格式校验
password密码输入内容显示为圆点
number数字可设置 min / max / step
date日期调用原生日期选择器
range范围滑块适合音量、评分等
file文件上传配合 accept 限制类型
search搜索框部分浏览器会显示清除按钮
✦

原生校验优先:required、pattern、min、max 等属性由浏览器直接校验,无需 JavaScript,且提示文案会自动本地化。

08全局属性与 data-*

有些属性可以写在几乎所有标签上,称为全局属性。掌握它们能让代码更简洁、更易维护。

属性作用示例
id唯一标识锚点跳转、label 关联、JS 获取
class类名,可重复用于 CSS 与 JS 选择
style行内样式仅用于动态计算的少量样式
title补充提示鼠标悬停显示,不宜承载关键信息
hidden隐藏元素等价于 display:none
tabindex键盘焦点顺序一般不要随意改动
contenteditable可编辑让元素内容可被直接编辑
data-*自定义数据通过 dataset 读取

使用 data-* 存储自定义数据

data-attr.html
<button class="like" data-post-id="42" data-count="128">♡ 喜欢</button>

<script>
  const btn = document.querySelector('.like');

  // 读取:data-post-id 对应 dataset.postId(驼峰命名)
  console.log(btn.dataset.postId);  // "42"
  console.log(btn.dataset.count);   // "128"

  // 写入
  btn.dataset.count = '129';
  btn.textContent = '♥ 已喜欢 129';
</script>

约定:data- 后面的短横线命名会自动转换为驼峰。例如 data-user-name 对应 dataset.userName。这是 JavaScript 与 HTML 之间传递状态最轻量的方式。

09SEO 与无障碍

写好 HTML,本身就能带来不错的搜索引擎表现与可访问性。不需要复杂技巧,只需把该做的细节做到位。

SEO 检查清单

  • 唯一的 title:每页都有准确、不堆砌关键词的标题,长度控制在 30 字以内。
  • 合理的标题层级:一个 h1,h2 与 h3 依次递进,不要为了字号跳级。
  • meta description:用一句话概括页面内容,会显示在搜索结果摘要里。
  • 语义化结构:header、main、article、nav 能让爬虫更快理解页面。
  • 图片 alt:既是无障碍要求,也是图片搜索的入口。
  • 描述性链接文字:用「查看 CSS 布局教程」,而不是「点击这里」。
  • canonical:有重复内容时,用 <link rel="canonical"> 指定主版本。

无障碍(a11y)的关键细节

a11y.html
<!-- 1. 给导航和区域起名字 -->
<nav aria-label="主导航">...</nav>
<nav aria-label="面包屑">...</nav>

<!-- 2. 图标按钮必须有可读文字 -->
<button aria-label="关闭对话框">
  <svg aria-hidden="true">...</svg>
</button>

<!-- 3. 只给读屏软件看的文字 -->
<span class="sr-only">跳转到主要内容</span>

<!-- 4. 图片替代文本 -->
<img src="chart.png" alt="2026 年各月份访问量柱状图,七月最高">

<!-- 5. 语言与阅读方向 -->
<html lang="zh-CN" dir="ltr">
sr-only.css
/* 视觉上隐藏,但读屏软件仍可读取 */
.sr-only {
  position: absolute;
  width: 1px;
  height: 1px;
  padding: 0;
  margin: -1px;
  overflow: hidden;
  clip: rect(0, 0, 0, 0);
  white-space: nowrap;
  border: 0;
}
i

自测方法:用键盘 Tab 键走一遍页面,确认所有交互元素都能聚焦、有清晰的焦点样式;再用浏览器 Lighthouse 的 Accessibility 面板跑一次评分。

10常见坑与练习

新手最容易踩的五个坑

  1. 用 div 写一切。虽然能显示,但丢失了语义,后期维护与 SEO 都会吃亏。
  2. 嵌套错误。例如 ul 的直接子元素只能是 li;p 内不能放 div 等块级元素。
  3. 忽略 alt。图片没有替代文本,网络不佳或读屏时信息就完全丢失了。
  4. 用 br 控制间距。间距属于样式,应交给 CSS 的 margin 与 padding。
  5. id 重复。id 必须全页唯一,重复会导致锚点与 label 关联失效。

小练习:写一张「读书卡片」

请只用 HTML(不写 CSS),完成下面这张卡片的语义结构:包含书名、作者、出版时间、一段简介、一张封面图、一个「收藏」按钮与标签列表。

practice.html · 参考答案
<article class="book-card">
  <header>
    <h2>《瓦尔登湖》</h2>
    <p>
      作者:<span>亨利·戴维·梭罗</span> ·
      <time datetime="1854">1854 年</time>
    </p>
  </header>

  <figure>
    <img src="walden.jpg" alt="《瓦尔登湖》初版封面" width="300" height="420">
    <figcaption>初版封面</figcaption>
  </figure>

  <p>
    梭罗在瓦尔登湖畔独居两年,记录下对自然、孤独与生活的思考。
  </p>

  <ul class="tags">
    <li>自然</li>
    <li>随笔</li>
    <li>哲学</li>
  </ul>

  <footer>
    <button type="button" aria-pressed="false">收藏</button>
  </footer>
</article>
✦

下一步:结构写好后,进入 CSS 篇章,把这张卡片真正「打扮」成一张好看的读书卡片。