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:

text

With datalist:

text with datalist

Cloneable:

text clone

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.
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().