Shopify二次开发之三：liquid语法学习（访问Objects和Schema数据模型）

本文介绍: 在 Sh op ify 主题开发中，使用 Liquid 模板语言访问数据和配置，并根据这些数据渲染页面。包括全局对象、页面模板对象、模板对象、以及在配置文件中定义的模型对象：

Objects （对象）

全局对象

all_products：商店中所有的商品

articles: 商店中的所有文章

collections：商店中所有的集合

模板对象

在product.json（配置的section中) 访问product对象

在collection.json中可访问collection对象

在article.json中可访问article对象

schema

基本input settings : text、textarea、range、radui、select等等

特定input settings

settings_schema.json（config文件夹）

在前面几章讲到shopify的项目结构，也讲到了如何像其他编程语言一样声明变量、条件判断、循环、使用 filters等等，唯独没有讲到如何在模板中渲染数据，本次配合前几章还有官方文档讲解如何在模板中访问数据。

官方文档：Liquid objects

Obje cts （对象）

在shopify中有能全局访问的对象和能在页面中访问的对象以及在section schema 配置的特定模型对象和settings _s ch ema.json中配置的模型对象

全局对象

有如上Glo b al表示该对象能全局访问，例如

all_products：商店中所有的商品

{{ all_products['black-leather-bag'].title }}

可以通过句柄去访问指定的product

a rt icles: 商店中的所有文章

{{ articles['testing/my-first-blog'].title }}

可以通过句柄去访问指定的art icle

collections：商店中所有的集合

可直接循环遍历

{% for collection in collections %}
  {{- collection.title | link_to: collection.url }}
{% endfor %}

也可通过句柄去访问指定collection

{% for product in collections['spring'].products %}
  {{- product.title | link_to: product.url }}
{% endfor %}

模板对象

shopify有指定的页面模板，比如集合列表模板（Collec t ion s Li s t）、商品集合模板(Collec t ion s)、文章模板(Blog post s)、商品模板（Pro ducts）等等

在product.json（配置的section中) 访问 product对象

{% form 'product', product %}
  &lt;select name="id"&gt;
    {% for variant in product.variants %}
      <option value="{{ variant.id }}"&gt;
        {{ variant.title }}
      </option&gt;
    {% endfor %}
  </select&gt;
  <button type="submit"&gt;Add to cart</button&gt;
{% endform %}

在collection.json中可访问 collection对象

<h1>
  {{ collection.title }}
</h1>

在art icle.json中可访问art icle对象

<h1>{{ article.title }}</h1>

另外在page.json访问page对象、在search.json中访问search对象等等

s ch ema

以下是s ch ema配置和input settings的官方文档

Section schema

Input settings

在section中配置 sc he ma的settings中的模型值有两种类型，一种是基本input settings，还有特定in put settings

基本 in put settings : text、textarea、range、rad ui、s el ect等等

    {
      "type": "checkbox",
      "id": "checkbox",
      "label": "sel",
      "default": true
    },
    {
      "type": "radio",
      "id": "radio",
      "label": "Radio",
      "options": [
        {
          "value": "left",
          "label": "Left"
        },
        {
          "value": "centered",
          "label": "Centered"
        }
      ],
      "default": "left"
    },
    {
      "type": "range",
      "id": "font_size",
      "min": 12,
      "max": 24,
      "step": 1,
      "unit": "px",
      "label": "Font size",
      "default": 16
    }

在模板中访问之前, 需要了解一下页面组成, 页面由特定xxx–group和template模板组成，每一个 template模板都由section组成，每一个 section也可以有若干block。

section对象有配置的settings，有blocks，还有唯一 id等

通过section.settings.[id]去访问配置的模型值

{% assign radio = section.settings.radio %}
{% assign font_size = section.settings.font_size %}
<div>radio value: {{ radio  }}</div>
<div>font_size value: {{ font_size }}</div>

特定input set tings

包括blog、ar ti cle、collection、collection_list、product、image_picker等等

基本的input set tings 渲染的值是基本数据，特定input set tings如果是一个对象，则需要查阅文档去查阅相关对象。

比如 ar ti cle:

    {
       "type": "header",
       "content": "type article"
    },
    {
       "type": "article",
       "id": "article",
       "label": "Article"
    }

shopify 商城后台 custo mize

article对象

访问article

{% assign article = section.settings.article %}
<div>{{ article.title }}</div>
<div>{{ article.content }}</div>

比如 b lock:

b lock里的settings和sc he ma设置的settings是完全一样的

  "blocks": [
     {
       "name": "Slide",
       "type": "slide",
       "settings": [
         {
           "type": "image_picker",
           "id": "image",
           "label": "Image"
         }
       ]
     }
  ],

bloc k对象

访问bloc k

  <div class="slide">
    {% for block in section.blocks %}
      {% case block.type %}
        {% when 'slide' %}
          {% assign image_url = block.settings.image | image_url %}
          <div class="img">
            <img width="100%" height="100%" src="{{ image_url }}/">
          </div>
      {% endcase %}
    {% endfor %}
  </div>