# Text Area

The **Text Area** **Object** allows the user to add multiline text with a background to their **Project**. It can be completely customized in the [**Attributes**](#attributes).

![Text Area.](https://4263346935-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLnh3x8s9fddWeG8TaAug%2Fuploads%2Fgit-blob-659b05757931f0d294d5de5527376649f43637a3%2Ftextareaimage120241.png?alt=media)

## Attributes

The **Object's** **Attributes** can be used to fully customize the **Object**. Explained below, they are:

* [**Transformation**](#transformation)
* [**Text Area**](#text-area)
* [**Text**](#text)
* [**Font**](#font)
* [**Style**](#style)
* [**Tag**](#tag)

### Transformation

![Transformation Attributes.](https://4263346935-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLnh3x8s9fddWeG8TaAug%2Fuploads%2Fgit-blob-c56603169ef4fa6a625d570a829c98a43f6f736d%2Ftextareaimage220232.png?alt=media)

The `Transformation` **Attributes** deal with placement, rotation, and size in *XY* space. More information can be found [here](https://docs.incari.com/incari-studio/2024.1/objects-and-types/attributes/common-attributes/transformation).

### Text Area

![Text Area Attributes.](https://4263346935-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLnh3x8s9fddWeG8TaAug%2Fuploads%2Fgit-blob-18d465c4779fcf814b14fbfc7f25ea70e1eab15b%2Ftextareatextareaatts20232.png?alt=media)

The `Text Area` **Attributes** provide crucial data for a **Text Area Object**.

There are two ways the `Text Area` Attribute can be incorporated in the **Object**. That is either as `Static Text` or `Translation`. This can be switched using the text or translation icons to the right, in that order.

![Static Text and Translation.](https://4263346935-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLnh3x8s9fddWeG8TaAug%2Fuploads%2Fgit-blob-981fcfec4b57d2dca4efa0b62b3bde4612b662f3%2Ftextvstranslation.png?alt=media)

#### Static Text

![Static Text Attributes.](https://4263346935-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLnh3x8s9fddWeG8TaAug%2Fuploads%2Fgit-blob-4cadfb9dd2e254f41d0b067fefc2a32356092da3%2Ftextareastatictext20241.png?alt=media)

When `Static Text` is selected, the **Attributes** are:

* `Text` is the text itself which will be displayed in the **Text Area**.
* `Word Wrap` can be enabled and disabled. When it is enabled, the text fits within the confines of the **Text Area**. If disabled, the text will be in one line and may run off the **Text Area**, causing some text to not be visible. In this case, please adjust the dimensions of the **Text Area**.

#### Translation

![Translation Attributes.](https://4263346935-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLnh3x8s9fddWeG8TaAug%2Fuploads%2Fgit-blob-f63ac098875ef77c3c72968fd96057d6c1fa28a6%2Ftextareatranslation20241.png?alt=media)

When `Translation` is selected, the **Attributes** are:

* `Translation` lets the user choose the key of the current language (which is established in the [**Project Settings**](https://docs.incari.com/incari-studio/2024.1/modules/project-settings/localization)). In the image above, the selected key is `phrase`.
* `Word Wrap` can be enabled and disabled. When it is enabled, the text fits within the confines of the **Text Area**. If disabled, the text will be in one line and may run off the **Text Area**, causing some text to not be visible. In this case, please adjust the dimensions of the **Text Area**.

### Text

![Text Attributes.](https://4263346935-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLnh3x8s9fddWeG8TaAug%2Fuploads%2Fgit-blob-7da5c8be6f089d1b0e70ea8bc17cb1c6566c34fa%2Ftextareatextatts20232.png?alt=media)

The **Text Attributes** offer the user options to customize the **Text**:

* `Line height (%)` determines the placement of the text within the text box.
* `Color` decides the color of the text.

### Font

![Font Attributes.](https://4263346935-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLnh3x8s9fddWeG8TaAug%2Fuploads%2Fgit-blob-3e22409b12ad8772b8611c540a17f3fa9a222213%2Ftextareafontatts20232.png?alt=media)

The **Font Attributes** offer the user options to customize the **Text Area's** font. Please note that while **Text Areas** are capable of handling [*variable fonts*](https://docs.incari.com/incari-studio/2024.1/modules/project-settings/fonts#variable-fonts), only the default style will be used, as the configurable **Attributes** are not available for this **Object**.

* `Family` offers two different font types: `Manrop` and `Source Code Pro`. More fonts can be added by the user in [**Project Settings**](https://docs.incari.com/incari-studio/2024.1/modules/project-settings/fonts).
* `Size` determines the size of the font in pixels.

### Style

![Style Attributes.](https://4263346935-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLnh3x8s9fddWeG8TaAug%2Fuploads%2Fgit-blob-770764d77504f7539e32a56b5e1a71850d7e87e0%2Ftextareastyleatts20232.png?alt=media)

The **Style Attributes** offer the user options to customize further visual aspects of the **Text Area**:

* The `Background Color` is the color of the **Text Area** box which appears behind the text.
* `CSS Classes` contain the *CSS* class names of the **Object**.
* `Stylesheet` contains the *CSS* stylesheet of the **Object**. This can override any stylesheet provided in the [**Project Settings**](https://docs.incari.com/incari-studio/2024.1/modules/project-settings/style) or a [**Scene2D**](https://docs.incari.com/incari-studio/2024.1/objects-and-types/project-objects/scene2d). To address these in the **Logic**, please refer to the [**Object 2D Nodes**](https://docs.incari.com/incari-studio/2024.1/toolbox/incari/object2d).

### Tag

![Tag Attributes.](https://4263346935-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FLnh3x8s9fddWeG8TaAug%2Fuploads%2Fgit-blob-dc4f375e34ce9bdd2bebc3e93ff34c8680ab55bb%2Fbuttonattstag.png?alt=media)

This **Attribute** manages the *tags* for the **Text Area**. See more on *tags* [here.](https://docs.incari.com/incari-studio/2024.1/objects-and-types/attributes/common-attributes/tag)
