Select

The HvSelect component is a form control for choosing an option from a list.

It aligns with the native <select> and <option> APIs, making it easy to integrate into forms.

Source Code

uikit-react-core

CountryPlease select a country

label

description

multiple

required

readOnly

disabled

<HvSelect 
  label="Country"
  description="Please select a country"
  multiple={false}
  required={false}
  readOnly={false}
  disabled={false}
  placeholder="Select a value"
>
  <No Display Name label="America">
    <No Display Name value="ar">
      Argentina
    </No Display Name>
    <No Display Name value="us">
      United States
    </No Display Name>
  </No Display Name>
  <No Display Name label="Europe">
    <No Display Name value="bg">
      Belgium
    </No Display Name>
    <No Display Name value="pt">
      Portugal
    </No Display Name>
    <No Display Name value="pl">
      Poland
    </No Display Name>
    <No Display Name value="sp">
      Spain
    </No Display Name>
  </No Display Name>
</HvSelect>

<HvSelect 
  label="Country"
  description="Please select a country"
  multiple={false}
  required={false}
  readOnly={false}
  disabled={false}
  placeholder="Select a value"
>
  <No Display Name label="America">
    <No Display Name value="ar">
      Argentina
    </No Display Name>
    <No Display Name value="us">
      United States
    </No Display Name>
  </No Display Name>
  <No Display Name label="Europe">
    <No Display Name value="bg">
      Belgium
    </No Display Name>
    <No Display Name value="pt">
      Portugal
    </No Display Name>
    <No Display Name value="pl">
      Poland
    </No Display Name>
    <No Display Name value="sp">
      Spain
    </No Display Name>
  </No Display Name>
</HvSelect>

If you need a search filter or multi-select checkboxes, consider using HvDropdown instead.

Options

In addition to HvOption children, HvSelect also supports an options prop—an array of objects with value and label. For more flexibility (e.g., using HvOptionGroup or custom rendering), use HvOption as children instead.

CountryPlease select a country

<HvSelect
  label="Country"
  description="Please select a country"
  placeholder="Select a value"
  options={[
    { value: "ar", label: "Argentina" },
    { value: "bg", label: "Belgium" },
    { value: "pt", label: "Portugal" },
    { value: "pl", label: "Poland" },
    { value: "sp", label: "Spain", disabled: true },
    { value: "us", label: "United States" },
  ]}
/>

<HvSelect
  label="Country"
  description="Please select a country"
  placeholder="Select a value"
  options={[
    { value: "ar", label: "Argentina" },
    { value: "bg", label: "Belgium" },
    { value: "pt", label: "Portugal" },
    { value: "pl", label: "Poland" },
    { value: "sp", label: "Spain", disabled: true },
    { value: "us", label: "United States" },
  ]}
/>

Form

To use HvSelect in a form, provide a name prop.
By default, the submitted value will be the selected option’s value, or a JSON string of selected values in multi-select mode. You can customize the submitted value using the getSerializedValue prop.

<form
  onSubmit={(evt) => {
    evt.preventDefault();
    const formData = new FormData(evt.currentTarget);
    alert(JSON.stringify(Object.fromEntries(formData)));
  }}
>
  <HvSelect
    multiple
    required
    name="countries"
    label="Country"
    description="Select your favorite countries"
    placeholder="Select countries"
    getSerializedValue={(values) => values.map((v) => v.value).join(",")}
    options={[
      { value: "ar", label: "Argentina" },
      { value: "bg", label: "Belgium" },
      { value: "pt", label: "Portugal" },
      { value: "pl", label: "Poland" },
      { value: "sp", label: "Spain" },
      { value: "us", label: "United States" },
    ]}
  />
  <br />
  <HvButton type="submit" variant="secondarySubtle">
    Submit
  </HvButton>
</form>

<form
  onSubmit={(evt) => {
    evt.preventDefault();
    const formData = new FormData(evt.currentTarget);
    alert(JSON.stringify(Object.fromEntries(formData)));
  }}
>
  <HvSelect
    multiple
    required
    name="countries"
    label="Country"
    description="Select your favorite countries"
    placeholder="Select countries"
    getSerializedValue={(values) => values.map((v) => v.value).join(",")}
    options={[
      { value: "ar", label: "Argentina" },
      { value: "bg", label: "Belgium" },
      { value: "pt", label: "Portugal" },
      { value: "pl", label: "Poland" },
      { value: "sp", label: "Spain" },
      { value: "us", label: "United States" },
    ]}
  />
  <br />
  <HvButton type="submit" variant="secondarySubtle">
    Submit
  </HvButton>
</form>

Controlled

The value and open states of HvSelect can be controlled by using the value/onChange and open/onOpenChange props respectively.

import { useState } from "react";


export default function Demo() {
  const [selection, setSelection] = useState<string[]>([]);
  const [open, setOpen] = useState(false);


  const anySelected = selection.length > 0;


  return (
    <>
      <HvSelect
        multiple
        required
        open={open}
        name="countries"
        aria-label="Country"
        placeholder="Select countries"
        value={selection}
        style={{ width: 300 }}
        onChange={(evt, val) => setSelection(val)}
        onOpenChange={setOpen}
      >
        {options.map(({ value, label, flag }) => (
          <HvOption key={value} value={value} label={label}>
            {`${flag} ${label}`}
          </HvOption>
        ))}
      </HvSelect>
      <HvButton
        style={{ width: 120 }}
        variant="secondarySubtle"
        onClick={() => {
          setSelection(anySelected ? [] : options.map((o) => o.value));
        }}
      >
        {anySelected ? "Deselect all" : "Select all"}
      </HvButton>
    </>
  );
}


const options = [
  { value: "ar", label: "Argentina", flag: "🇦🇷" },
  { value: "bg", label: "Belgium", flag: "🇧🇪" },
  { value: "pt", label: "Portugal", flag: "🇵🇹" },
  { value: "pl", label: "Poland", flag: "🇵🇱" },
  { value: "sp", label: "Spain", flag: "🇪🇸" },
  { value: "us", label: "United States", flag: "🇺🇸" },
];

import { useState } from "react";

export default function Demo() {
  const [selection, setSelection] = useState<string[]>([]);
  const [open, setOpen] = useState(false);

  const anySelected = selection.length > 0;

  return (
    <>
      <HvSelect
        multiple
        required
        open={open}
        name="countries"
        aria-label="Country"
        placeholder="Select countries"
        value={selection}
        style={{ width: 300 }}
        onChange={(evt, val) => setSelection(val)}
        onOpenChange={setOpen}
      >
        {options.map(({ value, label, flag }) => (
          <HvOption key={value} value={value} label={label}>
            {`${flag} ${label}`}
          </HvOption>
        ))}
      </HvSelect>
      <HvButton
        style={{ width: 120 }}
        variant="secondarySubtle"
        onClick={() => {
          setSelection(anySelected ? [] : options.map((o) => o.value));
        }}
      >
        {anySelected ? "Deselect all" : "Select all"}
      </HvButton>
    </>
  );
}

const options = [
  { value: "ar", label: "Argentina", flag: "🇦🇷" },
  { value: "bg", label: "Belgium", flag: "🇧🇪" },
  { value: "pt", label: "Portugal", flag: "🇵🇹" },
  { value: "pl", label: "Poland", flag: "🇵🇱" },
  { value: "sp", label: "Spain", flag: "🇪🇸" },
  { value: "us", label: "United States", flag: "🇺🇸" },
];

Section Selection List

Select

Options

Form

Controlled

Related components