# Open selection

## Availability

\[SINCE Orbeon Forms 2016.1]

## What it does

The `fr:open-select1` component presents:

* a list of radio buttons predefined by the form author
* and a custom choice ("Other") which the user has the option to specify instead

![Open selection component](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LEkBiSDvlXs3VWiO0Zu%2F-LEkBmMpnaxnftLGDglW%2F-LEkBzP3AfwSd3tEmF1D%2Fxbl-open-select1.png?generation=1528743336640214\&alt=media)

## Usage

You use `fr:open-select1` like a regular `xf:select1` control:

```markup
<fr:open-select1 id="flavor" bind="flavor-bind">
    <xf:label>Make your selection</xf:label>
    <xf:item>
        <xf:label>Chocolate</xf:label>
        <xf:value>chocolate</xf:value>
    </xf:item>
    <xf:item>
        <xf:label>Vanilla</xf:label>
        <xf:value>vanilla</xf:value>
    </xf:item>
    <xf:item>
        <xf:label>Strawberry</xf:label>
        <xf:value>strawberry</xf:value>
    </xf:item>
</fr:open-select1>
```

## Advanced usage

`fr:open-select1` supports the following attributes:

* `appearance`
  * `full`: shows radio buttons (the default)
  * `minimal`: shows a dropdown menu

This is the control with the `minimal` appearance:

![Open selection component with \`minimal\` appearance](https://4129616727-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LEkBiSDvlXs3VWiO0Zu%2F-LEkBmMpnaxnftLGDglW%2F-LEkBzP_G_bjtRbwEtmu%2Fxbl-open-select1-minimal.png?generation=1528743349603508\&alt=media)

## Data format

The predefined radio buttons have a *label* and a *value*, and, like all radio buttons, store their *value* into the data.

The text of the custom choice entered by the user is saved directly into the data.
