2017-07-17 14:05:39 +00:00
---
2017-07-29 12:02:00 +00:00
title: Form controls
2017-07-17 14:05:39 +00:00
layout: documentation
doc-tab: form
doc-subtab: general
2017-10-17 09:28:59 +00:00
variables_controls_keys:
- control-radius
- control-radius-small
- control-padding-vertical
- control-padding-horizontal
variables_form_keys:
- label-color
- label-weight
- help-size
2017-07-17 14:05:39 +00:00
---
{% capture example %}
< div class = "field" >
< label class = "label" > Name< / label >
2017-07-17 14:51:22 +00:00
< div class = "control" >
2017-07-17 14:05:39 +00:00
< input class = "input" type = "text" placeholder = "Text input" >
2017-07-17 14:51:22 +00:00
< / div >
2017-07-17 14:05:39 +00:00
< / div >
< div class = "field" >
< label class = "label" > Username< / label >
< div class = "control has-icons-left has-icons-right" >
< input class = "input is-success" type = "text" placeholder = "Text input" value = "bulma" >
< span class = "icon is-small is-left" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-user" > < / i >
2017-07-17 14:05:39 +00:00
< / span >
< span class = "icon is-small is-right" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-check" > < / i >
2017-07-17 14:05:39 +00:00
< / span >
< / div >
< p class = "help is-success" > This username is available< / p >
< / div >
< div class = "field" >
< label class = "label" > Email< / label >
< div class = "control has-icons-left has-icons-right" >
2017-08-28 08:31:52 +00:00
< input class = "input is-danger" type = "email" placeholder = "Email input" value = "hello@" >
2017-07-17 14:05:39 +00:00
< span class = "icon is-small is-left" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-envelope" > < / i >
2017-07-17 14:05:39 +00:00
< / span >
< span class = "icon is-small is-right" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-exclamation-triangle" > < / i >
2017-07-17 14:05:39 +00:00
< / span >
< / div >
< p class = "help is-danger" > This email is invalid< / p >
< / div >
< div class = "field" >
< label class = "label" > Subject< / label >
< div class = "control" >
2017-07-17 18:17:57 +00:00
< div class = "select" >
2017-07-17 14:05:39 +00:00
< select >
< option > Select dropdown< / option >
< option > With options< / option >
< / select >
2017-07-17 18:17:57 +00:00
< / div >
2017-07-17 14:05:39 +00:00
< / div >
< / div >
< div class = "field" >
< label class = "label" > Message< / label >
< div class = "control" >
< textarea class = "textarea" placeholder = "Textarea" > < / textarea >
< / div >
< / div >
< div class = "field" >
< div class = "control" >
< label class = "checkbox" >
< input type = "checkbox" >
I agree to the < a href = "#" > terms and conditions< / a >
< / label >
< / div >
< / div >
< div class = "field" >
< div class = "control" >
< label class = "radio" >
< input type = "radio" name = "question" >
Yes
< / label >
< label class = "radio" >
< input type = "radio" name = "question" >
No
< / label >
< / div >
< / div >
< div class = "field is-grouped" >
< div class = "control" >
2017-10-09 17:13:02 +00:00
< button class = "button is-link" > Submit< / button >
2017-07-17 14:05:39 +00:00
< / div >
< div class = "control" >
2017-10-09 17:13:02 +00:00
< button class = "button is-text" > Cancel< / button >
2017-07-17 14:05:39 +00:00
< / div >
< / div >
{% endcapture %}
{% capture field_example %}
< div class = "field" >
< label class = "label" > Label< / label >
< div class = "control" >
< input class = "input" type = "text" placeholder = "Text input" >
< / div >
< p class = "help" > This is a help text< / p >
< / div >
{% endcapture %}
{% capture fields_example %}
< div class = "field" >
< label class = "label" > Name< / label >
< div class = "control" >
< input class = "input" type = "text" placeholder = "e.g Alex Smith" >
< / div >
< / div >
< div class = "field" >
< label class = "label" > Email< / label >
< div class = "control" >
< input class = "input" type = "email" placeholder = "e.g. alexsmith@gmail.com" >
< / div >
< / div >
{% endcapture %}
{% capture control_input_example %}
< div class = "control" >
< input class = "input" type = "text" placeholder = "Text input" >
< / div >
{% endcapture %}
{% capture control_select_example %}
< div class = "control" >
< div class = "select" >
< select >
< option > Select dropdown< / option >
< option > With options< / option >
< / select >
< / div >
< / div >
{% endcapture %}
{% capture control_button_example %}
< div class = "control" >
< button class = "button is-primary" > Submit< / button >
< / div >
{% endcapture %}
2017-07-17 14:51:22 +00:00
{% capture icons_example %}
< div class = "field" >
< p class = "control has-icons-left has-icons-right" >
< input class = "input" type = "email" placeholder = "Email" >
< span class = "icon is-small is-left" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-envelope" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< span class = "icon is-small is-right" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-check" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< / p >
< / div >
< div class = "field" >
< p class = "control has-icons-left" >
< input class = "input" type = "password" placeholder = "Password" >
< span class = "icon is-small is-left" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-lock" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< / p >
< / div >
< div class = "field" >
< p class = "control" >
< button class = "button is-success" >
Login
< / button >
< / p >
< / div >
{% endcapture %}
{% capture select_icons_example %}
< div class = "field" >
< p class = "control has-icons-left" >
< span class = "select" >
< select >
< option selected > Country< / option >
< option > Select dropdown< / option >
< option > With options< / option >
< / select >
< / span >
< span class = "icon is-small is-left" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-globe" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< / p >
< / div >
{% endcapture %}
{% capture has_icons_small_example %}
< div class = "field" >
< label class = "label is-small" > Small input< / label >
< div class = "control has-icons-left has-icons-right" >
2018-01-10 16:30:23 +00:00
< input class = "input is-small" type = "email" placeholder = "Normal" >
2017-07-17 14:51:22 +00:00
< span class = "icon is-small is-left" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-envelope" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< span class = "icon is-small is-right" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-check" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< / div >
< / div >
{% endcapture %}
{% capture has_icons_normal_example %}
< div class = "field" >
< label class = "label" > Normal input< / label >
< div class = "control has-icons-left has-icons-right" >
2018-01-10 16:30:23 +00:00
< input class = "input" type = "email" placeholder = "Extra small" >
2017-07-17 14:51:22 +00:00
< span class = "icon is-small is-left" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-envelope fa-xs" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< span class = "icon is-small is-right" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-check fa-xs" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< / div >
< / div >
< div class = "field" >
< div class = "control has-icons-left has-icons-right" >
2018-01-10 16:30:23 +00:00
< input class = "input" type = "email" placeholder = "Normal" >
2017-07-17 14:51:22 +00:00
< span class = "icon is-left" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-envelope" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< span class = "icon is-right" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-check" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< / div >
< / div >
{% endcapture %}
{% capture has_icons_medium_example %}
< div class = "field" >
< label class = "label is-medium" > Medium input< / label >
< div class = "control has-icons-left has-icons-right" >
2018-01-10 16:30:23 +00:00
< input class = "input is-medium" type = "email" placeholder = "Extra small" >
2017-07-17 14:51:22 +00:00
< span class = "icon is-small is-left" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-envelope fa-xs" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< span class = "icon is-small is-right" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-check fa-xs" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< / div >
< / div >
< div class = "field" >
< div class = "control has-icons-left has-icons-right" >
2018-01-10 16:30:23 +00:00
< input class = "input is-medium" type = "email" placeholder = "Small" >
2017-07-17 14:51:22 +00:00
< span class = "icon is-left" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-envelope fa-sm" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< span class = "icon is-right" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-check fa-sm" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< / div >
< / div >
< div class = "field" >
< div class = "control has-icons-left has-icons-right" >
2018-01-10 16:30:23 +00:00
< input class = "input is-medium" type = "email" placeholder = "Normal" >
2017-07-17 14:51:22 +00:00
< span class = "icon is-medium is-left" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-envelope" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< span class = "icon is-medium is-right" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-check" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< / div >
< / div >
{% endcapture %}
{% capture has_icons_large_example %}
< div class = "field" >
< label class = "label is-large" > Large input< / label >
< div class = "control has-icons-left has-icons-right" >
2018-01-10 16:30:23 +00:00
< input class = "input is-large" type = "email" placeholder = "Extra small" >
2017-07-17 14:51:22 +00:00
< span class = "icon is-small is-left" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-envelope fa-xs" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< span class = "icon is-small is-right" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-check fa-xs" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< / div >
< / div >
< div class = "field" >
< div class = "control has-icons-left has-icons-right" >
2018-01-10 16:30:23 +00:00
< input class = "input is-large" type = "email" placeholder = "Small" >
2017-07-17 14:51:22 +00:00
< span class = "icon is-left" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-envelope fa-sm" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< span class = "icon is-right" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-check fa-sm" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< / div >
< / div >
< div class = "field" >
< div class = "control has-icons-left has-icons-right" >
2018-01-10 16:30:23 +00:00
< input class = "input is-large" type = "email" placeholder = "Normal" >
< span class = "icon is-large is-left" >
< i class = "fas fa-envelope" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
2018-01-10 16:30:23 +00:00
< span class = "icon is-large is-right" >
< i class = "fas fa-check" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< / div >
< / div >
< div class = "field" >
< div class = "control has-icons-left has-icons-right" >
2018-01-10 16:30:23 +00:00
< input class = "input is-large" type = "email" placeholder = "Large" >
< span class = "icon is-medium is-left" >
< i class = "fas fa-envelope fa-lg" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
2018-01-10 16:30:23 +00:00
< span class = "icon is-medium is-right" >
< i class = "fas fa-check fa-lg" > < / i >
2017-07-17 14:51:22 +00:00
< / span >
< / div >
< / div >
{% endcapture %}
2017-07-17 14:05:39 +00:00
{% capture addons_example %}
< div class = "field has-addons" >
2017-07-17 14:51:22 +00:00
< div class = "control" >
2017-07-17 14:05:39 +00:00
< input class = "input" type = "text" placeholder = "Find a repository" >
2017-07-17 14:51:22 +00:00
< / div >
< div class = "control" >
2017-07-17 14:05:39 +00:00
< a class = "button is-info" >
Search
< / a >
2017-07-17 14:51:22 +00:00
< / div >
2017-07-17 14:05:39 +00:00
< / div >
{% endcapture %}
{% capture addons_static_example %}
< div class = "field has-addons" >
< p class = "control" >
< input class = "input" type = "text" placeholder = "Your email" >
< / p >
< p class = "control" >
< a class = "button is-static" >
@gmail.com
< / a >
< / p >
< / div >
{% endcapture %}
{% capture addons_expanded_example %}
< div class = "field has-addons" >
< p class = "control" >
< span class = "select" >
< select >
< option > $< / option >
< option > £< / option >
< option > €< / option >
< / select >
< / span >
< / p >
< p class = "control" >
< input class = "input" type = "text" placeholder = "Amount of money" >
< / p >
< p class = "control" >
< a class = "button" >
Transfer
< / a >
< / p >
< / div >
< div class = "field has-addons" >
< p class = "control" >
< span class = "select" >
< select >
< option > $< / option >
< option > £< / option >
< option > €< / option >
< / select >
< / span >
< / p >
< p class = "control is-expanded" >
< input class = "input" type = "text" placeholder = "Amount of money" >
< / p >
< p class = "control" >
< a class = "button" >
Transfer
< / a >
< / p >
< / div >
{% endcapture %}
{% capture addons_expanded_fullwidth_example %}
< div class = "field has-addons" >
2017-07-17 14:51:22 +00:00
< div class = "control is-expanded" >
< div class = "select is-fullwidth" >
2017-07-17 14:05:39 +00:00
< select name = "country" >
< option value = "Argentina" > Argentina< / option >
< option value = "Bolivia" > Bolivia< / option >
< option value = "Brazil" > Brazil< / option >
< option value = "Chile" > Chile< / option >
< option value = "Colombia" > Colombia< / option >
< option value = "Ecuador" > Ecuador< / option >
< option value = "Guyana" > Guyana< / option >
< option value = "Paraguay" > Paraguay< / option >
< option value = "Peru" > Peru< / option >
< option value = "Suriname" > Suriname< / option >
< option value = "Uruguay" > Uruguay< / option >
< option value = "Venezuela" > Venezuela< / option >
< / select >
2017-07-17 14:51:22 +00:00
< / div >
< / div >
< div class = "control" >
2017-07-17 14:05:39 +00:00
< button type = "submit" class = "button is-primary" > Choose< / button >
2017-07-17 14:51:22 +00:00
< / div >
2017-07-17 14:05:39 +00:00
< / div >
{% endcapture %}
{% capture addons_center_example %}
< div class = "field has-addons has-addons-centered" >
< p class = "control" >
< span class = "select" >
< select >
< option > $< / option >
< option > £< / option >
< option > €< / option >
< / select >
< / span >
< / p >
< p class = "control" >
< input class = "input" type = "text" placeholder = "Amount of money" >
< / p >
< p class = "control" >
< a class = "button is-primary" >
Transfer
< / a >
< / p >
< / div >
{% endcapture %}
{% capture addons_right_example %}
< div class = "field has-addons has-addons-right" >
< p class = "control" >
< span class = "select" >
< select >
< option > $< / option >
< option > £< / option >
< option > €< / option >
< / select >
< / span >
< / p >
< p class = "control" >
< input class = "input" type = "text" placeholder = "Amount of money" >
< / p >
< p class = "control" >
< a class = "button is-primary" >
Transfer
< / a >
< / p >
< / div >
{% endcapture %}
{% capture group_example %}
2017-07-24 18:45:21 +00:00
< div class = "field is-grouped" >
< p class = "control" >
< a class = "button is-primary" >
Submit
< / a >
< / p >
< p class = "control" >
< a class = "button is-light" >
Cancel
< / a >
< / p >
< / div >
{% endcapture %}
{% capture group_centered_example %}
< div class = "field is-grouped is-grouped-centered" >
< p class = "control" >
< a class = "button is-primary" >
Submit
< / a >
< / p >
< p class = "control" >
< a class = "button is-light" >
Cancel
< / a >
< / p >
< / div >
{% endcapture %}
{% capture group_right_example %}
< div class = "field is-grouped is-grouped-right" >
< p class = "control" >
< a class = "button is-primary" >
Submit
< / a >
< / p >
< p class = "control" >
< a class = "button is-light" >
Cancel
< / a >
< / p >
< / div >
{% endcapture %}
{% capture group_expanded_example %}
2017-07-17 14:05:39 +00:00
< div class = "field is-grouped" >
< p class = "control is-expanded" >
< input class = "input" type = "text" placeholder = "Find a repository" >
< / p >
< p class = "control" >
< a class = "button is-info" >
Search
< / a >
< / p >
< / div >
{% endcapture %}
2017-07-24 18:45:21 +00:00
{% capture group_multiline_example %}
< div class = "field is-grouped is-grouped-multiline" >
< p class = "control" >
< a class = "button" >
One
< / a >
< / p >
< p class = "control" >
< a class = "button" >
Two
< / a >
< / p >
< p class = "control" >
< a class = "button" >
Three
< / a >
< / p >
< p class = "control" >
< a class = "button" >
Four
< / a >
< / p >
< p class = "control" >
< a class = "button" >
Five
< / a >
< / p >
< p class = "control" >
< a class = "button" >
Size
< / a >
< / p >
< p class = "control" >
< a class = "button" >
Seven
< / a >
< / p >
< p class = "control" >
< a class = "button" >
Eight
< / a >
< / p >
< p class = "control" >
< a class = "button" >
Nine
< / a >
< / p >
< p class = "control" >
< a class = "button" >
Ten
< / a >
< / p >
< p class = "control" >
< a class = "button" >
Eleven
< / a >
< / p >
< p class = "control" >
< a class = "button" >
Twelve
< / a >
< / p >
< p class = "control" >
< a class = "button" >
Thirteen
< / a >
< / p >
< / div >
{% endcapture %}
2017-07-17 14:05:39 +00:00
{% capture horizontal_form_example %}
< div class = "field is-horizontal" >
< div class = "field-label is-normal" >
< label class = "label" > From< / label >
< / div >
< div class = "field-body" >
< div class = "field" >
< p class = "control is-expanded has-icons-left" >
< input class = "input" type = "text" placeholder = "Name" >
< span class = "icon is-small is-left" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-user" > < / i >
2017-07-17 14:05:39 +00:00
< / span >
< / p >
< / div >
< div class = "field" >
< p class = "control is-expanded has-icons-left has-icons-right" >
< input class = "input is-success" type = "email" placeholder = "Email" value = "alex@smith.com" >
< span class = "icon is-small is-left" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-envelope" > < / i >
2017-07-17 14:05:39 +00:00
< / span >
< span class = "icon is-small is-right" >
2018-01-10 16:30:23 +00:00
< i class = "fas fa-check" > < / i >
2017-07-17 14:05:39 +00:00
< / span >
< / p >
< / div >
< / div >
< / div >
< div class = "field is-horizontal" >
< div class = "field-label" > < / div >
< div class = "field-body" >
< div class = "field is-expanded" >
< div class = "field has-addons" >
< p class = "control" >
< a class = "button is-static" >
+44
< / a >
< / p >
< p class = "control is-expanded" >
< input class = "input" type = "tel" placeholder = "Your phone number" >
< / p >
< / div >
< p class = "help" > Do not enter the first zero< / p >
< / div >
< / div >
< / div >
< div class = "field is-horizontal" >
< div class = "field-label is-normal" >
< label class = "label" > Department< / label >
< / div >
< div class = "field-body" >
< div class = "field is-narrow" >
< div class = "control" >
< div class = "select is-fullwidth" >
< select >
< option > Business development< / option >
< option > Marketing< / option >
< option > Sales< / option >
< / select >
< / div >
< / div >
< / div >
< / div >
< / div >
< div class = "field is-horizontal" >
< div class = "field-label" >
< label class = "label" > Already a member?< / label >
< / div >
< div class = "field-body" >
< div class = "field is-narrow" >
< div class = "control" >
< label class = "radio" >
< input type = "radio" name = "member" >
Yes
< / label >
< label class = "radio" >
< input type = "radio" name = "member" >
No
< / label >
< / div >
< / div >
< / div >
< / div >
< div class = "field is-horizontal" >
< div class = "field-label is-normal" >
< label class = "label" > Subject< / label >
< / div >
< div class = "field-body" >
< div class = "field" >
< div class = "control" >
< input class = "input is-danger" type = "text" placeholder = "e.g. Partnership opportunity" >
< / div >
< p class = "help is-danger" >
This field is required
< / p >
< / div >
< / div >
< / div >
< div class = "field is-horizontal" >
< div class = "field-label is-normal" >
< label class = "label" > Question< / label >
< / div >
< div class = "field-body" >
< div class = "field" >
< div class = "control" >
< textarea class = "textarea" placeholder = "Explain how we can help you" > < / textarea >
< / div >
< / div >
< / div >
< / div >
< div class = "field is-horizontal" >
< div class = "field-label" >
<!-- Left empty for spacing -->
< / div >
< div class = "field-body" >
< div class = "field" >
< div class = "control" >
< button class = "button is-primary" >
Send message
< / button >
< / div >
< / div >
< / div >
< / div >
{% endcapture %}
{% capture field_label_example %}
< div class = "field is-horizontal" >
< div class = "field-label" >
< label class = "label" > No padding< / label >
< / div >
< div class = "field-body" >
< div class = "field" >
< div class = "control" >
< label class = "checkbox" >
< input type = "checkbox" >
Checkbox
< / label >
< / div >
< / div >
< / div >
< / div >
< div class = "field is-horizontal" >
< div class = "field-label is-small" >
< label class = "label" > Small padding< / label >
< / div >
< div class = "field-body" >
< div class = "field" >
< div class = "control" >
< input class = "input is-small" type = "text" placeholder = "Small sized input" >
< / div >
< / div >
< / div >
< / div >
< div class = "field is-horizontal" >
< div class = "field-label is-normal" >
< label class = "label" > Normal label< / label >
< / div >
< div class = "field-body" >
< div class = "field" >
< div class = "control" >
< input class = "input" type = "text" placeholder = "Normal sized input" >
< / div >
< / div >
< / div >
< / div >
< div class = "field is-horizontal" >
< div class = "field-label is-medium" >
< label class = "label" > Medium label< / label >
< / div >
< div class = "field-body" >
< div class = "field" >
< div class = "control" >
< input class = "input is-medium" type = "text" placeholder = "Medium sized input" >
< / div >
< / div >
< / div >
< / div >
< div class = "field is-horizontal" >
< div class = "field-label is-large" >
< label class = "label" > Large label< / label >
< / div >
< div class = "field-body" >
< div class = "field" >
< div class = "control" >
< input class = "input is-large" type = "text" placeholder = "Large sized input" >
< / div >
< / div >
< / div >
< / div >
{% endcapture %}
{% include subnav-form.html %}
< section class = "section" >
< div class = "container" >
< h1 class = "title" > Form controls< / h1 >
< h2 class = "subtitle" >
All generic < strong > form controls< / strong > , designed for consistency
< / h2 >
< hr >
< div class = "content" >
< p > The following form controls < strong > classes< / strong > are supported:< / p >
< ul >
< li > < code > .label< / code > < / li >
< li > < code > .input< / code > < / li >
< li > < code > .textarea< / code > < / li >
< li > < code > .select< / code > < / li >
< li > < code > .checkbox< / code > < / li >
< li > < code > .radio< / code > < / li >
< li > < code > .button< / code > < / li >
< li > < code > .help< / code > < / li >
< / ul >
< p > Each of them should be wrapped in a < code > .control< / code > container.< br >
When combining several controls in a < strong > form< / strong > , use the < code > .field< / code > class as a < strong > container< / strong > , to keep the spacing consistent.< / p >
< / div >
2017-10-09 17:13:02 +00:00
{% include snippet.html content=example more=true %}
2017-07-17 14:05:39 +00:00
2017-08-30 21:21:30 +00:00
{% include anchor.html name="Form field" %}
2017-07-17 14:05:39 +00:00
< div class = "content" >
< p > The < code > field< / code > container is a simple container for:< / p >
< ul >
< li > a text < code > label< / code > < / li >
< li > a form < code > control< / code > < / li >
< li > an optional < code > help< / code > text< / li >
< / ul >
< / div >
2017-08-30 21:21:30 +00:00
{% include snippet.html content=field_example %}
2017-07-17 14:05:39 +00:00
< div class = "content" >
< p > This container allows form fields to be < strong > spaced consistently< / strong > .< / p >
< / div >
2017-08-30 21:21:30 +00:00
{% include snippet.html content=fields_example %}
2017-07-17 14:05:39 +00:00
2017-08-30 21:21:30 +00:00
{% include anchor.html name="Form control" %}
2017-07-17 14:05:39 +00:00
< div class = "content" >
2017-07-17 14:51:22 +00:00
< p > The < code > control< / code > is a versatile container meant to < strong > enhance single form controls< / strong > . Because it has the same height as a control elements, it can < strong class = "has-text-danger" > only contain< / strong > the following elements:< / p >
2017-07-17 14:05:39 +00:00
< ul >
< li > < code > input< / code > < / li >
< li > < code > select< / code > < / li >
< li > < code > button< / code > < / li >
< li > < code > icon< / code > < / li >
< / ul >
< / div >
2017-08-30 21:21:30 +00:00
{% include snippet.html content=control_input_example %}
2017-07-17 14:05:39 +00:00
2017-08-30 21:21:30 +00:00
{% include snippet.html content=control_select_example %}
2017-07-17 14:05:39 +00:00
2017-08-30 21:21:30 +00:00
{% include snippet.html content=control_button_example %}
2017-07-17 14:05:39 +00:00
2017-07-17 14:51:22 +00:00
<!-- Font Awesome Icons -->
2017-08-30 21:21:30 +00:00
{% include anchor.html name="With icons" %}
2017-07-17 14:51:22 +00:00
< div class = "content" >
< p > You can append one of 2 < strong > modifiers< / strong > on a control:< / p >
< ul >
< li >
< code > has-icons-left< / code >
< / li >
< li >
and/or < code > has-icons-right< / code >
< / li >
< / ul >
< p > You also need to add a modifier on the < strong > icon< / strong > :< / p >
< ul >
< li >
< code > icon is-left< / code > if < code > has-icons-left< / code > is used
< / li >
< li >
< code > icon is-right< / code > if < code > has-icons-right< / code > is used
< / li >
< / ul >
< p > The size of the < strong > input< / strong > will define the size of the icon container.< / p >
< / div >
2017-08-30 21:21:30 +00:00
{% include snippet.html content=icons_example clipped=true %}
2017-07-17 14:51:22 +00:00
2017-08-30 21:21:30 +00:00
< div class = "content" >
< p >
You can append icons to < strong > select dropdowns< / strong > as well.
< / p >
2017-07-17 14:51:22 +00:00
< / div >
2017-08-30 21:21:30 +00:00
{% include snippet.html content=select_icons_example %}
2017-07-17 14:51:22 +00:00
2017-08-30 21:21:30 +00:00
< div class = "content" >
< p >
If the control contains an icon, Bulma will make sure the icon remains < strong > centered< / strong > , no matter the size of the input < em > or< / em > of the icon.
< / p >
2017-07-17 14:51:22 +00:00
< / div >
2017-08-30 21:21:30 +00:00
{% include snippet.html content=has_icons_small_example %}
2017-07-17 14:51:22 +00:00
2017-08-30 21:21:30 +00:00
{% include snippet.html content=has_icons_normal_example clipped=true %}
{% include snippet.html content=has_icons_medium_example clipped=true %}
{% include snippet.html content=has_icons_large_example clipped=true %}
{% include anchor.html name="Form addons" %}
2017-07-17 14:05:39 +00:00
< div class = "content" >
< p > If you want to < strong > attach controls< / strong > together, use the < code > has-addons< / code > modifier on the < code > field< / code > container:< / p >
< / div >
2017-08-30 21:21:30 +00:00
{% include snippet.html content=addons_example %}
2017-07-17 14:05:39 +00:00
< div class = "content" >
< p > You can attach inputs, buttons, and dropdowns < strong > only< / strong > .< / p >
< / div >
< div class = "content" >
< p > It can be useful to append a < a href = "{{site.url}}/documentation/elements/button#static-button" > static button< / a > .< / p >
< / div >
2017-08-30 21:21:30 +00:00
{% include snippet.html content=addons_static_example %}
2017-07-17 14:05:39 +00:00
< div class = "content" >
< p > Use the < code > is-expanded< / code > modifier on the element you want to fill up the remaining space (in this case, the input):< / p >
< / div >
2017-08-30 21:21:30 +00:00
2017-10-09 14:38:12 +00:00
{% include snippet.html content=addons_expanded_example horizontal=true more=true %}
2017-07-17 14:05:39 +00:00
< div class = "content" >
< p > If you want a full width select dropdown, pair < code > control is-expanded< / code > with < code > select is-fullwidth< / code > .< / p >
< / div >
2017-08-30 21:21:30 +00:00
{% include snippet.html content=addons_expanded_fullwidth_example %}
2017-07-17 14:05:39 +00:00
< div class = "content" >
2017-10-02 18:24:29 +00:00
< p > Use the < code > has-addons-centered< / code > or the < code > has-addons-right< / code > modifiers to alter the < strong > alignment< / strong > .< / p >
2017-07-17 14:05:39 +00:00
< / div >
2017-08-30 21:21:30 +00:00
{% include snippet.html content=addons_center_example %}
{% include snippet.html content=addons_right_example %}
{% include anchor.html name="Form group" %}
2017-07-17 14:05:39 +00:00
< div class = "content" >
< p >
If you want to < strong > group< / strong > controls together, use the < code > is-grouped< / code > modifier on the < code > field< / code > container.
2017-07-24 18:45:21 +00:00
< / p >
< / div >
2017-08-30 21:21:30 +00:00
{% include snippet.html content=group_example %}
2017-07-24 18:45:21 +00:00
< div class = "content" >
2017-10-02 18:24:29 +00:00
Use the < code > is-grouped-centered< / code > or the < code > is-grouped-right< / code > modifiers to alter the < strong > alignment< / strong > .
2017-07-17 14:05:39 +00:00
< / p >
2017-07-24 18:45:21 +00:00
< / div >
2017-08-30 21:21:30 +00:00
{% include snippet.html content=group_centered_example %}
2017-07-24 18:45:21 +00:00
2017-08-30 21:21:30 +00:00
{% include snippet.html content=group_right_example %}
2017-07-24 18:45:21 +00:00
< div class = "content" >
2017-07-17 14:05:39 +00:00
< p >
Add the < code > is-expanded< / code > modifier on the control element you want to < strong > fill up the remaining space< / strong > with.
< / p >
< / div >
2017-07-24 18:45:21 +00:00
2017-08-30 21:21:30 +00:00
{% include snippet.html content=group_expanded_example %}
2017-07-24 18:45:21 +00:00
< div id = "form-group-multiline" class = "content" >
< p >
Add the < code > is-grouped-multiline< / code > modifier to allow controls to fill up < strong > multiple lines< / strong > . This is ideal for a long list of controls.
< / p >
< / div >
2017-08-30 21:21:30 +00:00
{% include snippet.html content=group_multiline_example clipped=true %}
2017-07-17 14:05:39 +00:00
2017-10-17 10:53:44 +00:00
< div class = "message is-info" >
< div class = "message-header" >
< p > List of buttons< / p >
< / div >
< div class = "message-body" >
< div class = "content" >
< p >
If you only need a list of < em > buttons< / em > , try out the new < code > buttons< / code > class with which you can create a < a href = "{{ site.url }}/documentation/elements/button/#list-of-buttons" > multiline list of buttons< / a > .
< / p >
< / div >
< / div >
< / div >
2017-08-30 21:21:30 +00:00
{% include anchor.html name="Horizontal form" %}
2017-07-17 14:05:39 +00:00
< div class = "content" >
< p > If you want a < strong > horizontal< / strong > form control, use the < code > is-horizontal< / code > modifier on the < code > field< / code > container, in which you include:< / p >
< ul >
< li >
< code > field-label< / code > for the side label
< / li >
< li >
< code > field-body< / code > for the input/select/textarea container
< / li >
< / ul >
< p > You can use < code > is-grouped< / code > or < code > has-addons< / code > for the child elements.< / p >
< / div >
2017-08-30 21:21:30 +00:00
2017-10-09 14:38:12 +00:00
{% include snippet.html content=horizontal_form_example horizontal=true more=true %}
2017-07-17 14:05:39 +00:00
< div class = "content" >
< p >
To preserve the < strong > vertical alignment< / strong > of labels with each type and size of control, the < code > .field-label< / code > comes with < strong > 4 size modifiers< / strong > :
< / p >
< ul >
< li >
< code > .is-small< / code >
< / li >
< li >
< code > .is-normal< / code > for any < code > .input< / code > or < code > .button< / code >
< / li >
< li >
< code > .is-medium< / code >
< / li >
< li >
< code > .is-large< / code >
< / li >
< / ul >
< / div >
2017-08-30 21:21:30 +00:00
2017-10-09 14:38:12 +00:00
{% include snippet.html content=field_label_example horizontal=true more=true %}
2017-10-17 10:53:44 +00:00
2017-10-17 09:28:59 +00:00
{% include anchor.html name="Variables" %}
2017-10-09 09:36:14 +00:00
2017-10-17 09:28:59 +00:00
< div class = "content" >
< p >
Form elements can be < strong > customized< / strong > using the following generic variables. Simply set one or multiple of these variables < em > before< / em > importing Bulma. < a href = "{{ site.url }}/documentation/overview/customize/" > Learn how< / a > .
< / p >
< / div >
2017-10-09 09:36:14 +00:00
2017-10-17 09:28:59 +00:00
< table class = "table is-bordered" >
< thead >
< tr >
< th > Name< / th >
< th > Default value< / th >
< / tr >
< / thead >
< tfoot >
< tr >
< th > Name< / th >
< th > Default value< / th >
< / tr >
< / tfoot >
< tbody >
{% for key in page.variables_controls_keys %}
{% assign variable = site.data.variables.utilities.controls.vars[key] %}
< tr >
< td >
< code > {{ variable.name }}< / code >
< / td >
< td >
< code > {{ variable.value }}< / code >
< / td >
< / tr >
{% endfor %}
{% for key in page.variables_form_keys %}
{% assign variable = site.data.variables.elements.form.vars[key] %}
< tr >
< td >
< code > {{ variable.name }}< / code >
< / td >
< td >
< code > {{ variable.value }}< / code >
< / td >
< / tr >
{% endfor %}
< / tbody >
< / table >
2017-08-30 21:21:30 +00:00
2017-07-17 14:05:39 +00:00
< / div >
< / section >