Text

Improve this page

Overview

The text field creates a simple text input. You are able to enter any content or select a value from a predefined list via datalist option.

Screenshots

Default:

With datalist:

Cloneable:

Settings

Besides the common settings, this field has the following specific settings:

Name	Description
placeholder	Placeholder for the input. Optional.
size	Size of input box. Optional. Default 30.
prepend	Prepend text for the input.
append	Append text for the input.
datalist	Predefined values that users can select from (users still can enter text if they want). Optional. This parameter has the following sub-parameters:
	id: ID of the div that stores the options. Usually not used and auto-generated as {$field['id']_list. Useful if you have several text input with same datalist.
	options: Array of predefined values to select from.

Sample code

array(
    'name'        => 'Text',
    'label_description' => 'Label description',
    'id'          => 'text',
    'desc'        => 'Please enter some text above',
    'type'        => 'text',

    // Default value (optional)
    // 'std'         => 'Default text value',

    // Cloneable (i.e. have multiple value)?
    'clone'       => true,

    // Placeholder
    'placeholder' => 'Enter something here',

    // Input size
    'size'        => 30,

    // Datalist
    'datalist'    => array(
        // Unique ID for datalist. Optional.
        'id'      => 'text_datalist',
        // List of predefined options
        'options' => array(
            'What',
            'When',
            'Where',
            'Why',
            'Who',
        ),
    ),
),

Data

This field simply saves a single entered value in the database.

If the field is cloneable, then the value is stored as a serialized array in a single row in the database.

Template usage

If field is not cloneable:

$value = rwmb_meta( $field_id );
echo $value;

If field is cloneable:

$values = rwmb_meta( $field_id );
foreach ( $values as $value ) {
    echo $value;
}

Read more about rwmb_meta().

Improve this page