文本实体

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

特性

Tip

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

名称类型默认值说明
modestringtext定义文本在 UI 中的显示方式。可以是 textpassword
native_maxint100文本值中的最大字符数(含)。
native_minint0文本值中的最小字符数(含)。
patternstrNone文本值必须匹配才能有效的正则表达式模式。
native_valuestrRequired文本的价值。

所有实体共有的其他属性(例如 iconname 等)也适用。

方法

设定值

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."""