Skip to main contentCarbon Design System

Select

Vanilla JS
React Angular Vue CodePen
Code:
<!--
  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>
      <div class="bx--select-input__wrapper" >
        <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 focusable="false" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" class="bx--select__arrow" width="16" height="16" viewBox="0 0 16 16" aria-hidden="true"><path d="M8 11L3 6 3.7 5.3 8 9.6 12.3 5.3 13 6z"></path></svg>
      </div>
    </div>
  </div>
</div>

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

          <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 focusable="false" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" class="bx--select__arrow" width="16" height="16" viewBox="0 0 16 16" aria-hidden="true"><path d="M8 11L3 6 3.7 5.3 8 9.6 12.3 5.3 13 6z"></path></svg>
      </div>
    </div>
  </div>
</div>
Optional helper text.
Optional helper text.
Vanilla JS
React Vue CodePen
Code:
<!--
  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>
    <div class="bx--form__helper-text">Optional helper text.</div>
      <div class="bx--select-input__wrapper" >
        <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 focusable="false" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" class="bx--select__arrow" width="16" height="16" viewBox="0 0 16 16" aria-hidden="true"><path d="M8 11L3 6 3.7 5.3 8 9.6 12.3 5.3 13 6z"></path></svg>
      </div>
    </div>
  </div>
</div>

<div class="bx--form-item">
  <div
    class="bx--select bx--select--disabled">
    <label for="select-id-disabled" class="bx--label bx--label--disabled">Select
      label</label>
    <div class="bx--form__helper-text">Optional helper text.</div>
      <div class="bx--select-input__wrapper" >
        <select id="select-id-disabled" class="bx--select-input" disabled>

          <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 focusable="false" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" class="bx--select__arrow" width="16" height="16" viewBox="0 0 16 16" aria-hidden="true"><path d="M8 11L3 6 3.7 5.3 8 9.6 12.3 5.3 13 6z"></path></svg>
      </div>
    </div>
  </div>
</div>
Validation message here
Validation message here
Vanilla JS
React Vue CodePen
Code:
<!--
  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--invalid">
    <label for="select-id" class="bx--label">Select label</label>
      <div class="bx--select-input__wrapper" data-invalid>
        <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 focusable="false" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" class="bx--select__arrow" width="16" height="16" viewBox="0 0 16 16" aria-hidden="true"><path d="M8 11L3 6 3.7 5.3 8 9.6 12.3 5.3 13 6z"></path></svg>
        <svg focusable="false" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" class="bx--select__invalid-icon" width="16" height="16" viewBox="0 0 16 16" aria-hidden="true"><path d="M8,1C4.2,1,1,4.2,1,8s3.2,7,7,7s7-3.1,7-7S11.9,1,8,1z M7.5,4h1v5h-1C7.5,9,7.5,4,7.5,4z M8,12.2	c-0.4,0-0.8-0.4-0.8-0.8s0.3-0.8,0.8-0.8c0.4,0,0.8,0.4,0.8,0.8S8.4,12.2,8,12.2z"></path><path d="M7.5,4h1v5h-1C7.5,9,7.5,4,7.5,4z M8,12.2c-0.4,0-0.8-0.4-0.8-0.8s0.3-0.8,0.8-0.8	c0.4,0,0.8,0.4,0.8,0.8S8.4,12.2,8,12.2z" data-icon-path="inner-path" opacity="0"></path></svg>
      </div>
      <div class="bx--form-requirement">
        Validation message here
      </div>
    </div>
  </div>
</div>

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

          <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 focusable="false" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" class="bx--select__arrow" width="16" height="16" viewBox="0 0 16 16" aria-hidden="true"><path d="M8 11L3 6 3.7 5.3 8 9.6 12.3 5.3 13 6z"></path></svg>
      </div>
      <div class="bx--form-requirement">
        Validation message here
      </div>
    </div>
  </div>
</div>
Vanilla JS
React Angular Vue CodePen
Code:
<!--
  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>
    <div class="bx--select-input--inline__wrapper">
      <div class="bx--select-input__wrapper" >
        <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 focusable="false" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" class="bx--select__arrow" width="16" height="16" viewBox="0 0 16 16" aria-hidden="true"><path d="M8 11L3 6 3.7 5.3 8 9.6 12.3 5.3 13 6z"></path></svg>
      </div>
    </div>
  </div>
</div>

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

          <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 focusable="false" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" class="bx--select__arrow" width="16" height="16" viewBox="0 0 16 16" aria-hidden="true"><path d="M8 11L3 6 3.7 5.3 8 9.6 12.3 5.3 13 6z"></path></svg>
      </div>
    </div>
  </div>
</div>
Optional helper text.
Optional helper text.
Vanilla JS
React Vue CodePen
Code:
<!--
  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>
    <div class="bx--select-input--inline__wrapper">
      <div class="bx--select-input__wrapper" >
        <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 focusable="false" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" class="bx--select__arrow" width="16" height="16" viewBox="0 0 16 16" aria-hidden="true"><path d="M8 11L3 6 3.7 5.3 8 9.6 12.3 5.3 13 6z"></path></svg>
      </div>
    </div>
    <div class="bx--form__helper-text">Optional helper text.</div>
  </div>
</div>

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

          <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 focusable="false" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" class="bx--select__arrow" width="16" height="16" viewBox="0 0 16 16" aria-hidden="true"><path d="M8 11L3 6 3.7 5.3 8 9.6 12.3 5.3 13 6z"></path></svg>
      </div>
    </div>
    <div class="bx--form__helper-text">Optional helper text.</div>
  </div>
</div>

Inline select invalid

Validation message here
Validation message here
Vanilla JS
React Vue CodePen
Code:
<!--
  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 bx--select--invalid">
    <label for="select-id" class="bx--label">Select label</label>
    <div class="bx--select-input--inline__wrapper">
      <div class="bx--select-input__wrapper" data-invalid>
        <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 focusable="false" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" class="bx--select__arrow" width="16" height="16" viewBox="0 0 16 16" aria-hidden="true"><path d="M8 11L3 6 3.7 5.3 8 9.6 12.3 5.3 13 6z"></path></svg>
        <svg focusable="false" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" class="bx--select__invalid-icon" width="16" height="16" viewBox="0 0 16 16" aria-hidden="true"><path d="M8,1C4.2,1,1,4.2,1,8s3.2,7,7,7s7-3.1,7-7S11.9,1,8,1z M7.5,4h1v5h-1C7.5,9,7.5,4,7.5,4z M8,12.2	c-0.4,0-0.8-0.4-0.8-0.8s0.3-0.8,0.8-0.8c0.4,0,0.8,0.4,0.8,0.8S8.4,12.2,8,12.2z"></path><path d="M7.5,4h1v5h-1C7.5,9,7.5,4,7.5,4z M8,12.2c-0.4,0-0.8-0.4-0.8-0.8s0.3-0.8,0.8-0.8	c0.4,0,0.8,0.4,0.8,0.8S8.4,12.2,8,12.2z" data-icon-path="inner-path" opacity="0"></path></svg>
      </div>
      <div class="bx--form-requirement">
        Validation message here
      </div>
    </div>
  </div>
</div>

<div class="bx--form-item">
  <div
    class="bx--select bx--select--inline bx--select--invalid bx--select--disabled">
    <label for="select-id-disabled" class="bx--label bx--label--disabled">Select
      label</label>
    <div class="bx--select-input--inline__wrapper">
      <div class="bx--select-input__wrapper" data-invalid>
        <select id="select-id-disabled" class="bx--select-input" disabled>

          <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 focusable="false" preserveAspectRatio="xMidYMid meet" xmlns="http://www.w3.org/2000/svg" class="bx--select__arrow" width="16" height="16" viewBox="0 0 16 16" aria-hidden="true"><path d="M8 11L3 6 3.7 5.3 8 9.6 12.3 5.3 13 6z"></path></svg>
      </div>
      <div class="bx--form-requirement">
        Validation message here
      </div>
    </div>
  </div>
</div>
Edit this page on GitHub
Previous
Components: Search
Next
Select: Usage