# resources.ByType
> 返回给定媒体类型的全局资源集合；一个都没有时返回 nil。
- 官方英文原文：https://gohugo.io/functions/resources/bytype/
- 本页规范地址：https://hugozh.cn/functions/resources/bytype/
- 最近更新：2026-10-02
- 最后提交：912b1d3 chore(site): 添加 static/CNAME（hugozh.cn），供 GitHub Pages 等平台绑定自定义域名
- 签名：resources.ByType MEDIATYPE
- 返回类型：resource.Resources
- 站点：Hugo 中文文档（https://hugozh.cn/）· 社区维护的非官方中文翻译，如有出入以官方英文原文为准

---
[媒体类型][]通常是 `image`、`text`、`audio`、`video` 或 `application` 之一。

```go-html-template
{{ range resources.ByType "image" }}
  <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}
```

> [!NOTE]
> 该函数作用于全局资源。全局资源是位于 `assets` 目录内，或位于任何挂载到 `assets` 目录的目录内的文件。
>
> 对于页面资源，请使用 `Page` 对象上的 [`Resources.ByType`][] 方法。

[`Resources.ByType`]: /methods/page/resources/
[媒体类型]: https://en.wikipedia.org/wiki/Media_type