リファレンス/フィルター
153 件のスニペット・リファレンス
avatar フィルター（顧客アバター画像HTML生成）
顧客アバターが存在する場合、それを表示する HTML タグを生成するフィルター。customer オブジェクトに対して使用する。
default_errors フィルター（フォーム送信エラーを日本語化）
form.errors の各エラーコードに対応する既定のエラーメッセージを自動生成するフィルター。フォーム送信時の入力値不正や必須項目空白などのエラーを言語別に出力する。
date フィルター（日付を指定形式でフォーマット）
日付値を指定されたフォーマット文字列に従って整形する。フォーマット文字列が空の場合は元の値がそのまま返される。入力が日付に変換できない場合も元の値が返される。
payment_terms フィルター（Shop Pay分割払いバナーを生成）
product フォームまたは cart フォームに対して使用し、Shop Pay の分割払いオプションを表示するための HTML を生成するフィルター。顧客が購入時に分割払いプランを選択できるようにする。
abs フィルター（数値の絶対値を取得）
負の数を正の数に変換する。数値の絶対値（ゼロからの距離）を返すフィルター。
append フィルター（文字列の末尾に追加）
文字列の末尾に別の文字列を連結するフィルター。URL パスの結合やテキストの接尾辞追加に使う。
asset_url フィルター（CDN URLを取得）
テーマの assets ディレクトリ内のファイル（CSS、JavaScript、画像など）に対する Shopify CDN の絶対 URL を返すフィルター。
at_least フィルター（最小値を指定）
数値を指定した最小値以上に制限するフィルター。渡された数値が最小値より小さい場合は最小値を返し、それ以上なら元の数値をそのまま返す。
at_most フィルター（数値の最大値を制限）
数値を指定した上限値までに制限するフィルター。元の値がその上限を超えていればその上限を返し、超えていなければ元の値そのままを返す。
base64_encode フィルター（文字列を Base64 形式にエンコード）
文字列を Base64 形式にエンコードするフィルター。テキストやデータを符号化形式に変換する。
base64_decode フィルター（Base64 エンコード文字列をデコード）
Base64 形式でエンコードされた文字列をデコードして、元のテキストに戻すフィルター。API からの返却値やメタフィールドに保存された Base64 データを読み込むときに使う。
base64_url_safe_encode フィルター（URL安全なBase64エンコード）
文字列を URL 安全な Base64 形式にエンコードする。標準 Base64 の `+` と `/` を `-` と `_` に置き換えたフォーマット。
blake3 フィルター（BLAKE3ハッシュ変換）
文字列を BLAKE3 ハッシュアルゴリズムで変換し、16進数の固定長ハッシュ値を返すフィルター。セキュアなハッシュ化が必要な場面で使用する。
base64_url_safe_decode フィルター（URL安全なBase64をデコード）
URL安全形式のBase64エンコード文字列をデコードして元のテキストに復元するフィルター。URLクエリパラメータで安全に送信されたデータの復号に対応。
camelize フィルター（文字列をキャメルケースに変換）
ハイフン区切りの文字列をキャメルケース(camelCase)に変換するフィルター。JavaScript オブジェクトキーやAPI パラメータ名への変換時に使う。
capitalize フィルター（文字列の先頭大文字化）
文字列の先頭文字を大文字に、残りを小文字に変換するフィルター。単語の先頭大文字化ではなく、最初の1文字のみを対象にする。
ceil フィルター（数値を切り上げ）
小数点以下を切り上げて、最も近い整数に丸めるフィルター。1.2 は 2 に、1.0 は 1 のままになる。
color_brightness フィルター（明るさ取得）
16進カラーコード（例: #EA5AB9）から認知された明るさを 0 ～ 255 の数値で算出するフィルター。W3C の AERT (Accessibility Evaluation and Repair Tools) の定義に準拠。
color_to_hex フィルター（CSS色を16進数に変換）
CSS カラー文字列（rgb、rgba、カラー名など）を16進数形式（hex6）に変換するフィルター。
color_to_oklch フィルター（CSS 色を OKLCH 形式に変換）
CSS 色文字列を OKLCH 色空間形式に変換するフィルター。16進数カラーコード（例：#EA5AB9）を入力すると、OKLCH 形式の文字列で返す。
color_to_hsl フィルター（CSS色をHSL形式に変換）
CSS カラーコード文字列を HSL 形式に変換するフィルター。アルファ値が含まれている場合は HSLA 形式で出力される。
color_to_rgb フィルター（CSS色をRGB形式に変換）
CSS カラーコード（16進数形式など）を RGB または RGBA 形式の文字列に変換するフィルター。アルファ値を含む色の場合は RGBA 形式で出力される。
concat フィルター（複数の配列を結合）
2つ以上の配列を1つに結合するフィルター。重複は除外されないため、重複排除が必要な場合は uniq フィルターと組み合わせて使う。
compact フィルター（配列から空値を削除）
配列から nil（空値）の要素をすべて削除し、値を持つ要素のみを残す。map フィルターで取得した値に nil が混在するときに活用する。
customer_logout_link フィルター（ログアウトリンク生成）
顧客をログアウトさせてホームページへリダイレクトする HTML リンクを生成するフィルター。テキスト文字列を input として受け取り、自動的にログアウト URL を属性に持つ `<a>` タグを返す。
customer_register_link フィルター（顧客登録ページへのリンク生成）
テキスト文字列を顧客登録ページへのHTML リンクに変換するフィルター。リンク先は自動的にストアの登録ページ URL に指定される。
customer_login_link フィルター（ログインページへのリンク生成）
テキスト文字列をカスタマーログインページへのHTML リンク要素に変換するフィルター。ログインページの URL は自動的に Shopify が生成する。
downcase フィルター（文字列を小文字に変換）
文字列に含まれるすべての大文字を小文字に変換するフィルター。英数字や特殊文字は変わらず、アルファベットのみが対象となる。
divided_by フィルター（数値を割算）
数値を指定した数で割り、商を返すフィルター。除数の型（整数/小数）が結果の型を決める。除数が整数なら結果は整数、小数なら結果は小数になる。
escape_once フィルター（二重エスケープ防止）
文字列内の HTML 特殊文字（<、>、&、ダブルクォートなど）をエスケープするが、既にエスケープ済みの文字（& など）は重ねてエスケープしない。
escape フィルター（HTML特殊文字をエスケープ）
文字列内の HTML 特殊文字（<、>、&、シングルクォート、ダブルクォートなど）をエスケープシーケンスに変換する。ユーザー入力やメタフィールドの値を安全に HTML として出力するときに使う。
external_video_url フィルター（外部動画の URL を生成）
YouTube や Vimeo などの外部動画メディアについて、プレイヤーパラメータを指定した埋め込み URL を生成するフィルター。`external_video_tag` フィルターと組み合わせて使う。
floor フィルター（数値を切り下げ）
与えられた数値を小数点以下で切り下げ、最も近い整数を返すフィルター。1.2 なら 1、2.9 なら 2 になる。
handleize フィルター（文字列をハンドル形式に変換）
文字列を Shopify ハンドル形式（英小文字・ハイフン区切り）に変換するフィルター。商品名やコレクション名から URL スラッグを生成するときに使う。
global_asset_url フィルター（Shopify CDN上の共有アセットのURL取得）
Shopify サーバー上で管理されているグローバルアセット（JavaScriptライブラリ・CSS・画像ファイルなど）の CDN URL を取得するフィルター。外部 CDN より高速に読み込める。
hmac_sha256 フィルター（HMAC-SHA256ハッシュ化）
文字列を秘密鍵で署名し、HMAC-SHA256 ハッシュに変換するフィルター。メッセージ認証コード(MAC)として機能し、データの完全性と真正性を検証できる。
highlight_active_tag フィルター（アクティブなタグをマーク）
コレクション内のタグが現在アクティブ（選択中）であれば、そのタグを HTML の `<span class="active">` で囲む。コレクションのタグフィルター機能に対応する。
hmac_sha1 フィルター（HMAC-SHA1ハッシュ生成）
文字列を秘密鍵を使って HMAC-SHA1 ハッシュに変換するフィルター。メッセージ認証コードとして機能し、API 連携時の署名検証やセキュアなトークン生成に用いる。
inline_asset_content フィルター（アセットの内容をインライン展開）
SVG、JS、CSS ファイルをテンプレート内にインライン展開するフィルター。指定したアセットの内容をそのまま HTML に埋め込む。
item_count_for_variant フィルター（カート内の特定バリアント数）
カートオブジェクト内で、指定したバリアント ID の合計数量を取得するフィルター。同じバリアントが複数行に分かれていても、その合計値を返す。
json フィルター（データを JSON 文字列に変換）
文字列またはオブジェクトを JSON 形式の文字列に変換するフィルター。JavaScript で直接使用する際は、フィルターが自動的にクォートを付与してエスケープするため、追加で引用符を加える必要がない。
link_to_tag フィルター（タグでフィルタリング）
タグ名を受け取り、そのタグでフィルタリングされたブログ記事またはコレクションページへのリンク HTML を生成するフィルター。クリックするとタグ絞り込みが適用される。
link_to_add_tag フィルター（タグフィルタリングのリンク生成）
現在のブログやコレクションページで、指定したタグを追加フィルタとするリンクを生成する。既に選択されているタグも URL に含める。
link_to_remove_tag フィルター（タグを除外したフィルタリングリンク）
現在のブログまたはコレクションページで、指定したタグを除外するフィルタリングリンク（HTML の a タグ）を生成する。アクティブなタグの組み合わせから、そのタグだけを削除した URL へのリンクを出力する。
lstrip フィルター（文字列の左側の空白を削除）
文字列の左側（先頭）にある空白文字（スペース、タブ、改行など）をすべて削除するフィルター。右側の空白は残される。
md5 フィルター（文字列をMD5ハッシュに変換）
文字列を MD5 ハッシュに変換するフィルター。入力値をハッシュ化し、32文字の16進数文字列として返す。
map フィルター（配列から特定プロパティを抽出）
配列内の各アイテムから指定されたプロパティを取り出し、新しい配列を作成する。オブジェクトのコレクションから特定の値だけを集めたいときに使う。
minus フィルター（数値の減算）
指定された数値を別の数値から減算する。数学的な引き算を行う基本的なフィルター。
modulo フィルター（割り算の余りを計算）
ある数値を別の数値で割った余りを返す。数学の剰余演算に相当する。
money フィルター（金額をストア通貨で整形）
数値を店舗設定の通貨形式に従って整形する。HTML なし通貨形式で出力される。
money_amount フィルター（価格形式に整形）
金額を通貨記号や桁区切りなしのプレーンな小数文字列として返すフィルター。JavaScript や外部 API に価格データを渡すときに活用する。
money_with_currency フィルター（金額をストア通貨記号付きで整形）
数値を金額に整形し、ストア設定の通貨記号を付与する。ストアの管理画面「HTML で通貨」設定に従って表示形式が決まる。
money_without_trailing_zeros フィルター（末尾ゼロなし金額表示）
金額をストア通貨で整形し、小数点以下のゼロを削除して表示する。小数部に 0 でない値がある場合は money フィルターと同じ結果になる。
money_without_currency フィルター（金額を通貨記号なしで整形）
金額を店舗の通貨設定に基づいて整形するが、通貨記号（$、¥など）を付けない。数値を文字列に変換して表示する。
newline_to_br フィルター（改行をHTML改行に変換）
文字列内の改行(\n)を HTML の <br> タグに変換するフィルター。複数行テキストをストア上で行を崩さずに表示する。
payment_button フィルター（決済ボタン生成）
商品フォーム内で使用し、Apple Pay や Google Pay などの高速チェックアウトボタンを表示するための HTML コンテナを生成する。
payment_type_img_url フィルター（決済方法のアイコン画像 URL を取得）
決済方法の種類（クレジットカード、コンビニ払いなど）を引数に受け取り、その決済方法を示す SVG アイコン画像の URL を返すフィルター。ストアで有効にしている決済方法のロゴを一覧表示するときに使う。
plus フィルター（2つの数値を加算）
2つの数値を加算して合計を返すフィルター。整数・小数両方に対応する。
prepend フィルター（文字列の先頭に追加）
文字列の先頭に別の文字列を連結する。URL やパス、テキスト値を前置きしたいときに使う。
pluralize フィルター（単数・複数形の切り替え）
数値に応じて、文字列の単数形または複数形を選んで出力するフィルター。カート内のアイテム数など、1個と複数個で表記を変える必要があるときに使う。
reject フィルター（配列から特定値を除外）
配列から、指定したプロパティと値に一致するアイテムを除外するフィルター。where フィルターの逆の動作をする。
remove フィルター（文字列から部分文字列を削除）
文字列内のすべての部分文字列を削除する。指定した文字やテキストを文字列から除去する。
remove_last フィルター（最後の文字列を削除）
文字列の最後に出現する部分文字列を1つだけ削除するフィルター。指定した文字列が最後になければそのまま返す。
remove_first フィルター（文字列の最初の1つを削除）
文字列内の指定した部分文字列の最初の1つを削除して返すフィルター。複数回出現する場合は最初の1つだけを対象とする。
replace_first フィルター（最初の1つだけ置換）
文字列内の最初に出現する部分文字列を、別の文字列に置換する。複数回出現する場合でも最初の1つだけが対象。
replace フィルター（文字列を置換）
文字列内の指定した部分文字列をすべて別の文字列に置き換える。ハイフンをスペースに変えたり、特殊文字を削除したりする際に使う。
replace_last フィルター（文字列の最後に出現する部分文字列を置換）
文字列内で最後に出現する部分文字列を、指定した別の文字列に置換する。先頭から順に置換する replace フィルターと異なり、最後の1つだけを対象にする。
rstrip フィルター（右側の空白を削除）
文字列の右側にある空白文字（スペース、タブ、改行）をすべて削除する。左側の空白は削除しない。
sha1 フィルター（文字列をSHA-1ハッシュ化）
文字列を SHA-1 ハッシュに変換するフィルター。入力値から固定長の16進数文字列を生成する。
script_tag フィルター（JavaScript ファイルを <script> タグに変換）
アセット URL を受け取り、type="text/javascript" 属性付きの HTML <script> タグを生成するフィルター。テーマ内の JavaScript ファイルをストア上に読み込むときに使う。
sha256 フィルター（文字列をSHA-256ハッシュ化）
文字列を SHA-256 ハッシュに変換するフィルター。セキュリティと性能の面では blake3 フィルターの使用が推奨される。
shopify_asset_url フィルター（Shopifyグローバルアセット CDN URL を取得）
Shopify が提供する共有 JavaScript・CSS ファイル（option_selection.js、shopify_common.js など）の CDN URL を生成するフィルター。ファイル名を指定すると、Shopify CDN 上の完全な URL を返す。
sort_by フィルター（URL にソート条件を追加）
コレクション URL にソート条件を追加するフィルター。手動、売上順、商品名昇順・降順、価格昇順・降順、作成日昇順・降順から選べる。
strip フィルター（文字列の前後の空白を削除）
文字列の左右にある空白文字（スペース、改行、タブなど）をすべて削除するフィルター。テンプレート内の余分な改行やスペースをクリーンアップするのに用いられる。
strip_html フィルター（HTML タグを削除）
文字列に含まれるすべての HTML タグを削除し、テキストのみを抽出するフィルター。
strip_newlines フィルター（改行を削除）
文字列に含まれるすべての改行文字を削除するフィルター。商品説明やテキストメタフィールドから余分な改行を取り除く。
structured_data フィルター（schema.org 構造化データに変換）
商品またはブログ記事オブジェクトを schema.org の構造化データ形式に変換するフィルター。バリアントがない場合は Product 型、バリアントがある場合は ProductGroup 型として出力される。
split フィルター（文字列を区切り文字で分割）
文字列を指定の区切り文字で分割し、部分文字列の配列として返すフィルター。
upcase フィルター（文字列を大文字に変換）
文字列のすべての文字を大文字に変換するフィルター。英数字記号も対象。
times フィルター（数値を乗算）
数値に別の数値を乗算する。整数、小数どちらでも計算可能。
uniq フィルター（配列から重複要素を削除）
配列内の重複する要素を削除し、一意な値のみを残すフィルター。同じ値が複数回出現する場合は最初の1つだけを保持する。
url_decode フィルター（URL デコード）
パーセントエンコード（URL エンコード）された文字列を元の形にデコードする。メールアドレスや日本語を含む URL パラメータなどを人間が読める形に変換する。
url_encode フィルター（URL安全な文字列に変換）
文字列に含まれる URL に使えない文字をパーセントエンコード形式に変換する。スペースは `+` に変換される。
url_for_type フィルター（商品タイプ別URLを生成）
指定した商品タイプのみを表示するコレクションページの URL を生成する。商品タイプ文字列を渡すと、そのタイプに該当する商品一覧ページへのリンクが返される。
url_param_escape フィルター（URL パラメータ用文字列エスケープ）
文字列に含まれる URL パラメータとして安全でない文字をエスケープするフィルター。url_escape と同じ文字に加え、アンパサンド(&)もエスケープする。
url_for_vendor フィルター（ベンダー別コレクションURL生成）
指定したベンダー名から、そのベンダーの全商品を一覧表示するコレクションページの URL を生成する。
url_escape フィルター（URL エスケープ）
文字列に含まれる URL 安全でない文字（&、<、> など）をエスケープし、URL に埋め込める形に変換する。HTML エンティティではなく URL エンコード形式で処理する。
within フィルター（コレクション内の商品URL生成）
商品 URL にコレクションコンテキストを付加し、コレクション経由でアクセスされたときの URL を生成する。コレクションページから商品詳細ページへリンクするときに使う。
brightness_difference フィルター（色のコントラスト計算）
2つの色の知覚的な明度差を計算する。W3C のアクセシビリティ基準に基づいた数値を返す。
color_contrast フィルター（2色間のコントラスト比を計算）
2つの色のコントラスト比を計算し、比の分子を数値で返すフィルター。分母は常に1なので、戻り値が3.5なら3.5:1の比率を示す。
color_darken フィルター（色を暗くする）
指定した色を 0～100% の範囲で暗くする。RGB 値を暗度パーセンテージぶん低下させた新しい色コードを返す。
color_extract フィルター（色成分の抽出）
カラーコード（例: #EA5AB9）から指定した色成分（赤、緑、青、色相、彩度、明度など）を数値で抽出するフィルター。
color_difference フィルター（2色間のコントラスト差を計算）
2つの色のコントラスト差（色差）を W3C の AERT 基準に基づいて数値で計算する。アクセシビリティ評価に使用される標準的な指標。
color_desaturate フィルター（彩度低下）
指定した色の彩度を0～100の範囲でパーセント低下させるフィルター。RGB カラーコードを受け取り、彩度を落とした色を返す。
color_lighten フィルター（色を明るくする）
16進数カラーコードを指定した比率で明るくするフィルター。0～100 の範囲で指定したパーセンテージ分、色を淡くする。
color_saturate フィルター（色の彩度を上げる）
16進数カラーコード（例: #EA5AB9）の彩度を指定パーセンテージ分だけ上げて返す。0～100の範囲で調整できる。
external_video_tag フィルター（外部動画の埋め込みタグ生成）
YouTube や Vimeo などの外部動画メディアを HTML の `<iframe>` タグに変換し、ストア上に埋め込み可能な形で出力する。`external_video_url` フィルターと組み合わせて使用する。
file_url フィルター（ファイルCDN URL取得）
Shopify 管理画面の「ファイル」ページにアップロードされたファイル（PDF、画像など）の CDN URL を取得するフィルター。theme.liquid の Liquid テンプレート内で使用する。
find フィルター（配列から条件に合う最初の要素を取得）
配列内から指定したプロパティと値に一致する最初の要素を返すフィルター。該当する要素がない場合は nil を返す。
first フィルター（配列の最初の要素を取得）
配列の最初の要素を取得するフィルター。コレクション内の最初の商品、タグ一覧の最初の項目など、配列の先頭要素が必要なときに使う。