編集可能フィールドの数値形式の設定

  • リリースバージョン: Australia
  • 更新日 2026年03月12日
  • 所要時間:2分
  • 指定された形式を維持する、ユーザーが編集可能なフィールドを作成する方法について説明します。

    アドミンが特定の形式でエンドユーザーに数値フィールドを表示し、ユーザーにそのフィールドの編集も許可したい場合、解決策は、フィールドの表示タイプを書式設定された数値に設定することです。

    数値フィールド画面

    現在、編集可能なフィールドで数値の書式設定を使用する唯一の方法は、レイアウト CSV 自体からこのコンポーネント表示タイプを設定することです。エクスポートしてお好みの CSV エディター (この例では Excel) で開いたら、フィールドの行に以下を追加できます。
    • FormattedNumber から列 F (コンポーネント表示タイプ)
    • 形式:{...} 列 I へ (値)

    レイアウト CSV

    これが保存されたら、このレイアウトCSVをレイアウトエディターウィンドウにドラッグすると、現在のレイアウトが置き換えられます。この変更が行われたことは、表示タイプが空白になるレイアウトエディターの [フィールド情報の編集] タブの両方から確認できます。

    レイアウト CSV

    また、[レイアウトの配置] タブでは、数値フィールドのフィールドプロパティで、[生の値] セクションに入力された形式が使用されます。

    レイアウト CSV

    レイアウト CSV

    ブループリントを保存してデプロイすると、このページの上部にあるスクリーンショットのような結果が表示されます。その他の書式設定オプションを以下に示します。

    {
    	"format": {
    		"type": "currency" | "percent" | "unit" | "decimal",
    		"precision": 2, // Any positive integer
    		"unit": Unit, // List of standard JS units, i18n supported
    		"customUnit": string, // Any unit to append to the end of the value, untranslated
    		"displayZeroPriceAs": string,
    		"displayNullPriceAs": string
    	}
    }

    パーセントの書式設定には自動的に 100 が乗算されます。したがって、フィールド値 0.1 は 10% と表示されます。

    type: unit、unit: percent を使用すると、計算なしでパーセント記号のみを表示できます。

    サポートされている単位のリストを表示するには、「 ECMAScript® 2026 インターナショナリゼーション API 仕様」を参照してください。

    このリストにない単位には customUnit を使用できます。