Formatting values

This page is the single home for everything about the rendering of property values. Pages that display values (listing, detail) reference it instead of repeating it.

Out of the box

Each property is rendered automatically from its detected type:

Type	Default rendering
boolean	`true` / `false` (raw, lowercase)
enum	the raw enum value
date / time / datetime	localized with ICU (MEDIUM date / SHORT time)
integer / float	localized number
`null`	empty cell
non-null unsupported value	`N/A`
currency	needs configuration - see the currency formatter below

Example: a nullable boolean renders `Oui`/`Non` (or stays empty)

The premium property of Article is a nullable boolean and renders true/false by default (empty when null). A French UI may want Oui/Non instead.

Point the property to the YesNoFormatter and capitalize the first letter:

karross:
  entities:
    App\Entity\Article:
      properties:
        premium:
          formatter: Karross\Formatters\Boolean\YesNoFormatter
          formatter_options:
            ucfirst: true

Result: the premium cell renders Oui / Non (French locale) instead of true / false, and stays empty when the value is null.

Example: a price with trailing zeros

A decimal column with scale: 2 displays 19,9 by default (no trailing zeros). To display 19,90 with exactly two decimals, set minimum_fraction_digits:

karross:
  entities:
    App\Entity\Article:
      properties:
        price:
          formatter_options:
            minimum_fraction_digits: 2
            maximum_fraction_digits: 2

How it works: the Doctrine column scale sets maximum_fraction_digits automatically when no formatter_options are provided. Adding minimum_fraction_digits pads the output with trailing zeros. Both options are forwarded to commerceguys/intl NumberFormatter.

Formatter options

Option	Applies to	Purpose
`currency`	`IntlCurrencyFormatter`	currency code (e.g. `EUR`)
`ucfirst`	all formatters	capitalize the first letter of translated values
`minimum_fraction_digits`	`IntlNumberFormatter`	minimum decimals to display (default: none)
`maximum_fraction_digits`	`IntlNumberFormatter`	maximum decimals to display (default: Doctrine column `scale`, if set)

Formatter catalog

Formatter	Purpose
`Karross\Formatters\StringFormatter`	plain string
`Karross\Formatters\Boolean\TrueFalseFormatter`	`true` / `false` (default for booleans)
`Karross\Formatters\Boolean\YesNoFormatter`	`yes` / `no` (translated)
`Karross\Formatters\EnumFormatter`	raw enum value
`Karross\Formatters\IntlNumberFormatter`	localized number
`Karross\Formatters\IntlCurrencyFormatter`	localized currency (needs `currency`)
`Karross\Formatters\DateTime\{Date,Time,DateTime}Formatter`	localized date/time
`Karross\Formatters\NotAvailableFormatter`	`N/A`

Translations of cell values

Translated values are resolved through cascading keys (see Translations). The bundle ships English and French defaults for true/false and yes/no, in lowercase.

How it works: formatters are Symfony services tagged karross.formatter. Metadata resolves the formatter class once at boot; a resolver returns the instance at render time. Dates and numbers use ICU, currency uses commerceguys/intl. The Formatters\Boolean\TrueFalseFormatter is the default resolver for boolean properties; picking another formatter is done per property via configuration.