稍候片刻,月出文自明。
把下方 Skill 交給 AI,即可讓它復現這篇文章所描述的方案。
<!doctype html>
<html lang="zh-CN">
<head>
<meta charset="utf-8">
<meta name="viewport" content="width=device-width, initial-scale=1">
<title>周末读书会</title>
</head>
<body>
<h1>周末读书会</h1>
<p>每周六下午,我们一起读书、交流。</p>
</body>
</html><a href="https://developer.mozilla.org/zh-CN/docs/Web/HTML">查阅 MDN 的 HTML 文档</a>
<a href="https://html.spec.whatwg.org/" target="_blank" rel="noopener noreferrer">在新标签页打开 HTML 规范</a><!-- 下方是读书会的活动安排 --><p><a href="#schedule">查看活动流程</a></p>
<h2 id="schedule">活动流程</h2>
<ol>
<li>签到并领取阅读材料</li>
<li>安静阅读 30 分钟</li>
<li>轮流分享一个印象最深的段落</li>
</ol><figure>
<img src="venue-map.png" alt="从图书馆正门进入,上二楼后右转到达阅览室"
width="800" height="450" loading="lazy">
<figcaption>读书会会场路线图</figcaption>
</figure><form action="books.html" method="get">
<label for="book-query">书名关键词</label>
<input id="book-query" name="q" type="search"
placeholder="例如:人类简史" required>
<button type="submit">搜索</button>
</form><details>
<summary>需要提前读完这本书吗?</summary>
<p>不需要。活动会预留 30 分钟现场阅读。</p>
</details>
HTML 基础:从第一张网页到语义化结构
HTML(HyperText Markup Language,超文本标记语言)用来描述网页的结构和含义:哪一行是标题,哪些内容是一组列表,哪个链接会带你去另一页。它不负责字号和颜色,也不负责点击之后的行为。本文用一个「周末读书会」页面做例子:先写一张能直接双击打开的 index.html,再逐步加上锚点链接、图片、语义分区和表单。全部示例只用浏览器,不需要安装框架或构建工具。
读完后你会得到:一张含标题、段落、列表的页面;一个能跳转到页内某处的链接;一张带替代文本的图片;用 header、main、section 分好区的结构;一个原生表单,以及一个不写 JavaScript 的折叠问答。
01|三种技术怎么分工
02|写出第一张网页
把下面的代码以 UTF-8 编码保存为 index.html(文件名用小写,扩展名是 .html),双击文件或用浏览器打开 file:// 地址。先原样运行一次,再分别修改 <title> 和 <h1> 的文字,保存并刷新,看看浏览器标签页和网页正文各有什么变化。
写法
作用
<!doctype html>
文档类型声明,不是 HTML 元素。放在文件第一行,让浏览器以标准模式而非怪异模式处理页面;漏写时部分 CSS 行为会不一致。它不区分大小写。
<html lang="zh-CN">
html 是根元素,其他元素都写在里面;lang 声明页面语言,影响读屏软件的发音、断词和翻译提示。简体中文写 zh-CN,繁体写 zh-Hant。
<head> 与 <title>
head 放文档元数据,内容不在正文显示;title 指定文档标题,显示在浏览器标签页、收藏夹和搜索结果中,每个页面都应有一个可读的独立标题。
charset 与 viewport
前者声明字符编码,应出现在 <head> 靠前位置(文件前 1024 字节内),保存文件时编码要与声明一致,否则中文会乱码;后者让移动浏览器把布局视口宽度设为设备宽度,width=device-width, initial-scale=1 是最常见写法,它不替代响应式布局。
<body>
放页面正文:能看见的标题、段落、图片和表单都在这里。
另外注意两件事:h1 通常一个页面只出现一次,代表页面主标题,不要为了字号大而滥用;head 里的 title 和正文里的 h1 可以不同,前者服务标签页与搜索,后者服务读者。
03|元素、标签与属性
空元素:没有结束标签
img、input、meta、br、hr 都是空元素(void element),只能带属性,不能包含子内容,也不能写结束标签。写 <br> 即可;<br /> 里的斜杠是 XML 的习惯,HTML 解析器会直接忽略,所以它并没有「自闭合」的效果。同理,<div /> 不等于 <div></div>,浏览器会认为这个 div 还没结束。
注释:写给读代码的人
注释不显示在正文中,但任何人查看页面源代码都能读到,所以不要写密码、内部地址或未发布的内容。注释也不能嵌套:两层 <!-- --> 叠在一起时,内层的结束符号会提前把注释收掉。
04|按内容选标签
要表达什么
用哪些元素
标题和段落
h1 到 h6 表示标题层级,按层级依次使用,不要为了字号跳级(如 h2 下直接写 h4),需要外观时调 CSS;p 表示一个段落,浏览器默认在段前段后留白。想拉开间距就用多个 p 或 CSS 的 margin,别用一堆 <br> 顶出来。
重要信息和语气强调
strong 表示重要性,读屏软件可能加重语气;em 表示语气上的强调,默认斜体。只想要粗细或斜体外观、并不强调含义时,用 CSS 的 font-weight、font-style。
一组条目或有先后顺序的步骤
ul 表示无序列表,ol 表示有序列表,条目用 li。ul 和 ol 的直接子元素只能是 li;需要「术语+说明」时用 dl 搭配 dt、dd。
跳转到另一页或本页某处
用带 href 的 a。例如 href="#schedule" 指向本页中 id="schedule" 的元素,同一页面内的 id 不应重复。指向外部站点、又要在新标签页打开时,加 rel="noopener noreferrer"。链接文字要能说明去向,别只写「点击这里」。
图片及其说明
img 用 src 指定图片路径,路径写错时浏览器会显示替代文本。信息性图片的 alt 应传达它在当前上下文中的关键信息;纯装饰图片用 alt=""。写上 width 和 height(或用 CSS 固定宽高比)可以减少图片加载时的布局跳动,长页面可加 loading="lazy" 延迟加载。可见图注用 figure 搭配 figcaption。
按行列比较数据
table 只用来展示表格数据,不用来给页面排版。caption 给表格命名,tr 表示行,th 表示表头单元格,td 表示数据单元格。简单表格可用 scope="col" 或 scope="row" 标明表头覆盖的列或行,方便读屏软件朗读。
Demo|加上活动流程
把下面的片段放在第一个示例的正文段落之后、</body> 之前。点击「查看活动流程」,地址栏会变成 …/index.html#schedule,浏览器滚动到对应标题;如果标题本来就在视口内,滚动可能看不出来。再试着把地址栏里的 #schedule 删掉回车,页面会回到顶部。
如果你有一张名为 venue-map.png 的路线图,把它放到与 index.html 同一个文件夹,再加入下面的片段。请按实际图片修改替代文本;路径或文件名写错时,图片位置会显示这段替代文本,正好可以用来检查它是否说清了路线。复杂地图还应在正文用文字列出完整路线。
05|语义化元素
选标签时先问「这段内容是什么」,再问「它该长什么样」。默认样式下,div 通常另起一行,span 通常跟随文字排列,但「块级/行内」说的是 CSS 布局,不是 HTML 的嵌套规则。HTML 规范通过内容模型规定每种元素可以容纳哪些内容。
页面中的角色
元素与用法
介绍、主要导航与页脚
header 放页面或某个分区的介绍性内容,如标题、标语、搜索框;nav 只放主要导航链接,页脚里的一排友情链接不必用 nav;footer 放版权、联系方式、更新日期等。
主内容与主题分区
main 包裹页面独有的主要内容,一个页面只用一个,并且不要嵌进 header、footer 或 article;section 表示一个有主题的分区,通常配有标题,如果没有合适的标题,用 div 更诚实。
可独立使用的内容
article 适合能独立阅读或分发的内容,如一篇文章、一条论坛帖子、一张活动卡片;判断标准是「把它单独拿出来,读者还能看懂吗」。
没有特定语义的容器
div 用于通用分组,span 用于标记一小段文字等短语内容。有更贴切的语义元素时优先用它。
例如,p 只能包含文字、链接、强调、code、img 这类短语内容,不能包含 div 或 ul。把列表直接写进段落时,解析器会在 <ul> 处提前闭合 p,实际 DOM 结构和源码缩进就对不上了。同样,a 里不能再套 a,button 里也不该放交互元素。需要调整布局时用 CSS display、Flex 或 Grid,不要用表格或 <br> 拼版式。
动手|给页面分区
06|表单与原生交互
链接用于导航,按钮用于执行操作。表单用 label 为输入项提供可见名称,用 input 接收数据,用 button 提交。不写自定义脚本时,也可以先用浏览器原生的必填校验、输入类型和折叠控件。
Demo|搜索书单
把表单放进 main,然后在同目录新建 books.html(可从第一个示例复制骨架)。先空着点「搜索」,浏览器会提示填写并把焦点移回输入框;再输入关键词,提交后观察地址栏中的 books.html?q=…。这个静态示例只演示如何传值,不会真的筛选书单。
Demo|原生折叠问答
这段内容默认折叠,点击问题即可展开;也可以用 Tab 定位到问题,再用 Enter 或空格切换开合。想让某个问答默认展开,给它加上 open;如果希望一组问答同时只打开一个,给这几个 details 写上相同的 name。
07|发布前自查
附录|标准与版本
名称
如何理解
HTML Living Standard
由 WHATWG 持续维护的 HTML 规范,没有固定的「版本号」。查元素含义、允许的嵌套或解析规则时,以它为参考。
HTML5
你会在旧教程和招聘要求里见到这一名称,它大致指 2014 年前后定型的这套能力:语义化元素、表单新类型、音视频等。现代 HTML 文档统一使用简短的文档类型声明,声明本身不写版本号。
XHTML
使用 XML 语法的 HTML 写法,要求标签严格闭合、大小写敏感。本文的示例按普通 HTML 编写;在 HTML 中嵌入 SVG 不要求把整页改写成 XHTML。
规范符合性和浏览器支持是两回事:前者看规范和校验结果,后者看兼容性资料与实际测试。
接下来学什么
参考资料
查元素用法可从 MDN 入手;需要确认规范细节时看 WHATWG;做无障碍检查时可参考 W3C WAI 的教程。
资料
适合查什么
MDN:HTML
元素、属性、使用示例与兼容性。
WHATWG:HTML Living Standard
HTML 的语法、元素内容模型和解析规则。
W3C WAI:Web 无障碍教程
页面结构、图片、表格和表单的无障碍实践。