This plugin allows you to add custom data attributes to Gravity Forms fields.
It should work with:
- all of the Standard field types
- any of the Advanced field types that only have one input field (e.g., Email but not Address)
- the List advanced field type, including with multiple columns (thanks @reddo!).
For fields with choices, such as checkboxes, you can assign separate values for each data attribute for each choice (the UI for this is ugly right now 🤷).
For each field you want to enable data attributes for:
- On the field's General settings tab, check the Enable Data Attributes box.
- In the Data Attribute Names field that appears, enter one data attribute name (e.g.,
my-attribute
) per line.- Do not prefix your attribute name with
data-
. The plugin will do that for you,
- Do not prefix your attribute name with
- Save your form.
- Reopen the field settings. You will now see additional setting fields where you can enter the value of each data attribute you added.
- For fields with choices, such as checkboxes, the data attribute value settings appear next to each choice's name and value fields.
- For other fields, the data attribute value settings will appear underneath the Data Attribute Names field.
There are three options for installing this plugin:
- With composer from Packagist:
composer require mmirus/gravity-forms-data-attributes
- With GitHub Updater
- By downloading the latest release ZIP from this repository and installing it like any normal WordPress plugin
To work on this project (for yourself or to contribute a PR):
- Clone this repo
- Run
composer install
- Run
yarn
ornpm install
And you should be good to go.
Pre-commit linting is enforced (see .eslintrc.js
and .stylelintrc.js
for scripts and styles; PHP uses PSR-2).
Settings for a field without choices
Settings for a field with choices (checkboxes)