See what's coming soon with Carbon V10-beta.

Skip to main content
Select is a type of input that is used in forms, where a user is submitting data and chooses one option from a list.

Select

Vanilla JS

<!-- 
  Copyright IBM Corp. 2016, 2018

  This source code is licensed under the Apache-2.0 license found in the
  LICENSE file in the root directory of this source tree.
-->

<div class="bx--form-item">
  <div class="bx--select">
    <label for="select-id" class="bx--label">Select label</label>
    <select  id="select-id" class="bx--select-input">

          <option class="bx--select-option" value=""  disabled selected hidden>Choose an option </option>  
          <option class="bx--select-option" value="solong" >A much longer option that is worth having around to check how text flows </option>        <optgroup class="bx--select-optgroup" label="Category 1">
        <option class="bx--select-option" value="option1" >Option 1 </option>         <option class="bx--select-option" value="option2" >Option 2 </option>  </optgroup>        <optgroup class="bx--select-optgroup" label="Category 2">
        <option class="bx--select-option" value="option1" >Option 1 </option>         <option class="bx--select-option" value="option2" >Option 2 </option>  </optgroup>   </select>
 <svg class="bx--select__arrow"
          width="10" height="5" viewBox="0 0 10 5">
          <path d="M0 0l5 4.998L10 0z" fill-rule="evenodd" />
          </svg>
  </div>
</div>

Inline Select

Vanilla JS

<!-- 
  Copyright IBM Corp. 2016, 2018

  This source code is licensed under the Apache-2.0 license found in the
  LICENSE file in the root directory of this source tree.
-->

<div class="bx--form-item">
  <div class="bx--select bx--select--inline">
    <label for="select-id" class="bx--label">Select label</label>
    <select  id="select-id" class="bx--select-input">

          <option class="bx--select-option" value=""  disabled selected hidden>Choose an option </option>  
          <option class="bx--select-option" value="solong" >A much longer option that is worth having around to check how text flows </option>        <optgroup class="bx--select-optgroup" label="Category 1">
        <option class="bx--select-option" value="option1" >Option 1 </option>         <option class="bx--select-option" value="option2" >Option 2 </option>  </optgroup>        <optgroup class="bx--select-optgroup" label="Category 2">
        <option class="bx--select-option" value="option1" >Option 1 </option>         <option class="bx--select-option" value="option2" >Option 2 </option>  </optgroup>   </select>
 <svg class="bx--select__arrow"
          width="10" height="5" viewBox="0 0 10 5">
          <path d="M0 0l5 4.998L10 0z" fill-rule="evenodd" />
          </svg>
  </div>
</div>

Documentation

SCSS

Modifiers

Use these modifiers with .bx--select class.

Name Description
.bx--select--inline Selector for applying inline select styles
.bx--select--light Selector for applying light select styles

Inline Select width

The width of the inline select box should be the width of the default placeholder text + 16px/1rem of padding. There should be 10px of padding between the placeholder text and the caret.

Using Form Validation

Carbon Components provides HTML attributes and CSS to enable form validation for each input or control.

For example, here's a Select that provides a message if an option is not selected.

<div class="bx--form-item">
  <div class="bx--select">
    <select data-invalid id="select-id" class="bx--select-input"
      >...</select
    >
    ...
  </div>
  <svg class="bx--select__arrow" width="10" height="5" viewBox="0 0 10 5" fill-rule="evenodd">
    <path d="M10 0L5 5 0 0z"></path>
  </svg>
  <label for="select-id" class="bx--label">Select</label>
  <div class="bx--form-requirement">Please select an option.</div>
</div>

The bx--form-requirement element will be hidden until data-invalid attribute gets added to the select child of bx--select. Validate the select on your own and then use JavaScript to add the attribute if the select value is invalid.