Liquid Snippets by ALSEL
📘 公式リファレンス🏷️ リファレンス/タグ初級

unless タグ(条件反転での分岐)

条件が false のときだけ式を表示する。if タグの反対の動作で、「〜でない場合」という否定条件を直感的に書ける。

用途
バリアント選択肢が複数ある商品ページで、デフォルト1種のみの場合は選択肢を表示しないなど、条件が当てはまらないときの処理を簡潔に記述したいシーン。
設置場所
Liquid テンプレート内で `{% unless 条件 %}` と `{% endunless %}` に囲んで使う。条件が false のときだけ中身が表示される。
注意点
unless 内で `elsif` を使って複数条件を追加できるが、複雑になるなら if タグに条件を反転した形で書き換えるほうが読みやすい。unless と if を混在させるとコード可読性が低下するため、1 テンプレート内では一貫性を持たせる。
タグ:conditionalunlesslogicif-else

仕様

32 行 / json
{
  "category": "conditional",
  "deprecated": false,
  "deprecation_reason": "",
  "description": "> Tip:\n> Similar to the [`if` tag](/docs/api/liquid/tags/if), you can use `elsif` to add more conditions to an `unless` tag.",
  "parameters": [],
  "summary": "Renders an expression unless a specific condition is `true`.",
  "name": "unless",
  "syntax": "{% unless condition %}\n  expression\n{% endunless %}",
  "syntax_keywords": [
    {
      "keyword": "condition",
      "description": "The condition to evaluate."
    },
    {
      "keyword": "expression",
      "description": "The expression to render unless the condition is met."
    }
  ],
  "examples": [
    {
      "name": "",
      "description": "",
      "syntax": "",
      "path": "/products/health-potion",
      "raw_liquid": "{% unless product.has_only_default_variant %}\n  // Variant selection functionality\n{% endunless %}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    }
  ]
}

出典・ライセンス

License:
MIT

このコードは Shopify 著作の MIT ライセンスソースです。 原本の著作権は Shopify が保有します。日本語訳は ALSEL によるものです。

関連項目

📘 公式リファレンス🏷️ リファレンス/タグ中級

doc タグ(テンプレートの注釈・ドキュメント)

Liquid テンプレート内にドキュメンテーションコメントを埋め込むタグ。`{% doc %}` ~ `{% enddoc %}` に囲まれたコンテンツは画面に出力されず、内部の Liquid コードは解析されるが実行されない。コード補完、リンティング、インラインドキュメント機能の実装を支援する。

📁 theme-liquid-docs·MIT·12
📘 公式リファレンス🏷️ リファレンス/タグ初級

include タグ(スニペットを埋め込む)

スニペットファイルを Liquid テンプレート内に埋め込んでレンダリングする。埋め込み先の変数にアクセス・変更できるため、親テンプレートと子スニペット間でデータを直接共有する。

📁 theme-liquid-docs·MIT·17
📘 公式リファレンス🏷️ リファレンス/タグ中級

javascript タグ(セクション・ブロック内のコード)

セクション、ブロック、スニペット内に JavaScript コードを記述するタグ。このタグ内に書いた JavaScript は Shopify のテーマビルドシステムにより自動的に読み込まれて実行される。

📁 theme-liquid-docs·MIT·17
📘 公式リファレンス🏷️ リファレンス/タグ初級

sections タグ(セクショングループを描画)

セクショングループをテーマのレイアウト内で描画するタグ。レイアウトファイル内に配置して、複数のセクションをグループ化した内容を出力する。

📁 theme-liquid-docs·MIT·17
📘 公式リファレンス🏷️ リファレンス/タグ初級

stylesheet タグ(CSS定義)

セクション、ブロック、スニペット内で CSS スタイルを定義するタグ。各ファイルにつき1つだけ記述でき、定義した CSS はそのコンポーネント固有の外側スコープで読み込まれて実行される。

📁 theme-liquid-docs·MIT·17
📘 公式リファレンス🏷️ リファレンス/タグ初級

break タグ(ループの中断)

for ループの反復処理を途中で停止するタグ。指定した条件に達したら以降の反復をスキップして、ループを抜ける。

📁 theme-liquid-docs·MIT·23