field-sizing
Limited availability
This feature is not Baseline because it does not work in some of the most widely-used browsers.
Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.
The field-sizing
CSS property enables you to control the sizing behavior of elements that are given a default preferred size, such as form control elements. This property enables you to override the default sizing behavior, allowing form controls to adjust in size to fit their contents.
This property is typically used to style text <input>
and <textarea>
elements to allow them to shrinkwrap their content as well as grow when more text is entered into the form control.
Syntax
/* Keyword values */
field-sizing: content;
field-sizing: fixed;
/* Global values */
field-sizing: inherit;
field-sizing: initial;
field-sizing: revert;
field-sizing: revert-layer;
field-sizing: unset;
Values
Description
field-sizing: content
overrides the default preferred sizing of form elements. This setting provides an easy way to configure text inputs to shrinkwrap their content and grow as more text is entered. They stop expanding when they reach maximum size limits (defined by the size of their containing element or set via CSS), at which point scrolling is required to view all the content.
Elements affected by field-sizing: content
Specifically, field-sizing
to content
affects the following elements:
- Form input types that accept direct text input from users. This includes
email
,number
,password
,search
,tel
,text
, andurl
types.- If no minimum width is set on the control, it will only be as wide as the text cursor.
- Controls with
placeholder
attributes will be rendered large enough to display the placeholder text. - The
size
attribute modifies the default preferred size of such<input>
elements. As a result,size
has no effect on<input>
elements withfield-sizing: content
set.
file
inputs. Direct text input is not possible; however, the displayed filename changes as the user selects a new file to upload. Whenfield-sizing: content
is set, the control will change size to shrinkwap the filename.<textarea>
controls. It is worth noting that<textarea>
elements withfield-sizing: content
set behave much like single-line text controls, with the following additions:- If
<textarea>
elements are unable to grow due to a width constraint, they will start to grow in height to display additional rows of content. When a height constraint is then reached, they will then start to show a scrollbar to allow all the content to be viewed. rows
andcols
attributes modify the default preferred size of a<textarea>
. As a result,rows
/cols
have no effect on<textarea>
elements withfield-sizing: content
set.
- If
<select>
controls. These behave a bit differently to what you might expect withfield-sizing: content
set. The effect depends on the type of<select>
control you are creating:- Regular drop-down boxes will change their width to always fit the displayed option value as new values are selected. (By default, the drop-down's size is set to be large enough to display the longest option value.)
- List boxes (
<select>
elements with themultiple
orsize
attribute) will be large enough to display all the options without needing to scroll. (By default, the drop-down box will require scrolling to view all the option values.) - The
size
attribute has very little effect on<select>
elements that havefield-sizing: content
set. In such cases, the browser checks if thesize
is equal to1
to determine whether the<select>
control should appear as a drop-down or a listbox. However, it will always display all the options of a listbox, even ifsize
is smaller than the number of options.
field-sizing
interaction with other size settings
The sizing flexibility provided to form controls by field-sizing: content
can be overridden if you use other CSS sizing properties. Avoid setting a fixed width
and height
when using field-sizing: content
because they will reimpose a fixed size on the control. However, using properties like min-width
and max-width
alongside field-sizing: content
is quite effective because they allow the control to grow and shrink with the entered text and also prevent the control from becoming too large or too small.
The maxlength
attribute causes the control to stop growing in size when the maximum character limit is reached.
Formal definition
Initial value | fixed |
---|---|
Applies to | Elements with default preferred size |
Inherited | no |
Computed value | as specified |
Animation type | discrete |
Formal syntax
field-sizing =
fixed |
content
Examples
Growing and shrinking text fields
This example illustrates the effect of field-sizing: content
on single- and multi-line text fields. The fields adjust their size as text is added or removed, effectively shrinkwrapping the contents, until a lower or upper size limit is reached.
HTML
The HTML in this example contains three form fields, each with an associated <label>
: two <input>
elements of types text
and email
and a <textarea>
element.
<div>
<label for="name">Enter name:</label>
<input type="text" id="name" maxlength="50" />
</div>
<div>
<label for="email">Enter email:</label>
<input type="email" id="email" maxlength="50" placeholder="e.g. a@b.com" />
</div>
<div>
<label for="comment">Enter comment:</label>
<textarea id="comment">This is a comment.</textarea>
</div>
Note the following points about the HTML:
- The first two fields have a
maxlength
attribute set, which stops the size of the field from increasing when the character limit is reached. - The
<textarea>
will grow in the inline direction until the edge of themin-width
constraint (set in the CSS code below) is reached, then start to add new lines in the block direction to contain subsequent characters. - The
email
input has a placeholder set. This causes the field to render big enough to show the entire placeholder. Once the field is focused and the user starts typing, the field changes size to themin-width
value. Thetext
field, which doesn't have a placeholder, renders initially atmin-width
.
CSS
In the CSS, we set field-sizing: content
on the three form fields, along with a min-width
and max-width
to constrain the input size. It is worth reiterating that, if no minimum width was set on the fields, they would be rendered only as wide as the text cursor.
We also give the <label>
s some rudimentary styling so that they sit neatly next to the fields.
input,
textarea {
field-sizing: content;
min-width: 50px;
max-width: 350px;
}
label {
width: 150px;
margin-right: 20px;
text-align: right;
}
Result
Try entering and removing text in the fields below to explore the effects of field-sizing: content
alongside other sizing properties.
Controlling <select>
element display
This example illustrates the effect of field-sizing: content
on <select>
elements, both drop-down menu types and multiline listbox types.
HTML
The HTML contains two sets of <select>
elements: one with field-sizing: content
applied, and one without, allowing you to see the difference (though the effect may be less obvious than on text fields). Each set includes one drop-down menu type and one multiline listbox type (with the multiple
attribute set).
<div class="field-sizing">
<h2>With <code>field-sizing: content</code></h2>
<select>
<option>Bananas</option>
<option>Strawberries</option>
<option selected>Apples</option>
<option>Raspberries</option>
<option>Pomegranate</option>
</select>
<select multiple>
<option>Bananas</option>
<option>Strawberries</option>
<option>Apples</option>
<option>Raspberries</option>
<option>Pomegranate</option>
</select>
</div>
<div>
<h2>Without <code>field-sizing: content</code></h2>
<select>
<option>Bananas</option>
<option>Strawberries</option>
<option selected>Apples</option>
<option>Raspberries</option>
<option>Pomegranate</option>
</select>
<select multiple>
<option>Bananas</option>
<option>Strawberries</option>
<option>Apples</option>
<option>Raspberries</option>
<option>Pomegranate</option>
</select>
</div>
Note: Best practice is to include a <label>
element for each form control, to associate a meaningful text description with each field for accessibility purposes (see Meaningful text labels for more information). We haven't done so in this example, as it focuses purely on aspects of the form controls' visual rendering, but you should make sure you include form labels in production code.
CSS
In the CSS, field-sizing: content
is set only on the first set of <select>
elements.
.field-sizing select {
field-sizing: content;
}
Result
Note the following effects of field-sizing: content
:
- The drop-down menu always fits the size of the displayed option, changing size as different options are selected. Without
field-sizing: content
, the size is fixed as wide as the longest option. - The multi-select list box displays all of the options at once. Without
field-sizing: content
, the user has to scroll the box to view all the options.
Specifications
Specification |
---|
CSS Basic User Interface Module Level 4 # field-sizing |
Browser compatibility
BCD tables only load in the browser