raw_fields_formatters

RAW Fields Formatters

Provides raw field formatters for Drupal, designed to expose field values as structured data. Primarily intended for use with Single-Directory Components (SDC) and JSON rendering pipelines.

Overview

Each formatter outputs raw typed values (string, integer, boolean, float, array) instead of rendered HTML, making it straightforward to pass field data directly to SDC component props.

All formatters share two common settings:

• Override default key with — Override the key used when the renderer collects field data.
• Force as array — Always output a list, even when there is only one value.

Available formatters

Formatter Field types Extra settings Raw Boolean boolean — Raw Decimal decimal, float — Raw Formatted Text text, text_long, text_with_summary — Raw Geolocation Lat/Lng geolocation — Raw Icon ui_icon — Raw Image URL image Image style Raw Integer integer — Raw List Value list_integer, list_float, list_string — Raw Entity entity_reference View mode Raw Paragraph entity_reference_revisions View mode Raw String string, string_long, telephone — Raw URL link —

Optional dependencies

Some formatters require a contrib module to be useful:

• Raw Geolocation Lat/Lng — requires Geolocation
• Raw Icon — requires UI Icons
• Raw Paragraph — requires Entity Reference Revisions (included in Paragraphs)

Usage with RawRenderer

Use the raw_fields_formatters.renderer service to collect the rendered data into a plain PHP array:

$renderer = \Drupal::service('raw_fields_formatters.renderer');
$variables = ['elements' => $build];
$renderer->renderData($variables);
$data = $variables['data'];

Requirements

• Drupal 10 or 11
• PHP 8.1+

Installation

Install as any other Drupal module via Composer:

composer require drupal/raw_fields_formatters
drush en raw_fields_formatters

Maintainers

• Kevin Gautreau (kgaut)