リファレンス

Global Variables

pages

記事リストやカテゴリーページリストなどページの一覧を表示するノードのループ HTML で使用でき、 既定では次のようなレイアウトを描画します。

{% for page in pages %}
<article class="item-{{ page.css_class }} {% if page.new? %}new{% endif %} {% if page.current? %}current{% endif %}">
  <header>
    <time datetime="{{ page.date }}">{{ page.date | ss_date: "long" }}</time>
    <h2><a href="{{ page.url }}">{{ page.index_name | default: page.name }}</a></h2>
  </header>
</article>
{% endfor %}

nodes

カテゴリーリストなどノードの一覧を表示するノードのループ HTML で使用でき、 既定では次のようなレイアウトを描画します。

{% for node in nodes %}
<article class="item-{{ node.css_class }} {% if node.current? %}current{% endif %}">
  <header>
     <h2><a href="{{ node.url }}">{{ node.name }}</a></h2>
  </header>
</article>
{% endfor %}

parts

だいたいどこでも使用できパーツの一覧へのアクセスを提供します。 ただし、ループで全パーツを取り出すといった利用方法はできません。

共通で利用できる部分をパーツとして定義しておき、ループ HTML で利用したり、 定型フォームで利用したりすることを想定しています。

{{ parts["loop_header"].html }}

{% for node in nodes %}
<article class="item-{{ node.css_class }} {% if node.current? %}current{% endif %}">
  <header>
     <h2><a href="{{ node.url }}">{{ node.name }}</a></h2>
  </header>
</article>
{% endfor %}

{{ parts["loop_footer].html }}

part

パーツのループ HTML 内などで、描画中のパーツを表します。 また、parts["loop_header"] などは part を返します。

page

定型フォームのレイアウト内で、描画中のページを表します。 また、pages をループで展開した場合は page を返します。

node

nodes をループで展開した場合は node を返します。 また、part.parent や page.parent は node を返します。

values

定型フォームのレイアウトではグローバル変数として存在しています。 また pages.values は values を返します。

value

ブロックのレイアウトではグローバル変数として存在しています。 共通で取得できる値と、型に応じて取得できる値とがあります。

共通

一行入力

日付入力

URL入力

複数行入力

ドロップダウン

ラジオボタン

チェックボックス

ファイルアップロード

value.file_type が image の場合の value.html

<img src="{{ value.file.url }}" alt="{{ value.file_label || default: value.file.humanized_name }}">

value.file_type が attachment の場合の value.html

<a href="{{ value.file.url }}">{{ value.file_label | default: value.file.name  }} ({{ value.file.extname | upcase }} {{ value.file.size | human_size }})</a>

value.file_type が video の場合の value.html

<div>
  <video src="{{ value.file.url }}" controls="controls"></video>
  <div>{{ value.text | newline_to_br }}</div>
</div>

value.file_type が banner の場合の value.html

<a href="{{ value.link_url }}">
  <img src="{{ value.file.url }}" alt="{{ value.file_label | default: value.file.humanized_name }}">
</a>

見出し入力

リスト入力

YouTube埋め込み

自由入力

表

groups

page.groups や node.groups は groups を返し、グループの一覧を表します。

group

files

自由入力の value.files は files を返し、ファイルの一覧を表します。

file

event_recurrence

page.event_recurrences の要素です。

start_date と start_datetime は同じ値を返し、前者は日付型で後者は日時型で取得します。end_date と end_datetime も同様で同じ値を返し、前者は日付型で後者は日時型で取得します。

例えば 2022/6/1 から 2022/6/30 までの繰り返しイベントを設定した場合、start_date, end_date そして until_date はそれぞれ以下のようになります。

Filters

Liquid 標準のフィルターも使用できます。

ss_date / ss_time についての補足

ss_date と ss_time とは、日時データを指定されたフォーマットにしたがって文字列に変換するフィルターで、 {{ page.date | ss_date: <format> }} のように指定します。

format には日時データのフォーマット文字列を指定し、strftime メソッドと同じフォーマット文字列を使用することができます。また、事前に定義されたフォーマット文字列がいくつか提供されており、{{ page.date | ss_date: "default" }} のようにして利用することもできます。

format を省略すると “default” が指定されたものとみなされます。

ss_date で利用できる事前定義フォーマット:

ss_time で利用できる事前定義フォーマット:

標準のフィルターに date というフィルターがありますが、標準フィルター date との違いは次の点です。

• date は事前定義フォーマットを利用できないが、ss_date / ss_time は利用できる。
• data は曜日（”%a” や “%A” など）が英語の曜日に変換されますが、ss_date / ss_time は日本語の曜日に変換されます。

public_list についての補足

public_list はフォルダーのページ一覧を取得するフィルターで、 {{ assign items = node | public_list: <limit> }} のように指定します。

limit には取得するページの件数を指定します。

limit を省略するとページを全件取得します。

filter_by_column_value についての補足

filter_by_column_value は定型フォームの値でページ一覧を絞り込みするフィルターで、 {{ assign items = pages | filter_by_column_value: "<key>.<value>" }} のように指定します。

key には定型フォームの項目の名前を指定します。 value には定型フォームの項目の値を指定します。 key で指定した定型フォームの項目の値が value と一致しているものを絞り込みます。

sort_by_column_value についての補足

sort_by_column_value は定型フォームの値でページ一覧を並び替えするフィルターで、 {{ assign items = pages | sort_by_column_value: "<key>" }} のように指定します。

key には定型フォームの項目の名前を指定します。 key で指定した定型フォームの項目の値を昇順で並び替えます。

same_name_pages についての補足

same_name_pages はページとタイトルが一致するページ一覧を取得するフィルターで、 {{ assign items = page | same_name_pages: "<filename>" }} のように指定します。

filename には取得するページのフォルダー名を指定します。

filename を省略すると名前の一致するページを全件取得します。