JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 307804
  • Score
    100M100P100Q182022F
  • License MIT

Text input component for Ink

Package Exports

  • ink-text-input

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (ink-text-input) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

ink-text-input Build Status

Text input component for Ink.

Install

$ npm install ink-text-input

Usage

import React from 'react';
import {render, Box} from 'ink';
import TextInput from 'ink-text-input';

class SearchQuery extends React.Component {
    constructor() {
        super();

        this.state = {
            query: ''
        };

        this.handleChange = this.handleChange.bind(this);
    }

    render() {
        return (
            <Box>
                <Box marginRight={1}>
                    Enter your query:
                </Box>

                <TextInput
                    value={this.state.query}
                    onChange={this.handleChange}
                />
            </Box>
        );
    }

    handleChange(query) {
        this.setState({query});
    }
}

render(<SearchQuery/>);

Props

value

Type: string

Value to display in a text input.

placeholder

Type: string

Text to display when value is empty.

showCursor

Type: boolean
Default: false

Whether to show cursor and allow navigation inside text input with arrow keys.

highlightPastedText

Type: boolean
Default: false

Highlight pasted text.

mask

Type: string

Replace all chars and mask the value. Useful for password inputs.

<TextInput
    value="Hello"
    mask="*"
/>
//=> "*****"

onChange

Type: Function

Function to call when value updates.

onSubmit

Type: Function

Function to call when Enter is pressed, where first argument is a value of the input.

Uncontrolled usage

This component also exposes an uncontrolled version, which handles value changes for you. To receive the final input value, use onSubmit prop.

import React from 'react';
import {render, Box} from 'ink';
import {UncontrolledTextInput} from 'ink-text-input';

const SearchQuery = () => {
    const handleSubmit = query => {
        // Do something with query
    };
    
    return (
        <Box>
            <Box marginRight={1}>
                Enter your query:
            </Box>

            <UncontrolledTextInput onSubmit={handleSubmit}/>
        </Box>
    );
};

render(<SearchQuery/>);

License

MIT © Vadim Demedes