Skip to main content

文本实体

文本实体是允许用户向集成输入文本值的实体。从 homeassistant.components.text.TextEntity 派生实体平台。

属性​

tip

属性应该始终仅从内存中返回信息,而不能执行 I/O(例如网络请求)。实现 update() 或 async_update() 以获取数据,或构建机制推送状态更新到实体类实例。

名称类型默认值描述
modestringtext定义文本在 UI 中的显示方式。可以是 text 或 password。
native_maxint100文本值中的最大字符数(包括)。
native_minint0文本值中的最小字符数(包括)。
patternstrNone文本值必须匹配的正则表达式模式,以便有效。
native_valuestr必填文本的值。

其他适用于所有实体的属性,如 icon、name 等也适用。

方法​

设置值​

class MyTextEntity(TextEntity):
# 实现其中一个方法。

def set_value(self, value: str) -> None:
"""设置文本值。"""

async def async_set_value(self, value: str) -> None:
"""设置文本值。"""