[Bug]: Resource Hints: preload, fonts, and CORS
还没有人认领这个 Issue。
- 主要语言
- JavaScript
- 星标
- 11.8k
- 派生
- 7.9k
- 平均合并
- 1 天 11 小时
- 30 天内合并 PR
- 11
描述
Summary
NOTE: I hope this is the correct place to report this, if not, please let me know and I would be happy to file it in the correct repository.
I like the added support for Resource Hints in the upcoming React 19 release but there seems to be either a bug or an oversight in the docs when it comes to preload as it relates to font loading.
Page
https://react.dev/reference/react-dom/preload
Details
The preload page uses font loading throughout the documentation page as an example use case, but nowhere does it include the use of the crossOrigin property with the anonymous value. Reading over the blog post announcing the release of React 19 beta, there is also an example using font loading which then also shows the following HTML output:
<link rel="preload" as="font" href="https://.../path/to/font.woff">
For reference: https://react.dev/blog/2024/04/25/react-19#support-for-preloading-resources
However, when preloading fonts one needs to always specify crossorigin in order for the resource hint to be respected. More details can be found on the MDN Web Docs website that covers preload.
I would have thought that perhaps React would internally automatically add this for font loading, but at the same time, it might be better for it to be a little less magical 😺 and be more explicit. In the latter case, one would need to update the examples in the docs and the release announcement post and make note of the "special" case of preloading fonts.
I believe this means that font loading should always be done as follows:
preload("https://example.com/font.woff2", {as: "font", crossOrigin: "anonymous"});
Resulting in the following HTML:
<link rel="preload" as="font" href="https://.../path/to/font.woff" crossorigin>
贡献指南
从这里开始
- 先读完整个 Issue,再读项目的贡献指南。
- 在 Issue 下留言说明你要接手 —— 这能避免两个人做同样的事。
- Fork 仓库,在一个分支上完成修改。
- 提交 Pull Request,并在描述里引用这个 Issue 编号。
调研方向
从 issue 中链接的 react-dom/preload 参考页面和 React 19 博客文章开始,找到字体预加载示例及其源内容。更新示例和说明文字,以展示字体所需的匿名跨源设置,然后验证渲染后的文档和 HTML 示例是否始终一致地反映这一指导。
由索引模型根据 Issue 内容生成。
评估
- 技术栈
- javascript, react
- 领域
- documentation
- Issue 类型
- 文档
- 难度
- 3/5
- 预计耗时
- 1-2 天
- 活跃度
- 停滞
- 描述清晰度
- 描述清楚
- 新手友好度
- 48/100