数字フィールド

• On this Page

  • 設定
  • テンプレート記法

数字フィールドでは、数値を受け入れるテキスト入力を提供します。

設定

数字フィールドの設定は、次の通りです。

• 初期値 – 新しいエレメントに適用するデフォルト値。
• 最小値 – フィールドに入力できる最小の数字。
• 最大値 – フィールドに入力できる最大の数字。
• 小数点 – フィールドに入力できる小数点以下の最大の桁数。
• プレフィックス – 入力欄の前に表示するテキスト。
• サフィックス – 入力欄の後に表示するテキスト。

テンプレート記法

数字フィールドによるエレメントの照会

数字フィールドを持つエレメントを照会する場合、フィールドのハンドルにちなんで名付けられたクエリパラメータを利用して、数字フィールドのデータに基づいた結果をフィルタできます。

利用可能な値には、次のものが含まれます。

値	取得するエレメント
100	値が 100。
'>= 100'	少なくとも、値が 100。
['>= 100', '<= 1000']	値が 100 から 1,000 の間。

{# Fetch entries with a Numbber field set to at least 100 #}
{% set entries = craft.entries()
    .myFieldHandle('>= 100')
    .all() %}

数字フィールドデータの操作

テンプレート内で数字フィールドのエレメントを取得する場合、数字フィールドのハンドルを利用して、そのデータにアクセスできます。

{% set value = entry.myFieldHandle %}

それは、フィールドの数値を提供します。値がない場合、null になります。

適切な千単位の区切り文字（例：,）でフォーマットするには、number フィルタを利用してください。

{{ entry.myFieldHandle|number }}

数字を常に整数とする場合、小数点なしで数字をフォーマットするために decimals=0 を渡してください。

{{ entry.myFieldHandle|number(decimals=0) }}

投稿フォームで数字フィールドを保存

数字フィールドを含む投稿フォームが必要な場合、出発点としてこのテンプレートを利用してください。

{% set field = craft.app.fields.getFieldByHandle('myFieldHandle') %}

{% set value = entry is defined
    ? entry.myFieldHandle
    : field.defaultValue %}

<input type="number"
    name="fields[myFieldHandle]"
    min="{{ field.min }}"
    max="{{ field.max }}"
    value="{{ value }}">