0%

MDN 文档

MDN 是什么?

Mozilla 开发者网络,权威 Web 文档。

内容

  • HTML
  • CSS
  • JavaScript
  • API

总结

MDN 是学习 Web 开发首选。

历史与背景

MDN 最初是 Mozilla 的开发文档,后来开放给社区,现由 MDN contributors 维护。内容覆盖 HTML、CSS、JavaScript 及各种 Web API。

快速检索技巧

  • 使用 site:developer.mozilla.org 配合 Google 搜索
  • 直接在 MDN 搜索栏输入 API 名称或 CSS 属性
  • 利用 CTRL+F 查找页面关键字

API 文档结构

典型页面包括:

  1. 简介
  2. 语法/用法
  3. 参数说明
  4. 返回值
  5. 例子
  6. 规范链接
  7. 浏览器兼容性表

示例代码

1
<button onclick="alert('Hello world')">Click</button>
1
2
3
fetch('https://api.example.com/data')
.then(response => response.json())
.then(data => console.log(data));

本地化与多语言

MDN 支持多种语言,中文社区在 https://developer.mozilla.org/zh-CN/ 提供翻译。

参与贡献

  • 编辑现有页面并保持内容最新
  • 提交 MDN Wiki 改进和示例代码
  • 使用 GitHub 提交 Pull Request 来修复或扩展文档
  • 参与翻译以支持全球开发者

离线访问

可以通过 MDN Web Docs Offline 插件获取离线版本,也可以从 GitHub 仓库下载最新静态页面离线查看。

相关资源

进一步阅读

  1. 如何撰写高质量文档
  2. MDN API 文档规范

总结

MDN 的力量在于社区。参与其中不仅帮助他人,也能提升自己的技术能力。欢迎每位前端工程师都成为贡献者。

编辑流程

  1. 在 GitHub 上 Fork 仓库
  2. 在本地克隆并创建分支
  3. 修改 Markdown 文件或 JS 示例
  4. 提交 Pull Request 并通过审查

常见问题

  • 如何查找 API 是否被弃用?
  • 文档与规范不同步怎么办?
  • 如何报告错误?

工具与扩展

  • MDN Web Docs Offline
  • mdn-bcd-collector
  • Translate extension for VSCode

社区活动

MDN 组织讲座、黑客松、写作马拉松等活动,欢迎参与。

使用技巧

创建书签文件夹,按主题保存常用文档页面。
利用 MDN 的学习路径完成练习项目。

历史版本

MDN 页面保留历史记录,可点击页面底部 ‘View history’ 查看不同版本。

翻译建议

  • 参考原文以保持术语一致
  • 提交翻译 PR 时注明语言

FILLER_MDN_1
FILLER_MDN_2
FILLER_MDN_3
FILLER_MDN_4
FILLER_MDN_5
FILLER_MDN_6
FILLER_MDN_7
FILLER_MDN_8
FILLER_MDN_9
FILLER_MDN_10
FILLER_MDN_11
FILLER_MDN_12
FILLER_MDN_13
FILLER_MDN_14
FILLER_MDN_15
FILLER_MDN_16
FILLER_MDN_17
FILLER_MDN_18
FILLER_MDN_19
FILLER_MDN_20
FILLER_MDN_21
FILLER_MDN_22
FILLER_MDN_23
FILLER_MDN_24
FILLER_MDN_25
FILLER_MDN_26
FILLER_MDN_27
FILLER_MDN_28
FILLER_MDN_29
FILLER_MDN_30
FILLER_MDN_31
FILLER_MDN_32
FILLER_MDN_33
FILLER_MDN_34
FILLER_MDN_35
FILLER_MDN_36
FILLER_MDN_37
FILLER_MDN_38
FILLER_MDN_39
FILLER_MDN_40
FILLER_MDN_41
FILLER_MDN_42
FILLER_MDN_43
FILLER_MDN_44
FILLER_MDN_45
FILLER_MDN_46
FILLER_MDN_47
FILLER_MDN_48
FILLER_MDN_49
FILLER_MDN_50
FILLER_MDN_51
FILLER_MDN_52
FILLER_MDN_53
FILLER_MDN_54
FILLER_MDN_55
FILLER_MDN_56
FILLER_MDN_57
FILLER_MDN_58
FILLER_MDN_59
FILLER_MDN_60
FILLER_MDN_61
FILLER_MDN_62
FILLER_MDN_63
FILLER_MDN_64
FILLER_MDN_65
FILLER_MDN_66
FILLER_MDN_67
FILLER_MDN_68
FILLER_MDN_69
FILLER_MDN_70
FILLER_MDN_71
FILLER_MDN_72
FILLER_MDN_73
FILLER_MDN_74
FILLER_MDN_75
FILLER_MDN_76
FILLER_MDN_77
FILLER_MDN_78
FILLER_MDN_79
FILLER_MDN_80