docs: Add about value_template for float property (dext0r#434)

Alexandr2412 · Oct 26, 2023 · 3d95ae9 · 3d95ae9
1 parent 90aa9a8
commit 3d95ae9
Show file tree

Hide file tree

Showing 2 changed files with 21 additions and 2 deletions.
diff --git a/docs/devices/sensor/event.md b/docs/devices/sensor/event.md
@@ -48,7 +48,7 @@
 ### Источник состояния (объект) { id=property-value-state }
 > Параметры: `entity` и/или `attribute`
 
-Задают объект и/или его атрибут, в котором находится текущее состояние датчика. Нельзя использовать совместо с [`value_template`](#state-template).
+Задают объект и/или его атрибут, в котором находится текущее состояние датчика. Нельзя использовать совместо с [`value_template`](#property-value-template).
 
 !!! info "Описание"
     ```yaml

diff --git a/docs/devices/sensor/float.md b/docs/devices/sensor/float.md
@@ -51,7 +51,7 @@
 ### Источник состояния (объект) { id=property-value-state }
 > Параметры: `entity` и/или `attribute`
 
-Задают объект и/или его атрибут, в котором находится текущее состояние датчика. 
+Задают объект и/или его атрибут, в котором находится текущее состояние датчика. Нельзя использовать совместо с [`value_template`](#property-value-template).
 
 !!! info "Описание"
     ```yaml
@@ -74,6 +74,25 @@
               attribute: current_power
     ```
 
+### Источник состояния (шаблон) { id=property-value-template }
+> Параметр: `value_template`
+
+Задаёт шаблон для вычисления текущего состояние датчика. Нельзя использовать совместно с [`entity` и/или `attribute`](#property-value-state).
+
+Используйте в случаях, когда в УДЯ требуется получиться значение отличное от значения в HA, и для этого не хочется создавать дополнительный [датчик на шаблоне](https://www.home-assistant.io/integrations/template).
+
+!!! warning "Не рекомендуется использовать для конвертации из одних единиц измерения в другие [подробнее](#unit-conversion)"
+
+!!! info "Пример"
+    ```yaml
+    yandex_smart_home:
+      entity_config:
+        humidifier.room:
+          properties:
+            - type: temperature 
+              value_template: '{{ states("sensor.room_temperature") + 5 }}'
+    ```
+
 ### Единицы измерения в HA { id=property-unit-of-measurement }
 > Параметр: `unit_of_measurement`