Wikibooks

Liquidテンプレートエンジン

Liquidテンプレートエンジンは、柔軟性とシンプルさを兼ね備えたテンプレートエンジンで、主にRubyで開発され、現在では多くのプラットフォームで利用されています。本ハンドブックでは、Liquidの基本的な構文から応用例までを網羅します。

概要

編集

Liquidは、動的なWebサイトや静的サイトジェネレータでよく使用されるテンプレートエンジンです。その特徴は以下の通りです：

  • 安全性 - 制限付きテンプレート構文により、ユーザーが書いたコードが意図せず危険な操作を実行するのを防ぎます。
  • 柔軟性 - 構文がシンプルでありながら強力な機能を提供します。
  • ポータビリティ - 多くのプログラミング言語やフレームワークで利用可能です。

基本構文

編集

Liquidのテンプレートは主に3つの要素から構成されます：

  • 出力タグ：{{ ... }} の形式で、変数や計算結果を出力します。
  • ロジックタグ：{% ... %} の形式で、制御構造やフィルターを適用します。
  • テキスト：静的なHTMLやプレーンテキスト。

例

編集

以下は基本的なLiquidテンプレートの例です： 

<h1>Welcome, {{ user.name }}!</h1>
{% if user.admin %}
<p>You have administrator privileges.</p>
{% else %}
<p>You are a regular user.</p>
{% endif %}

タグ

編集

Liquidでは、以下のようなロジックタグを使用できます：

if/else

編集

条件分岐を行うためのタグ。 

{% if condition %}
  <!-- 条件が真のとき -->
{% else %}
  <!-- 条件が偽のとき -->
{% endif %}

for

編集

ループ処理を行うタグ。 

{% for item in items %}
  <li>{{ item }}</li>
{% endfor %}

capture

編集

変数に値を代入するためのタグ。 

{% capture greeting %}Hello, {{ user.name }}!{% endcapture %}
<p>{{ greeting }}</p>

フィルター

編集

Liquidでは、フィルターを使用してデータを変換できます。フィルターはパイプ (|) 記号を用いて適用します。

例

編集 
{{ "hello" | upcase }}  <!-- 出力: HELLO -->
{{ "Liquid" | append: " Template Engine" }}  <!-- 出力: Liquid Template Engine -->

主なフィルター一覧

編集
  • upcase: 文字列を大文字に変換
  • downcase: 文字列を小文字に変換
  • append: 文字列を連結
  • replace: 特定の文字列を置換
  • size: 配列や文字列のサイズを取得

オブジェクト

編集

Liquidテンプレート内で使用されるオブジェクトの例を以下に示します。

配列

編集 
{% assign fruits = "apple, orange, cherry" | split: ", " %}
{% for fruit in fruits %}
  <li>{{ fruit }}</li>
{% endfor %}

ハッシュ

編集 
{% assign user = {"name": "John", "age": 30} %}
<p>{{ user.name }} is {{ user.age }} years old.</p>

応用例

編集

ページ分割 (Pagination)

編集 
{% for article in articles offset:10 limit:5 %}
  <h2>{{ article.title }}</h2>
  <p>{{ article.content }}</p>
{% endfor %}

カスタムフィルターの追加

編集

Liquid自体にはカスタムフィルターを追加可能です（使用している実装による）。

外部APIからのデータ利用

編集

Liquidテンプレートは静的データが基本ですが、バックエンドを通じて動的データと組み合わせることもできます。

トラブルシューティング

編集

Liquidテンプレートのデバッグに役立つ方法を以下に示します：

  • エラーのログを確認 - テンプレートエンジンがエラー内容を詳細に出力します。
  • 変数の出力 - {{ variable | inspect }} を使用してデバッグ。

まとめ

編集

Liquidテンプレートエンジンは、シンプルでありながら柔軟性が高く、さまざまな場面で活用できます。このハンドブックを基に、ぜひLiquidテンプレートを使いこなしてください！

"https://ja.wikibooks.org/w/index.php?title=Liquidテンプレートエンジン&oldid=266519" より作成