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

sort_natural フィルター(自然な文字順でソート)

配列の要素を大文字小文字を区別しない辞書順でソートするフィルター。数値や記号を含む文字列をアルファベット順に並べ替える。

用途
コレクションのタグ一覧をアルファベット順に表示したり、商品一覧をタイトル順に並び替えたりするとき。
設置場所
Liquid 内で `{{ array | sort_natural }}` または `{{ array | sort_natural: 'property_name' }}` の形で使う。プロパティ名を指定すれば、配列の各要素のそのプロパティでソートできる。
注意点
数値の大小比較には使えない。このフィルターは文字列に変換してからソートするため、数値配列では予期しない結果になる(例:「10」が「2」より前に来るなど)。数値のソートが必要な場合は `sort` フィルターを使う。
タグ:sortarrayfilterstring

仕様

40 行 / json
{
  "category": "array",
  "deprecated": false,
  "deprecation_reason": "",
  "description": "> Caution:\n> You shouldn't use the `sort_natural` filter to sort numerical values. When comparing items an array, each item is converted to a\n> string, so sorting on numerical values can lead to unexpected results.",
  "parameters": [],
  "return_type": [
    {
      "type": "array",
      "name": "",
      "description": "",
      "array_value": "untyped"
    }
  ],
  "examples": [
    {
      "name": "",
      "description": "",
      "syntax": "",
      "path": "/collections/all",
      "raw_liquid": "{% assign tags = collection.all_tags | sort_natural %}\n\n{% for tag in tags -%}\n  {{ tag }}\n{%- endfor %}",
      "parameter": false,
      "display_type": "text",
      "show_data_tab": true
    },
    {
      "name": "Sort by an array item property",
      "description": "You can specify an array item property to sort the array items by.\n",
      "syntax": "array | sort_natural: string",
      "path": "/collections/all",
      "raw_liquid": "{% assign products = collection.products | sort_natural: 'title' %}\n\n{% for product in products -%}\n  {{ product.title }}\n{%- endfor %}",
      "parameter": true,
      "display_type": "text",
      "show_data_tab": true
    }
  ],
  "summary": "Sorts the items in an array in case-insensitive alphabetical order.",
  "syntax": "array | sort_natural",
  "name": "sort_natural"
}

出典・ライセンス

License:
MIT

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

関連項目

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

avatar フィルター(顧客アバター画像HTML生成)

顧客アバターが存在する場合、それを表示する HTML タグを生成するフィルター。customer オブジェクトに対して使用する。

📁 theme-liquid-docs·MIT·19
📘 公式リファレンス🔧 リファレンス/フィルター初級

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

form.errors の各エラーコードに対応する既定のエラーメッセージを自動生成するフィルター。フォーム送信時の入力値不正や必須項目空白などのエラーを言語別に出力する。

📁 theme-liquid-docs·MIT·19
📘 公式リファレンス🔧 リファレンス/フィルター初級

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

日付値を指定されたフォーマット文字列に従って整形する。フォーマット文字列が空の場合は元の値がそのまま返される。入力が日付に変換できない場合も元の値が返される。

📁 theme-liquid-docs·MIT·19
📘 公式リファレンス🔧 リファレンス/フィルター初級

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

product フォームまたは cart フォームに対して使用し、Shop Pay の分割払いオプションを表示するための HTML を生成するフィルター。顧客が購入時に分割払いプランを選択できるようにする。

📁 theme-liquid-docs·MIT·19
📘 公式リファレンス🔧 リファレンス/フィルター初級

abs フィルター(数値の絶対値を取得)

負の数を正の数に変換する。数値の絶対値(ゼロからの距離)を返すフィルター。

📁 theme-liquid-docs·MIT·30
📘 公式リファレンス🔧 リファレンス/フィルター初級

append フィルター(文字列の末尾に追加)

文字列の末尾に別の文字列を連結するフィルター。URL パスの結合やテキストの接尾辞追加に使う。

📁 theme-liquid-docs·MIT·30