做纯 HTML 视频网站这件事,本身听起来像是一个“上古时期”的玩法。现在做视频站,动辄就是 Vue/React 框架、前后端分离、云点播、防盗链签名,一套流程下来没个把月搞不定。但如果你只是想快速搭一个能放视频、能搜索、能筛选、能播放的网页,老老实实用 HTML + CSS + 原生 JavaScript 就能解决全部需求,而且源码逻辑一眼通透,改起来毫不费力。
这个项目很适合三类人:第一类,刚学完前端基础想找个完整小项目练手的同学,你能从这里看到 HTML 结构、CSS 布局、JavaScript 事件处理是怎么在一个真实场景里协同工作的;第二类,做个人作品集、小团队内部工具,想快速弄一个视频展示页面的人,不需要懂后端,不需要配服务器,双击 HTML 文件就能看效果;第三类,单纯想看一份整洁源码、想本地存一个视频网站模板备用的人。
我在这个项目里最看重的一点是:没有构建工具、没有框架依赖、连 node_modules 都不需要存在,整个项目就是几个文件摆在那,源码摊开一眼能看完。这年头能在一分钟之内从零跑起来的“网站”项目真的不多了,这个算一个。
1. 先想清楚:纯 HTML 视频网站到底是个什么东西
1.1 为什么值得用纯 HTML 做视频网站
先说个容易混淆的概念。标题说的“纯 HTML”,在行内一般指的是 纯前端实现,也就是页面只有 .html、.css、.js 文件,不需要 PHP、Node.js、Java 这类后端语言参与动态渲染。视频文件本身肯定没法用 HTML 凭空造出来,但视频的列表展示、分类筛选、播放器控件、搜索过滤这些“网站功能”,全部可以在浏览器里完成。
这个方案最大的优势有三点。
一是部署成本几乎为零。你把 HTML 文件拖到浏览器里就能打开,甚至不需要“部署”这个概念。想上线的话,扔到任意一个静态托管平台,比如 GitHub Pages、Cloudflare Pages 或者对象存储配静态网站托管,整个过程五分钟搞定,不需要买服务器,也不用配置 Nginx。
二是源码决策成本低。很多框架项目你看完一个组件文件,还得再看路由配置、状态管理、打包配置才能搞懂整个项目在做什么。HTML 项目没有中间层,打开一个 HTML 文件,结构、样式、逻辑都在里面,对于学习者和二次开发者都非常友好。
三是运行稳定。不依赖第三方服务,没有后端接口挂掉的问题,不会因为某个 npm 包升级导致整个项目跑不起来。只要浏览器的 HTML 标准不倒,这个页面十年后打开还是这个效果。
1.2 这个项目适合谁、能解决什么问题
我最推荐的用法是把它当成一个视频索引工具。比如你手上有几十个教学视频、产品演示视频,散落在不同文件夹或 CDN 上,每次要看都得翻目录、找文件,很痛苦。用这个网页,把所有视频地址维护在一个清单里,打开页面就是卡片墙,想看哪个点哪个,体验瞬间就体面了。
对前端初学者来说,这个项目是教科书级别的练习样本。它涵盖了:
- HTML5 语义化标签的使用:
header、main、section、dialog这些都有实际场景; - CSS 布局的经典操作:Flexbox 做导航栏,Grid 做视频卡片网格,响应式断点适配不同屏幕;
- JavaScript 的 DOM 操作、事件委托、数组方法
filter、数据与视图的同步更新; video元素的核心属性、事件与浏览器兼容性处理。
这些知识点单独看都零碎,但在一个完整项目里串起来,你才能理解它们各自解决什么问题。
1.3 项目最终的效果预览
动手之前,先描述一下成品长什么样,方便你对答案:
页面顶部是一条导航栏,左边是站点名称(比如“我的视频库”),右边是搜索框,输入关键词即时过滤卡片。导航栏下方是几个分类筛选按钮:全部、前端、后端、工具、生活,点击高亮当前分类。页面主体是响应式卡片网格,每张卡片是一段封面图(poster)、视频标题、时长和分类标签。点击卡片,页面中央弹出一个居中播放层,黑底、带关闭按钮,视频自适应居中播放。手机端访问时,网格从三列变成两列再变成一列,播放层占满全屏。
我实际做的时候,整个代码量大约 220 行左右。听起来不多,但这个体量刚好能让你一眼看穿所有逻辑,又比那种几十行的玩具示例有真实感。
需要模型API调用? 免费领10W Token,多模型网关一键接入 Claude、DeepSeek 等主流模型。
2. 核心技术拆解:video 标签和页面骨架
2.1 video 标签那些必须搞懂的属性
做视频网站,最核心的 HTML 元素就是 <video>。这个标签从 HTML5 时代开始就是浏览器原生支持的视频播放方案,不需要装 Flash,不需要引第三方播放器库。
一个最基础的播放器写法长这样:
html复制<video src="movie.mp4" controls></video>
controls 属性会显示浏览器自带的控制条,包含播放/暂停按钮、进度条、音量、全屏等。但在实际项目里,你几乎不可能只用这种默认形式,因为默认控件在不同浏览器里长得不一样,而且可定制性差。更常见的做法是保留原生控件做兜底,同时用自定义按钮控制播放行为。
我在这个项目里用到这几个关键属性:
poster:视频加载前的封面图地址,这张图直接决定视频卡片好不好看,必须有;preload="metadata":只预加载视频的元数据(时长、尺寸、首帧),而不是整个视频文件。这个属性对列表页性能至关重要,否则页面一加载就开始下载几十个视频文件,流量直接爆炸;playsinline和muted:这两个通常配合移动端使用。iOS Safari 在默认情况下打开视频会自动切入全屏播放,加上playsinline才能在页面内嵌播放;muted用于静音自动播放,后面会展开讲;controls:在弹窗播放层里我会保留它,因为用户需要进度拖动、音量调节、全屏切换这些能力,没必要全部自己造轮子。
一个典型的使用场景是:
html复制<video
src="https://example.com/videos/1.mp4"
poster="https://example.com/covers/1.jpg"
preload="metadata"
playsinline
controls
></video>
2.2 视频格式选型:MP4 还是 WebM
如果你是自己准备视频素材,这一步逃不开。浏览器对视频格式的支持并不完全统一,但有一个比较稳妥的组合。
目前事实上的标准答案是:MP4 容器 + H.264 视频编码 + AAC 音频编码。这个组合在 Chrome、Firefox、Safari、Edge 以及所有主流手机上都是通吃的。你从剪辑软件里导出视频时,选 H.264 编码、.mp4 后缀,基本不会出问题。
WebM 则更“现代”,VP9/AV1 编码,压缩率更高、画质更好,尤其适合追求极致体积的 Web 项目。但它有一个致命伤:Safari 很长时间都不原生支持 WebM 播放(现在部分版本通过系统解码器解决了),面向大众用户的站点不能只放 WebM 格式。
所以我的建议是:主视频一律用 H.264 的 MP4。如果你确实想兼容多格式,可以在 video 标签里写多个 source,浏览器会按顺序尝试:
html复制<video controls poster="cover.jpg">
<source src="movie.webm" type="video/webm">
<source src="movie.mp4" type="video/mp4">
</video>
这样 Chrome 优先选 WebM,Safari 自动跳过 WebM 去加载 MP4,各得其所。但要注意,source 是“全部加载完成后才统一尝试”,不是一边加载一边决策,所以首次打开会有一定延迟。
2.3 页面布局:CSS Grid 是这张牌的关键
视频卡片的网格布局,我强烈推荐用 CSS Grid,而不是 Flexbox 或者 Float。原因很简单:Grid 天生就是做二维布局,一行放几列、列宽怎么伸缩、间距怎么控制,都是声明式的,代码量少、可读性好。
我实际用的核心布局代码是这样:
css复制.video-grid {
display: grid;
grid-template-columns: repeat(auto-fill, minmax(260px, 1fr));
gap: 24px;
}
就这一行 grid-template-columns,响应式网格就完成了。auto-fill 告诉浏览器尽可能多地生成列,minmax(260px, 1fr) 规定每列最小 260px、最大占满剩余空间。浏览器会自动根据容器宽度决定一行放 2 列、3 列还是 4 列,完全不需要写媒体查询。
同时导航栏和页面底部我用了 Flexbox,因为这是典型的一
