mirror of
https://github.com/home-assistant/developers.home-assistant.git
synced 2025-11-17 15:00:20 +00:00
- to comply with MS Style Guide on [capitalization](https://learn.microsoft.com/en-us/style-guide/capitalization)
1.4 KiB
1.4 KiB
title, sidebar_label
| title | sidebar_label |
|---|---|
| Text entity | Text |
A text entity is an entity that allows the user to input a text value to an integration. Derive entity platforms from homeassistant.components.text.TextEntity
Properties
:::tip
Properties should always only return information from memory and not do I/O (like network requests). Implement update() or async_update() to fetch data or build a mechanism to push state updates to the entity class instance.
:::
| Name | Type | Default | Description |
|---|---|---|---|
| mode | string | text |
Defines how the text should be displayed in the UI. Can be text or password. |
| native_max | int | 100 | The maximum number of characters in the text value (inclusive). |
| native_min | int | 0 | The minimum number of characters in the text value (inclusive). |
| pattern | str | None |
A regex pattern that the text value must match to be valid. |
| native_value | str | Required | The value of the text. |
Other properties that are common to all entities such as icon, name etc are also applicable.
Methods
Set value
class MyTextEntity(TextEntity):
# Implement one of these methods.
def set_value(self, value: str) -> None:
"""Set the text value."""
async def async_set_value(self, value: str) -> None:
"""Set the text value."""