Documentation

CSS Ready Classes

  1. How to Use Ready Classes
  2. The Ready Class Names
    1. Halves (2 Columns)
    2. Thirds (3 Columns)
    3. Inline (Fluid One Line)
    4. List Classes
    5. Horizontal Form Layout
    6. Other Classes
  3. Q & A
  4. Additional Notes

In Gravity Forms 1.5 we added "Ready Classes". Using these new classes, you can easily create more advanced alternative layouts for the fields in your forms. Essentially, Ready Classes are class names that you can add to the parent element surrounding each field to take advantage of pre-defined styles included in the default form stylesheet.


How to Use Ready Classes

To add a Ready Class to a field, just edit your form in the Form Builder and then select the field you want to add the classes to. Under the "Appearance" tab, you'll see an input called "CSS class name". Add the Ready Class name or names you want to add to the field here and then save the form.

Readyclass_admin_input

Please note that this feature does NOT update live in the Form Builder. After you specify your Ready Class names, just save the form and you'll see the classes being applied to your form in the preview window and on the live site.


The Ready Class Names

Here are the Ready Classes that are built in the Gravity Forms default stylesheet that you can use right away without having to write any of your own CSS.


Halves (2 Columns)

Note: These only work with the "top label" form layout option and are intended to be used in left half/right half pairings to work properly.

  • gf_left_half
    This places the field in the left column (left half) of a 2 column layout. This only works with the "top label" form layout option.

  • gf_right_half
    This places the field in the left column (right half) of a 2 column layout. This only works with the "top label" form layout option.

To align two fields side by side (2 equal columns) you can add these classes. The two fields have to be adjacent to each other in the Form Builder. The gf_left_half class has to be added to the first field and the gf_right_half class to the second field.

Readyclass_2column


Thirds (3 Columns)

Note: These only work with the "top label" form layout option and are intended to be used in left third/middle third/right third pairings to work properly.

  • gf_left_third
    This places the field in the left column (left third) of a 3 column layout. This only works with the "top label" form layout option.

  • gf_middle_third
    This places the field in the middle column (middle third) of a 3 column layout. This only works with the "top label" form layout option.

  • gf_right_third
    This places the field in the right column (right third) of a 3 column layout. This only works with the "top label" form layout option.

To align three fields side by side (3 equal columns) you can add these classes. The three fields have to be adjacent to each other in the Form Builder. The gf_left_third class has to be added to the first field, the gf_middle_third class to the second field and the gf_right_third class to the third field.

Readyclass_3column


Inline (Fluid One Line)

  • gf_inline
    This places the field inline horizontally with other fields but does not create equally-spaced column layouts. This is useful for different sized fields or when you simply want a horizontal layout without actual column spacing.

Readyclass_gf_inline


List Classes

  • gf_list_2col
    This turns a multiple choice/checkbox list into an equally-spaced 2 column format. This only applies to multiple choice/checkbox lists and work with any of the form label position settings.

  • gf_list_3col
    This turns a multiple choice/checkbox list into an equally-spaced 3 column format. This only applies to multiple choice/checkbox lists and work with any of the form label position settings.

Readyclass_list_3column
* gf_list_4col
This turns a multiple choice/checkbox list into an equally-spaced 4 column format. This only applies to multiple choice/checkbox lists and work with any of the form label position settings.

  • gf_list_5col
    This turns a multiple choice/checkbox list into an equally-spaced 5 column format. This only applies to multiple choice/checkbox lists and work with any of the form label position settings.

  • gf_list_inline
    This turns a multiple choice/checkbox list into an inline horizontal list (not evenly spaced columns). This only applies to multiple choice/checkbox lists and work with any of the form label position settings.

Readyclass_list_inline
* gf_list_height_25
This applies a 25px height value all multiple choice/checkbox items in that list. This can be useful to avoid "hanging floats" caused by list items of unequal height. This only applies to multiple choice/checkbox lists and work with any of the form label position settings.

  • gf_list_height_50
    This applies a 50px height value all multiple choice/checkbox items in that list. This can be useful to avoid "hanging floats" caused by list items of unequal height. This only applies to multiple choice/checkbox lists and work with any of the form label position settings.

  • gf_list_height_75
    This applies a 75px height value all multiple choice/checkbox items in that list. This can be useful to avoid "hanging floats" caused by list items of unequal height. This only applies to multiple choice/checkbox lists and work with any of the form label position settings.

  • gf_list_height_100
    This applies a 100px height value all multiple choice/checkbox items in that list. This can be useful to avoid "hanging floats" caused by list items of unequal height. This only applies to multiple choice/checkbox lists and work with any of the form label position settings.

  • gf_list_height_125
    This applies a 125px height value all multiple choice/checkbox items in that list. This can be useful to avoid "hanging floats" caused by list items of unequal height. This only applies to multiple choice/checkbox lists and work with any of the form label position settings.

  • gf_list_height_150
    This applies a 150px height value all multiple choice/checkbox items in that list. This can be useful to avoid "hanging floats" caused by list items of unequal height. This only applies to multiple choice/checkbox lists and work with any of the form label position settings.


Horizontal Form Layout

  • gf_simple_horizontal
    when added to "CSS Class Name" in your form settings will create a very simple horizontal form layout (think simple email address field and inline form button). The field label is hidden so using the placeholder option for the field is recommended. Please note that this works best on very simple, single input field types.

Readyclass_scroll_text


Other Classes

  • gf_scroll_text
    This converts a section break field into a box with a fixed height that will automatically show a scroll bar if there's a large amount of text. This is useful if you're wanting to show large amounts of content to the user, but don't want to have to link to it or make the form very long to show it (Terms of Service Agreements, etc). This class only works on section breaks and works with any of the form label position settings.

Readyclass_scroll_text

  • gf_hide_ampm
    This hides the am/pm selector in the time field- this only hides the field on the form, not in the form entry table. This works with any of the form label position settings.

  • gf_hide_charleft
    This hides the characters left counter beneath paragraph text fields when using the maximum characters option. This works with any of the form label position settings.

  • gf_section_right
    when applied to the section break fields will align the section break right with the form fields if the left/right label form setting is selected.

    Readyclass_scroll_text


Q & A

  • Can I use multiple classes on the same field?
    Yes, you can use multiple classes together. Just separate each class name by a space. Note: This doesn't work for all of the styles, but many can be combined if they're applicable to the field type. For example, you may have a 2 column primary layout, and want to use 2 column list layouts within the columns.

  • Can I create my own classes?
    Yes, the classes are added to the parent <li> element surrounding a field so you can define your own class name and add your own rules to your theme stylesheet based on that class name being added to the field.


Additional Notes

You can also see an example of several of these classes applied in one form here.

One final note. As with any CSS rules, your particular theme CSS may override or supersede some of these styles. They've been tested in a variety of themes and work well, but you may have to make some adjustments to your theme styles for everything to work properly.