hugo/docs/content/en/functions/resources/GetMatch.md
2024-06-21 09:41:24 +02:00

1.1 KiB

title description categories keywords action
resources.GetMatch Returns the first global resource from paths matching the given glob pattern, or nil if none found.
aliases related returnType signatures
functions/resources/ByType
functions/resources/Get
functions/resources/GetRemote
functions/resources/Match
methods/page/Resources
resource.Resource
resources.GetMatch PATTERN
{{ with resources.GetMatch "images/*.jpg" }}
  <img src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ end }}

{{% note %}} This function operates on global resources. A global resource is a file within the assets directory, or within any directory mounted to the assets directory.

For page resources, use the Resources.GetMatch method on the Page object.

{{% /note %}}

Hugo determines a match using a case-insensitive glob pattern.

{{% include "functions/_common/glob-patterns.md" %}}