On this page
- Index of included formatters (For older version 1.1 & 1.0)
- Formatters for dates and times
- Date & time list
- Custom date & time list
- Time ago list
- Formatters for email addresses
- General email address
- General email address list
- Formatters for entity references
- General entity reference
- General entity reference list
- Rendered entity list
- Formatters for images
- Image with embedded data URL
- Formatters for numbers
- Bytes with KB/MB/GB suffix
- General number
- General number list
- General number with bar indicator
- General number with min/max
- Formatters for text
- Text with expand/collapse buttons
- Formatters for timestamps
- Timestamp list
- Time ago list
Included formatters (Formatter Suite)
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:
- Date & time
- Entity reference
- Image
- Numbers (Decimal, Float, and Integer)
- Text (String long, Text, Text long, and Text with Summary)
- 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.
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.
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.
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.
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.
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.
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.
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.
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.
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".
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.
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.
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.
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.
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.
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.
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.
Help improve this page
You can:
- Log in, click Edit, and edit this page
- Log in, click Discuss, update the Page status value, and suggest an improvement
- Log in and create a Documentation issue with your suggestion