跳到主要内容

Handles

Object handles

Objects 代表店铺资源,例如商品、collection、文章和博客,每个资源都有用于标识的 handle。Handle 用于构建资源的 URL,或返回资源的属性。

创建和修改 handles

Handles 根据资源标题自动生成,遵循以下规则:

  • Handles 始终为小写
  • 空格和特殊字符(?# 等)将被替换为连字符 -
  • 如果有多个连续的空格或特殊字符,则将其替换为单个连字符
  • 开头的空格或特殊字符将被删除

Handles 必须唯一,因此如果使用了重复的标题,则 handle 会自动递增。例如,如果有两个名为 Ace Cashmere Beanie 的商品,则它们的 handle 分别为 ace-cashmere-beanieace-cashmere-beanie-1

{{ product.title | handle }}
{
"product": {
"title": "Ace Cashmere Beanie"
}
}
ace-cashmere-beanie

引用 handles

某些具有 handle 的 objects(例如 productcollection 等)包含 handle 属性。例如,您可以使用 product.handle 输出商品的 handle。