- The .file element is a simple interactive label that wraps an <input type="file">. It comprises several sub-elements:
+ The file element is a simple interactive label that wraps an <input type="file">. It comprises several sub-elements:
-
-
.filethe main container +filethe main container-
-
.file-labelthe actual interactive and clickable part of the element +file-labelthe actual interactive and clickable part of the element-
-
.file-inputthe native file input, hidden for styling purposes +file-inputthe native file input, hidden for styling purposes -
-
.file-ctathe upload call-to-action +file-ctathe upload call-to-action-
-
.file-iconan optional upload icon +file-iconan optional upload icon -
-
.file-labelthe "Choose a file…" text +file-labelthe "Choose a file…" text
-
-
-
-
.file-namea container for the chosen file name +file-namea container for the chosen file name
@@ -609,7 +609,7 @@ meta:
-
-
-
-
.is-small+is-small -
-
.is-medium+is-medium -
-
.is-large+is-large .label
- .input
- .textarea
- .select
- .checkbox
- .radio
- .button
- .help
+ label
+ input
+ textarea
+ select
+ checkbox
+ radio
+ button
+ help- + resize form controls + +
- + combine form controls into a group + +
- + combine form controls into a list + +
- + append and prepend icons to a form control + +
-
-
.is-small+is-small -
-
.is-normalfor any.inputor.button+is-normalfor anyinputorbutton -
-
.is-medium+is-medium -
-
.is-large+is-large type="text"type="password"type="email"type="tel"-
+
:hoverandis-hovered+
+ -
+
:focusandis-focused+
+ -
+
:activeandis-active+
+ -
+
:hoverandis-hovered+
+ -
+
:focusandis-focused+
+ -
+
:activeandis-active+
+
- With the
.has-namemodifier combined with the.file-nameelement, you can add a placeholder for the selected file name. + With thehas-namemodifier combined with thefile-nameelement, you can add a placeholder for the selected file name.@@ -625,7 +625,7 @@ meta:- You can move the CTA to the right side with the
.is-rightmodifier. + You can move the CTA to the right side with theis-rightmodifier.@@ -641,7 +641,7 @@ meta:- You can also expand the name to fill up the space with the
.is-fullwidthmodifier. + You can also expand the name to fill up the space with theis-fullwidthmodifier.@@ -657,7 +657,7 @@ meta:- You can have a boxed block with the
.is-boxedmodifier. + You can have a boxed block with theis-boxedmodifier.@@ -673,7 +673,7 @@ meta:{% endcapture %} +{% capture control_example %} +- You can combine
.has-nameand.is-boxed. + You can combinehas-nameandis-boxed.@@ -710,13 +710,13 @@ meta:diff --git a/docs/documentation/form/general.html b/docs/documentation/form/general.html index 77630862..be0b8791 100644 --- a/docs/documentation/form/general.html +++ b/docs/documentation/form/general.html @@ -106,6 +106,12 @@ variables_keys:+ ++{% endcapture %} + {% capture field_example %}@@ -807,23 +813,66 @@ variables_keys: {% endcapture %}{% endcapture %} +-+The following form controls classes are supported:
++ Bulma supports the following native HTML form elements:
+<form><button><input><textarea>and<label>. ++ The following CSS classes are supported: +
-
-
Each of them should be wrapped in a
.controlcontainer.
- When combining several controls in a form, use the.fieldclass as a container, to keep the spacing consistent.++ +{% include elements/anchor.html name="Complete form example" %} + {% include elements/snippet.html content=example more=true %} +{% include elements/anchor.html name="Form control" %} + ++ To maintain the design evenly balanced, Bulma provides a very useful
+controlcontainer with which you can wrap the form controls. +
+ When combining several controls in a form, use thefieldclass as a container, to keep the spacing consistent. +++ +{% include elements/snippet.html content=control_example %} + ++ The
+controlelement is a wrapper for form controls. It gives the possibility to: +-
+
++ {% include elements/anchor.html name="Form field" %}+ For the best results using Bulma, it's recommended to use the
+controlelement as often as possible. +@@ -1015,20 +1064,20 @@ variables_keys:diff --git a/docs/documentation/form/input.html b/docs/documentation/form/input.html index 18d362da..0243a07d 100644 --- a/docs/documentation/form/input.html +++ b/docs/documentation/form/input.html @@ -249,19 +249,23 @@ meta: {% endcapture %}- To preserve the vertical alignment of labels with each type and size of control, the
.field-labelcomes with 4 size modifiers: + To preserve the vertical alignment of labels with each type and size of control, thefield-labelcomes with 4 size modifiers:-The following modifiers are supported:
- -The following type attributes are supported:
++ The Bulma
inputCSS class is meant for<input">HTML elements. The following type attributes are supported: ++ Several modifiers are supported which affect: +
+diff --git a/docs/documentation/form/select.html b/docs/documentation/form/select.html index dea0d061..f90fc8ea 100644 --- a/docs/documentation/form/select.html +++ b/docs/documentation/form/select.html @@ -280,7 +280,22 @@ meta: {% endcapture %}@@ -319,10 +323,10 @@ meta:-+ +The following modifiers are supported:
++ The
+selectclass is a simple wrapper around the<select">HTML element, which gives the styling more flexibility and support for icons. +++ + -+ {{ select_example }} +++ {% highlight html %}{{ select_example }}{% endhighlight %} ++-- -- {{select_example}} --- {% highlight html %}{{select_example}}{% endhighlight %} --
- -Multiple select
+{% include elements/anchor.html name="Multiple select" %}@@ -308,10 +312,10 @@ meta: You can style a multiple select dropdown, by using the- {{select_multiple_example}} + {{ select_multiple_example }}is-multiplemodifier, and by using themultipleHTML attribute.- {% highlight html %}{{select_multiple_example}}{% endhighlight %} + {% highlight html %}{{ select_multiple_example }}{% endhighlight %}@@ -330,6 +334,12 @@ meta: {% include elements/new-tag.html version="0.6.2" %} +- {{colors_example}} + {{ colors_example }}- {% highlight html %}{{colors_example}}{% endhighlight %} + {% highlight html %}{{ colors_example }}{% endhighlight %}+++ You can create a rounded dropdown by appending the
+is-roundedmodifier: +{{ rounded_example }} @@ -341,62 +351,86 @@ meta: {% include elements/anchor.html name="Sizes" %} +- {{has_icons_small_example}} + {{ has_icons_small_example }}+++ The
+selectelement comes in 4 different sizes: +-- {{sizes_example}} + {{ sizes_example }}- {% highlight html %}{{sizes_example}}{% endhighlight %} + {% highlight html %}{{ sizes_example }}{% endhighlight %}
+{% include elements/anchor.html name="States" %} + ++-+ Bulma styles the different states of the
+selectelment. Each state is available as a pseudo-class and a CSS class: +-
+
+ This allows you to obtain the style of a certain state without having to trigger it. +
+States
Normal
+- {{normal_example}} + {{ normal_example }}- {% highlight html %}{{normal_example}}{% endhighlight %} + {% highlight html %}{{ normal_example }}{% endhighlight %}Hover
- {{hover_example}} + {{ hover_example }}- {% highlight html %}{{hover_example}}{% endhighlight %} + {% highlight html %}{{ hover_example }}{% endhighlight %}Focus
- {{focus_example}} + {{ focus_example }}- {% highlight html %}{{focus_example}}{% endhighlight %} + {% highlight html %}{{ focus_example }}{% endhighlight %}Loading
- -- {{loading_example}} + {{ loading_example }}- {% highlight html %}{{loading_example}}{% endhighlight %} + {% highlight html %}{{ loading_example }}{% endhighlight %}
+{% include elements/anchor.html name="With icons" %} -With icons
You can append the modifier on a control:
-
@@ -414,10 +448,10 @@ meta:
@@ -428,36 +462,36 @@ meta: If the control contains an icon, Bulma will make sure the icon remains centered, no matter the size of the input or of the icon.- {{icons_example}} + {{ icons_example }}- {% highlight html %}{{icons_example}}{% endhighlight %} + {% highlight html %}{{ icons_example }}{% endhighlight %}- {% highlight html %}{{has_icons_small_example}}{% endhighlight %} + {% highlight html %}{{ has_icons_small_example }}{% endhighlight %}- {{has_icons_normal_example}} + {{ has_icons_normal_example }}- {% highlight html %}{{has_icons_normal_example}}{% endhighlight %} + {% highlight html %}{{ has_icons_normal_example }}{% endhighlight %}- {{has_icons_medium_example}} + {{ has_icons_medium_example }}- {% highlight html %}{{has_icons_medium_example}}{% endhighlight %} + {% highlight html %}{{ has_icons_medium_example }}{% endhighlight %}diff --git a/docs/documentation/form/textarea.html b/docs/documentation/form/textarea.html index e7e071f2..b1f28478 100644 --- a/docs/documentation/form/textarea.html +++ b/docs/documentation/form/textarea.html @@ -132,6 +132,12 @@ meta:- {{has_icons_large_example}} + {{ has_icons_large_example }}- {% highlight html %}{{has_icons_large_example}}{% endhighlight %} + {% highlight html %}{{ has_icons_large_example }}{% endhighlight %}++ {% include elements/snippet.html content=textarea_example %} {% capture fixedsize_example %} @@ -142,7 +148,7 @@ meta:+ The Bulma
+textareaCSS class is the multiline version of theinputelement: +@@ -150,14 +156,46 @@ meta: {% include elements/anchor.html name="Colors" %} +- You can set the height of the textarea using the `rows` HTML attribute. + You can set the height of the textarea using the
rowsHTML attribute.++ {% include elements/snippet.html content=colors_example %} {% include elements/anchor.html name="Sizes" %} ++ The
+textareaelement is available in several colors: +++ {% include elements/snippet.html content=sizes_example %} {% include elements/anchor.html name="States" %} ++ The
+textareaelement comes in 4 different sizes: ++++ Bulma styles the different states of the
+textareaelment. Each state is available as a pseudo-class and a CSS class: +-
+
+ This allows you to obtain the style of a certain state without having to trigger it. +
+Normal
{% include elements/snippet.html content=normal_example %} @@ -209,4 +247,10 @@ meta:Fixed Size
+++ {% include elements/snippet.html content=fixedsize_example %}+ You can disable a
+textarearesizing by appending thehas-fixed-sizemodifier: + -
-