Datalist
Datalist field renders a searchable Select 2 field. Handy when the number of options is rather big (e.g. A list of countries in a regular Select field may arguably not be a good UX). Supports multiple choice.
Example configuration
...
array(
'title' => 'My datalist field title',
'id' => 'first-datalist-option',
'desc' => 'Short description for the field',
'tab' => 'main',
'type' => 'datalist',
'options' => array(
array(
'name' => 'Name one',
'value' => 'Value one',
),
array(
'name' => 'Name two',
'value' => 'Value two',
),
array(
'name' => 'Name three',
'value' => 'Value three',
),
),
),
...
This will produce the following

Multiple choice
if 'multiple' => true
is added to the configuration object, the field will respect it. The following configuration
...
array(
'title' => 'My datalist field title',
'id' => 'first-datalist-option',
'desc' => 'Short description for the field',
'tab' => 'main',
'multiple' => true,
'type' => 'datalist',
'options' => array(
array(
'name' => 'Name one',
'value' => 'Value one',
),
array(
'name' => 'Name two',
'value' => 'Value two',
),
array(
'name' => 'Name three',
'value' => 'Value three',
),
),
),
...
will result in the following

Params
Name
Type
Description
type
string
datalist
(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)
Last updated