Roles Classes
This module adds CSS classes to the HTML body tag based on the roles assigned to the currently logged-in user. It allows for easy styling and custom behavior targeting of users by role, with options to configure class prefixes and exclude specific roles. The module also adds classes for authenticated and anonymous users.
The Body Roles Classes module adds CSS classes to the HTML element based on the roles of the currently logged-in user.
This helps developers and themers easily target users by role when applying styles or custom behaviors.
Features
- Adds role-based CSS classes to the element
- Configurable class prefix (e.g. role-editor, role-administrator)
- Option to exclude specific roles from being added as classes
- Adds user-authenticated and user-anonymous classes
- Cache-safe implementation using Drupal cache context (user.roles)
Example
If a user has the following roles:
- authenticated
- editor
The output will be:
<body class="role-authenticated role-editor">
If the "administrator" role is excluded, it will not be added as a class.
Configuration
After enabling the module, go to:
/admin/config/user-interface/body-roles-classes
You can:
- Enable or disable the module
- Set a class prefix
- Select roles to exclude from output
Installation
- Download and place the module in your
DRUPAL_ROOT/modules/contribdirectory. - Go to Admin > Extend and enable the module.
- Configure the module at Admin > Configuration > User Interface > Body Roles Classes.
Use Cases
- Role-based theming
- Custom styling for administrators, editors, or other roles
- Frontend personalization based on user roles
Notes
- Use the exclude roles option to prevent exposing sensitive roles (e.g. administrator) in the frontend.
- The module uses proper cache contexts to ensure correct output for each user.