---
title: "Perspective - Text Area"
description: "The Text Area component is suitable for multi-line text display and editing."
---

# Perspective - Text Area

> The Text Area component is suitable for multi-line text display and editing.

![](img1.png)

**Component Palette Icon**:  

![](img2.png)

## Description

Suitable for multi-line text display and editing. Will scroll vertically on demand. Horizontal scroll is determined by the "wrap" property. 

## Properties

Most Properties have binding options. For more information on Bindings, see [Types of Bindings in Perspective](ignition-modules/perspective/working-with-perspective-components/bindings-in-perspective/bindings-in-perspective.md).
This section only documents the Props Category of properties. The other Categories are described on the [Perspective Component Properties](ignition-modules/perspective/working-with-perspective-components/perspective-component-properties.md) page.

| Name                      | Description      | Property Type  |
| ------------------------- | -------------------- | -------------- |
| text                      | Text to display.   | value: string  |
| placeholder               | Text displayed when Text Area is empty.    | value: string  |
| enabled                   | If true, user is allowed to alter text.  | value: boolean |
| deferUpdates              | When true, updates to props.text will be deferred until focus is lost or enter is pressed.  | value: boolean |
| rejectUpdatesWhileFocused | When true, props.text will not accept updates from external sources while focused.       | value: boolean |
| resize                    | Sets whether text is resizable, and if so, in which direction: none, both, horizontal, or vertical.   | value: string  |
| wrap                      | Specifies how to wrap text: hard, soft, or off. (Soft wrap is the break resulting from a line wrap or word wrap. Hard wrap is an intentional break, which moves text to the next line, or creates a new paragraph).  | value: string  |
| style                     | Sets a style for this component. Full menu of [style options](appendix/reference-pages/style-reference.md) is available for text, background, margin and padding, border, shape and miscellaneous. You can also specify a [style class](ignition-modules/perspective/styles/style-classes/style-classes.md). | object         |
| spellcheck                | When true, text containing potential spelling errors will be underlined in red while the text is being edited in a launched session. Be aware there may be some slight behavioral differences in spellcheck error detection depending on the session browser. | value: boolean |

## Component Events

The [Perspective Event Types Reference](appendix/reference-pages/perspective-event-types-reference.md) page describes all the possible component event types for Perspective components. Not all component events support each Perspective component. The [Component Events and Actions](ignition-modules/perspective/working-with-perspective-components/component-events-and-actions.md) page shows how to configure events and actions on a Perspective component. Component scripting is handled separately and can be accessed from the Component menubar or by right clicking on the component.

## Example

![](img3.png)

This example shows the Text Area in two states: the top image is with text entered and the bottom image is without text entered. 

|Property|Value|
|--|--|
|props.text	|Data Point 01: xy4, zBeta 3Data Point 02: xy12, zBeta 45Notes: Example of how a longer sentence can wrap (or not) around to the next line. Enter was pressed between each of these three lines.|
|props.placeholder	|Lab Data Entry|
|props.wrap|	off|