Example of HTML markup produced by Field formatter class module. The custom class is highlighted on the field wrapper DIV.
Field formatter class settings on the manage-display tab, showing a custom class being added to a term reference field.

Allows site administrators to add classes to the outer HTML wrapper for any field display, so that CSS and Javascript can target them.

It's particulary useful for adding classes required by various jQuery plugins and CSS grid systems.

Instructions

The Field Formatter Class settings are found in the Manage display tab for content types, users, and other entities. A text box is available for each field, revealed by using the formatter settings edit button (gear wheel icon) for that field.

The class is added to the outer <div> container for the field. The default Drupal field classes (e.g. "field-type-taxonomy-term-reference") remain available - this module does not remove any classes.

The accompanying screenshot images show the settings form and some example HTML output.

This module works well in tandem with Field Group. Note that this module only adds classes to field formatters; to add classes to field groups, use the settings provided by the Field Group module.

Tutorials

Dependencies

The Drupal 7 version depends on Field Formatter Settings API module.

Development status

Drupal 7:

Field formatter class is now feature-complete. Future development for D7 will be limited to bug fixes and/or security issues.

Drupal 8:

A D8 port is available for testing. It has frequently been broken by changes in the core Entity & Field API, but it has also helped uncover bugs in core. Once D8 core reaches the beta stage, I'll return to this.

Known Issues

There is a compatibility problem when using this module in combination with the extra fields provided by Display Suite. The issue potentially affects all modules which implement Field formatter settings API, and a solution is being explored in the Display suite project.
See #1616426: Compatibility with Display Suite

Supporting organizations: 
sponsored maintainer's time (andrewmacpherson) for D8 port

Project Information

Downloads