InputControl Edit

This feature is still experimental. “Experimental” means this is an early implementation subject to drastic and breaking changes.

InputControl components let users enter and edit text. This is an experimental component intended to (in time) merge with or replace TextControl.

Usage Usage

import { __experimentalInputControl as InputControl } from '@wordpress/components';
import { useState } from '@wordpress/compose';

const Example = () => {
    const [ value, setValue ] = useState( '' );

    return (
        <InputControl
            value={ value }
            onChange={ ( nextValue ) => setValue( nextValue ) }
        />
    );
};

Top ↑

Props Props

Top ↑

disabled disabled

If true, the input will be disabled.

  • Type: Boolean
  • Required: No
  • Default: false

Top ↑

isPressEnterToChange isPressEnterToChange

If true, the ENTER key press is required in order to trigger an onChange. If enabled, a change is also triggered when tabbing away (onBlur).

  • Type: Boolean
  • Required: No
  • Default: false

Top ↑

hideLabelFromVision hideLabelFromVision

If true, the label will only be visible to screen readers.

  • Type: Boolean
  • Required: No

Top ↑

label label

If this property is added, a label will be generated using label property as the content.

  • Type: String
  • Required: No

Top ↑

labelPosition labelPosition

The position of the label (top, side, bottom, or edge).

  • Type: String
  • Required: No

Top ↑

onChange onChange

A function that receives the value of the input.

  • Type: Function
  • Required: Yes

Top ↑

prefix prefix

Renders an element on the left side of the input.

  • Type: React.ReactNode
  • Required: No

Top ↑

size size

Adjusts the size of the input.
Sizes include: default, small

  • Type: String
  • Required: No
  • Default: default

Top ↑

suffix suffix

Renders an element on the right side of the input.

  • Type: React.ReactNode
  • Required: No

Top ↑

type type

Type of the input element to render. Defaults to “text”.

  • Type: String
  • Required: No
  • Default: “text”

Top ↑

value value

The current value of the input.

  • Type: String | Number
  • Required: Yes