Input Unit

This allows you to input some text or numbers and also define a “unit” for that input, all within the same widget.

Input unit widget

The value will be stored as a serialized associative array containing the keys value and unit, e.g.

[
    'value' => 'Lorem ipsum', 
    'unit' => 'h2'
]

Options

This table only shows the options relevant to the core functionality of this widget. See the DCA reference for a full field reference. All options for the text widget are also relevant.

KeyValue
inputTypeinputUnit (string)
optionsarrayThese are the options available in the drop-down. You can also use an options_callback.
referencearrayOptional translation reference for the drop-down options.

Example

// ...
'headline' => [
    'exclude'   => true,
    'inputType' => 'inputUnit',
    'options' => ['h1', 'h2', 'h3', 'h4', 'h5', 'h6'],
    'eval'      => [
        'maxlength' => 200, 
        'basicEntities' => true, 
        'tl_class' => 'w50',
    ],
    'sql'       => [
        'type' => 'string',
        'length' => 255,
        'default' => 'a:2:{s:5:"value";s:0:"";s:4:"unit";s:2:"h2";}',
    ],
],

Usage in Contao

The input unit widget is mainly used for the headline input in content elements and modules. In the past it was also used in the deprecated style manager and for the deprecated margin options of content elements. In those cases the units were things like px, em, rem, etc.