ObjectUIObjectUI
Fields

Text Field

Single-line text input field for basic text entry

The Text Field component provides a single-line text input for collecting basic text data from users. It's the most commonly used field type for names, titles, and short text entries.

Basic Usage

Basic Text Field

With Placeholder

With Placeholder

Required Field

Required Field

Read-Only

Read Only Field

This value cannot be changed

Field Schema

interface TextFieldSchema {
  type: 'text';
  name: string;                  // Field name/ID
  label?: string;                // Field label
  placeholder?: string;          // Placeholder text
  value?: string;                // Default value
  required?: boolean;            // Is field required
  readonly?: boolean;            // Read-only mode
  disabled?: boolean;            // Disabled state
  className?: string;            // Additional CSS classes
  
  // Validation
  min_length?: number;           // Minimum character length
  max_length?: number;           // Maximum character length
  pattern?: string | RegExp;     // Validation pattern
}

Use Cases

  • User Names: Collecting first names, last names, or usernames
  • Titles: Post titles, document names, or product names
  • Short Text: Any short text input that doesn't require multiple lines
  • IDs: Custom identifiers or reference numbers

Cell Renderer

When used in data tables or grids, the text field is rendered as simple truncated text:

import { TextCellRenderer } from '@object-ui/fields';

// Automatically used for type: 'text' in grids/tables
// Displays value or '-' if empty

On this page