📘 公式リファレンス🔧 リファレンス/フィルター初級

color_darken フィルター（色を暗くする）

指定した色を 0～100% の範囲で暗くする。RGB 値を暗度パーセンテージぶん低下させた新しい色コードを返す。

用途

テーマカスタマイザーで設定された基本色から、ホバー時やアクティブ状態用にワントーン暗い色を動的に生成したいとき。CSS 変数に色を埋め込む際、複数の暗さバリエーションが必要な場合に活用する。

設置場所

theme.liquid の `<style>` ブロック内、または section/snippet の `<style>` タグ内で `{{ settings.primary_color | color_darken: 20 }}` のように使う。

注意点

percent は 0～100 の数値である必要があり、範囲外の値を渡すと予測外の結果になる可能性があるため、管理画面の color 型設定値やハードコード値の妥当性を確認する。入力色は 16 進数（#RRGGBB または #RRGGBBAA）形式を想定しており、RGB 名（'red' など）では動作しない。

タグ:colorfiltercss-variabletheme-customizer

仕様

40 行 / json

{
  "category": "color",
  "deprecated": false,
  "deprecation_reason": "",
  "description": "",
  "parameters": [
    {
      "description": "The amount to darken the provided color by.",
      "name": "percent",
      "positional": true,
      "required": true,
      "types": [
        "number"
      ]
    }
  ],
  "return_type": [
    {
      "type": "string",
      "name": "",
      "description": "",
      "array_value": ""
    }
  ],
  "examples": [
    {
      "name": "",
      "description": "",
      "syntax": "",
      "path": "/",
      "raw_liquid": "{{ '#EA5AB9' | color_darken: 30 }}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    }
  ],
  "summary": "Darkens a given color by a specific percentage. The percentage must be between 0 and 100.",
  "syntax": "string | color_darken: number",
  "name": "color_darken"
}

出典・ライセンス

Source:: Shopify/theme-liquid-docs/data/filters.json
Repository:: https://github.com/Shopify/theme-liquid-docs
License:: MIT

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

color_darken フィルター（色を暗くする）

仕様

出典・ライセンス

関連項目

avatar フィルター（顧客アバター画像HTML生成）

default_errors フィルター（フォーム送信エラーを日本語化）

date フィルター（日付を指定形式でフォーマット）

payment_terms フィルター（Shop Pay分割払いバナーを生成）

abs フィルター（数値の絶対値を取得）

append フィルター（文字列の末尾に追加）