Skip to main content

文本实体

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

属性

tip

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

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

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

方法

设置值

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

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

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