Included formatters (Formatter Suite)

Last updated on
30 March 2019

Index of included formatters (For older version 1.1 & 1.0)

The Formatter Suite module contains the following field & file formatters, organized by the field/file types they support:

  1. Date & time
  2. Email
  3. Entity reference
  4. Image
  5. Numbers (Decimal, Float, and Integer)
  6. Text (String long, Text, Text long, and Text with Summary)
  7. Timestamp

Formatters for dates and times

Date & time list

Supports: Any Date & Time field.
A formatter based on the core Default formatter that also supports formatting multi-value fields as a list.
Settings include all settings from the Default formatter, plus those to select a list style and optional list separator, like a comma. List styles include numbered, bulleted, and unbulleted multi-line lists, and a single line list.
Logo

Custom date & time list

Supports: Any Date & Time field.
A formatter based on the core Custom formatter that also supports formatting multi-value fields as a list.
Settings include all settings from the Custom formatter, plus those to select a list style and optional list separator, like a comma. List styles include numbered, bulleted, and unbulleted multi-line lists, and a single line list.
Logo

Time ago list

Supports: Any Date & Time field.
A formatter based on the core Time ago formatter that also supports formatting multi-value fields as a list.
Settings include all settings from the Time ago formatter, plus those to select a list style and optional list separator, like a comma. List styles include numbered, bulleted, and unbulleted multi-line lists, and a single line list.
Logo


Formatters for email addresses

General email address

Supports: Any Email field.
A general-purpose formatter for email address fields.
Settings select whether to display the email address as plain text, as the address with a "mailto" link, or as a "mailto" link with custom text, such as "Email me" or "Contact us". "Mailto" links typically cause a web browser to start up the user's email application when clicked.
Logo

General email address list

Supports: Any Email field.
A formatter based on the General email address formatter that also supports formatting multi-value fields as a list.
Settings include all settings from the General email address formatter, plus those to select a list style and optional list separator, like a comma. List styles include numbered, bulleted, and unbulleted multi-line lists, and a single line list.
Logo


Formatters for entity references

General entity reference

Supports: Any Entity Reference field, including for Files, Images, Taxonomy terms, and Users.
A general-purpose formatter for entity reference fields for entities of any type, including those for files, images, taxonomy terms, and user accounts.
Settings select whether to display the referenced entity's ID, title, or a title linked to the entity.
Logo

General entity reference list


Supports: Any Entity Reference field, including for Files, Images, Users, and Taxonomy terms.
A formatter based on the General entity reference formatter that also supports formatting multi-value fields as a list.
Settings include all settings from the General entity reference formatter, plus those to select a list style and optional list separator, like a comma. List styles include numbered, bulleted, and unbulleted multi-line lists, and a single line list.
Logo

Rendered entity list


Supports: Any Entity Reference field, including for Files, Images, Users, and Taxonomy terms.
A formatter based on the core Render entity reference formatter that also supports formatting multi-value fields as a list.
Settings include all settings from the Render formatter, plus those to select a list style and optional list separator, like a comma. List styles include numbered, bulleted, and unbulleted multi-line lists, and a single line list.
Logo


Formatters for images

Image with embedded data URL

Supports: Any Image field.
A formatter based on the core Image formatter that is aimed at presenting small images by embeding them directly within the page using a data URL instead of a file URL. This can improve page loading times by reducing the number of files a browser has to request before it can present a page. This works best for small images, such as thumbnails.
Settings include all settings from the Image formatter, plus those to set the maximum image width and height for conversion into an data URL.
Logo


Formatters for numbers

Bytes with KB/MB/GB suffix

Supports: Any Decimal, Float, or Integer field.
A formatter specifically for fields that store the size of a quantity of digital data measured in bytes. This value could be a file size or the amount of memory required.
Settings select whether values are summarized as a quantity using the international standard for Kilobytes (1000 bytes = 1 KB) or legacy Kibibytes (1024 bytes = 1 KiB). Values may be expressed with a specified number of decimal digits, and suffixes may use abbreviations, like "KB", or full words, like "Kilobyte".
Logo

General number

Supports: Any Decimal, Float, or Integer field.
A general-purpose formatter for numeric values, including support for percentages and scientific notation. Formatting features are similar to those found in spreadsheet applications for formatting numeric cells.
Settings vary based upon a notation style:

  • Basic number: Formats numbers using basic settings controlling the number of decimal places and whether a thousands separator (,) is included.
  • General number: Formats numbers with detailed settings controlling the number of decimal places, the decimal separator, whether a thousands separator is included, the thousands separator, whether to pad with zeroes, the padding width, whether to show the plus sign on positive values, and whether to show the minus sign or parenthesis on negative values.
  • Numeral system: Formats numbers using a selected base, such as base 2 for binary, 8 for octal, or 16 for hex. Settings control the base and optional zero padding.
  • Percentage: Formats numbers as percentages by multiplying them by 100 and adding a percentage sign (%). Settings control the number of decimal places and whether a thousands separator (,) is included.
  • Scientific: Formats numbers using scientific notation and settings controlling the exponent style (E-notation or superscript), the number of decimal places, and whether a thousands separator (,) is included.

All general number notation styles support including the field's prefix and suffix before and after the value. The prefix is often used for currency symbols, while the suffix is often used for units of measure.
Logo

General number list

Supports: Any Decimal, Float, or Integer field.
A formatter based on the General number formatter that also supports formatting multi-value fields as a list.
Settings include all settings from the General number formatter, plus those to select a list style and optional list separator, like a comma. List styles include numbered, bulleted, and unbulleted multi-line lists, and a single line list.
Logo

General number with bar indicator

Supports: Any Decimal, Float, or Integer field.
A formatter based on the General number formatter that adds a colored horizontal bar beside the number. The bar's length varies based upon the field's value and its distance between the field's minimum and maximum values.
Settings include all settings from the General number formatter, plus those to set a maximum bar length, a bar width, and the bar and background color. The field's value can be shown before or after the bar, or omitted.
Logo

General number with min/max

Supports: Any Decimal, Float, or Integer field.
A formatter based on the General number formatter that also shows the field's minimum and maximum values, using a variety of styles.
Settings include all settings from the General number formatter, plus those to select among common formats for integrating the field's minimum and maximum with the value, such as "0 ≤ 5 ≤ 10", "5 out of 10", "5/10", and others. Formatted output also can be customized with a token-like syntax to place the minimum and maximum values along with the field's prefix and suffix.
Logo


Formatters for text

Text with expand/collapse buttons

Supports: Any String long, Text, Text long, or Text with Summary field.
A general-purpose formatter that presents long text values within an area shortened in height to a selected number of pixels, points, or ems. Expand and collapse buttons expand the text to full length, and return it to its shortened form.
Settings select the shortened text height and the labels for the expand and collapse buttons. Expand and collapse both use a brief animation to slide the area open or closed. The length of that animation, in milliseconds, can be set.
Logo


Formatters for timestamps

Timestamp list

Supports: Any Timestamp field, including Created and Changed dates.
A formatter based on the core Default formatter that also supports formatting multi-value fields as a list.
Settings include all settings from the Default formatter, plus those to select a list style and optional list separator, like a comma. List styles include numbered, bulleted, and unbulleted multi-line lists, and a single line list.
Logo

Time ago list

Supports: Any Timestamp field, including Created and Changed dates.
A formatter based on the core Time ago formatter that also supports formatting multi-value fields as a list.
Settings include all settings from the Time ago formatter, plus those to select a list style and optional list separator, like a comma. List styles include numbered, bulleted, and unbulleted multi-line lists, and a single line list.
Logo

Help improve this page

Page status: No known problems

You can: