DestinationPicker

array keys are the picker handles, array values are PickerInterface instances

The field name

The list of picker handles. To pass options to the pickers use the handles as keys, and arrays for values.

The handle of the pre-selected picker

the value of the pre-selected picker

<code><pre>echo $app->make(DestinationPicker::class)->generate(
    'my_field',
    [
        'none',
        'page',
        'external_url' => ['maxlength' => 255],
        'file' => ['filters' => [['field' => 'type', 'type' => \Concrete\Core\File\Type\Type::T_IMAGE]]],
    ]
);</pre></code>

The field name

The list of picker handles. To pass options to the pickers use the handles as keys, and arrays for values.

A list to add errors to

The name of the field (used to describe errors)

An array containing the data to be decoded (if null, we'll use the POST data from the current request)

Returns two NULLs in case of errors, or the selected picker handle and its value otherwise

<code><pre>
$errors = $app->make('errors');
$dp = $app->make(DestinationPicker::class);
list($handle, $value) = $dp->decode(
    'my_field',
    [
        'none',
        'page',
        'external_url' => ['maxlength' => 255],
        'file',
    ],
    $errors,
    t('Destination')
);
</pre></code>
$handle and $value will be NULL if (and only if) errors occurred (added to the $errors parameter).