# Taxonomy select

Taxonomy select field renders a searchable [Select 2](https://select2.github.io/) field. Similar to the [Datalist](https://docs.alchemy-options.com/v0.9/fields/datalist) field. Supports [multiple choice](#multiple-choice).

## Example configuration

```php
...
array(
    'title' => 'My taxonomy select field title',
    'id' => 'taxonomy-select-option',
    'desc' => 'Short description for the field',
    'tab' => 'main',
    'taxonomy' => 'category',
    'type' => 'taxonomy-select',
),
...
```

This will produce the following

![](https://2720448264-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LKMTiOPVR7pXWhebz7q%2Fsync%2Fadcb37e8ce50cfbbc7fab6906402d51b4c2ba3eb.png?generation=1602624632940903\&alt=media)

## Multiple choice

if `'multiple' => true` is added to the [configuration object](#example-configuration), the field will respect it. The following configuration

```php
...
array(
    'title' => 'My taxonomy select field title',
    'id' => 'taxonomy-select-option',
    'desc' => 'Short description for the field',
    'tab' => 'main',
    'taxonomy' => 'category',
    'multiple' => true,
    'type' => 'taxonomy-select',
),
...
```

will result in the following

![](https://2720448264-files.gitbook.io/~/files/v0/b/gitbook-legacy-files/o/assets%2F-LKMTiOPVR7pXWhebz7q%2Fsync%2F1dc091feebd38214da78209bd45de1277cd3eb5c.png?generation=1602624632884352\&alt=media)

## Params

| Name       | Type    | Description                                                                                                  |
| ---------- | ------- | ------------------------------------------------------------------------------------------------------------ |
| `type`     | string  | `taxonomy-select` **(required)**                                                                             |
| `id`       | string  | Unique ID that will be used to retrieve the value **(required)**                                             |
| `tab`      | string  | Specifies in which tab this option will be rendered                                                          |
| `title`    | string  | Shows a heading to the left of the field                                                                     |
| `desc`     | string  | Shows a description text (can have HTML)                                                                     |
| `multiple` | boolean | Set to `true` if multiple values are needed. See [an example](#multiple-choice) above.                       |
| `taxonomy` | string  | Taxonomy (standard or custom) to search the terms in. If not specified, searches in the `category` taxonomy. |