📘 公式リファレンス🔧 リファレンス/フィルター初級
truncate フィルター(文字列を指定文字数で切る)
文字列を指定した文字数に切り詰め、末尾に省略記号(デフォルトは `...`)を付与するフィルター。省略記号を含めた総文字数が指定値以下になる。
用途
ブログ記事のタイトルや商品説明など、長いテキストをカード表示で一定幅に収めたいとき。
設置場所
Liquid テンプレート内で `{{ article.title | truncate: 15 }}` の形で使用。第2引数で省略記号をカスタマイズでき、空文字を指定すれば省略記号なしで単純に切り詰める。
注意点
省略記号(デフォルト `...`)は指定文字数に含まれるため、`truncate: 15` で実際のテキストは最大12文字になる。日本語を含む場合も1文字1単位としてカウントされるため、絵文字や特殊文字を含むテキストでは長さが不規則になりうる。CSS の `text-overflow: ellipsis` と異なり、Liquid レベルで確実に文字数制限されるため、HTML 側での overflow 対応は不要。
仕様
40 行 / json{
"category": "string",
"deprecated": false,
"deprecation_reason": "",
"description": "If the specified number of characters is less than the length of the string, then an ellipsis (`...`) is appended to\nthe truncated string. The ellipsis is included in the character count of the truncated string.",
"parameters": [],
"return_type": [
{
"type": "string",
"name": "",
"description": "",
"array_value": ""
}
],
"examples": [
{
"name": "",
"description": "",
"syntax": "",
"path": "/blogs/potion-notions/how-to-tell-if-you-have-run-out-of-invisibility-potion",
"raw_liquid": "{{ article.title | truncate: 15 }}",
"parameter": false,
"display_type": "text",
"show_data_tab": true
},
{
"name": "Specify a custom ellipsis",
"description": "You can provide a second parameter to specify a custom ellipsis. If you don't want an ellipsis, then you can supply an empty string.\n",
"syntax": "string | truncate: number, string",
"path": "/blogs/potion-notions/how-to-tell-if-you-have-run-out-of-invisibility-potion",
"raw_liquid": "{{ article.title | truncate: 15, '--' }}\n{{ article.title | truncate: 15, '' }}",
"parameter": true,
"display_type": "text",
"show_data_tab": true
}
],
"summary": "Truncates a string down to a given number of characters.",
"syntax": "string | truncate: number",
"name": "truncate"
}出典・ライセンス
- Repository:
- https://github.com/Shopify/theme-liquid-docs
- 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 行