【Shopifyテーマカスタマイズ】Liquidテンプレート言語のrequestオブジェクトについて解説！

requestオブジェクトとは？

ShopifyのLiquidテンプレート言語で使用できるrequestオブジェクトは、現在のHTTPリクエストに関する情報を提供する重要なLiquid変数です。
このオブジェクトを使用することで、現在のリクエストに基づいて動的にコンテンツを変更したり、特定の条件下でのみコードを実行したりできます。テーマのカスタマイズや条件付きコンテンツの表示に非常に有用です。

requestオブジェクトのプロパティ一覧

• request.design_mode
• request.host
• request.locale
• request.origin
• request.page_type
• request.path
• request.visual_preview_mode

request.design_mode とは？

テーマエディタ（Shopifyのカスタマイズ画面）で表示しているかどうかを判定するためのプロパティです。
テーマカスタマイズ画面でだけ表示するパーツを切り分けたいときなどに便利です。

request.design_mode が返す値

値（boolean）	意味
true	テーマエディタでプレビュー中
false	公開中の状態

request.host とは？

現在アクセスしているホスト名（ドメイン）を返します。
開発環境やサブドメインごとに条件分岐したい場合に役立ちます。

request.host が返す値

ドメイン	値（string）
Shopifyのサブドメインの場合	your-store.myshopify.com
独自ドメインの場合	example.com

request.locale とは？

ShopifyのLiquidテンプレート言語で使用できるrequestオブジェクトのひとつで、現在のリクエストの言語や地域の情報を取得するために使われるLiquid変数です。
このオブジェクトは特に多言語対応に便利で、Shopifyのテーマやカスタムコードにおいて、ユーザーがアクセスしている言語に応じた表示や設定の切り替えに利用されます。

request.locale.iso_code は、ISO 639-1形式の言語コード（例えば en、ja、fr など）を返します。

request.locale.iso_code が返す値

言語	ISO 639-1形式の言語コード
日本語	ja
英語	en
簡体字	zh-cn
繁体字	zh-tw
韓国語	ko

上記は一例です。

request.locale の使用例

Liquid

{%- liquid
    case request.locale.iso_code
        when 'en' // 英語
        when 'zh-CN' // 簡体
        when 'zh-TW' // 繁体
        when 'ko' // 韓国語
        else // 日本語
    endcase
-%}

request.locale を使用した関連の記事

request.origin とは？

リクエストの送信元のURLスキームとホストを返します。
フォーム送信や外部連携時の参照、セキュリティチェックなどに応用可能です。

request.origin が返す値

URL	値（string）
Shopifyのサブドメインの場合	https://your-store.myshopify.com
独自ドメインの場合	https://example.com

request.page_type とは？

ShopifyのLiquidテンプレート言語で使用できるrequestオブジェクトのひとつで、現在表示されているページのタイプを返すLiquid変数です。
これにより、開発者は特定のページタイプに応じて異なるコンテンツや機能を表示させることができます。

全ページ共通コードの「layout/theme.liquid」でよく使用します。

request.page_type が返す値

ページ（パス）	値
トップページ（/）	index
コレクション一覧（/collections）	list-collections
コレクション（/collections/コレクションハンドル）	collection
商品（/products/商品ハンドル）	product
カート（/cart）	cart
ブログ（/blogs/ブログハンドル）	blog
ブログ記事（/blogs/ブログハンドル／記事ハンドル）	article
独自ページ（/pages/ページハンドル）	page
メタオブジェクトのエントリーをページ化（/pages/定義ハンドル/エントリーハンドル）	metaobject
アカウント（/account）	customers/account
会員登録（/account/register）	customers/register
ログイン（/account/login）	customers/login
住所を変更する（/account/addresses）	customers/addresses
注文履歴（/account/order）	customers/order
アカウントを有効にする（メール文から確認するページ）	customers/activate_account
パスワードをリセットする（メール文から確認するページ）	customers/reset_password
検索（/search）	search
法務関連	policy
エラー	404
ギフトカード	gift_card
パスワード（ストア公開前のみ表示されるページ）	password

request.page_type を使用した関連の記事

request.path とは？

現在のURLパスをクエリパラメータなしで取得します。
ページパスに応じたスタイル適用や処理の分岐に役立ちます。

request.page_type が返す値

ページ（パス）	値（string）の例
コレクション	/collections/frontpage
商品	/products/your-product-handle
カート	/cart

request.visual_preview_mode とは？

ビジュアルプレビュー（A/Bテストやテーマプレビューなど）で表示されているかどうかを判定します。
プレビュー環境限定の表示や、実稼働環境と切り分けたいときに使います。

まとめ

いかでしたでしょうか？
今回の記事では、ShopifyにおけるLiquidテンプレートのrequestオブジェクトについて詳しく解説しました。

今回のポイントをまとめますと、次のとおりです。

他にもShopify Liquidに関する技術や実用テクニックを随時発信しています。
「役に立った」と思っていただけた方は、ぜひブックマークやSNSでのシェアをお願いいたします！

最後までお読みいただきありがとうございました！