序数
Syntax
SHORTCODE.Ordinal
Returns
int
Ordinal
方法返回短代码相对于其父级的基于零的序数。如果父级是页面本身,则序数表示此短代码在页面内容中的位置。
此方法除其他用途外,还可用于在从同一页面调用短代码两次或多次时分配唯一的元素 ID。例如:
content/about.md
{{< img src="images/a.jpg" >}}
{{< img src="images/b.jpg" >}}
此短代码执行错误检查,然后呈现具有唯一 id
属性的 HTML img
元素:
layouts/shortcodes/img.html
{{ $src := "" }}
{{ with .Get "src" }}
{{ $src = . }}
{{ with resources.Get $src }}
{{ $id := printf "img-%03d" $.Ordinal }}
<img id="{{ $id }}" src="{{ .RelPermalink }}" width="{{ .Width }}" height="{{ .Height }}" alt="">
{{ else }}
{{ errorf "The %q shortcode was unable to find %s. See %s" $.Name $src $.Position }}
{{ end }}
{{ else }}
{{ errorf "The %q shortcode requires a 'src' argument. See %s" .Name .Position }}
{{ end }}
Hugo 将页面呈现为:
<img id="img-000" src="/images/a.jpg" width="600" height="400" alt="">
<img id="img-001" src="/images/b.jpg" width="600" height="400" alt="">