Improve longpress example for binary sensor (#5753)

* Improve longpress example for binary sensor

Replaced the Binary Sensor longpress example that needed an additional Template Binary Sensor, with a regular on_multi_click automation.

* Fix YAML indentation issue

Author: avbentem

content/components/binary_sensor/_index.md

@@ -268,8 +268,6 @@ binary_sensor:
 
 Configuration variables: See [Automation](/automations).
 
-See [`on_click`](#binary_sensor-on_click) for an example using a single button for both `on_click` and a continuous longpress.
-
 {{< anchor "binary_sensor-on_release" >}}
 
 ### `on_release`
@@ -376,43 +374,6 @@ Configuration variables:
 >         - switch.turn_on: relay_1
 > ```
 
-> [!NOTE]
-> A single button can be used to handle both `on_click` and a continuous longpress, by making a
-> [Template Binary Sensor](/components/binary_sensor/template/) follow a GPIO button with a delay:
->
-> ```yaml
-> binary_sensor:
->   - platform: gpio
->     id: button_1
->     # ...
->     on_click:
->       min_length: 50ms
->       max_length: 350ms
->       then:
->         - light.turn_on:
->             id: light_1
->             brightness: 10%
->
->   - platform: template
->     # ...
->     condition:
->       binary_sensor.is_on: button_1
->     filters:
->       - delayed_on: 1s
->     on_press:
->       - while:
->           condition:
->             # Using `!lambda: 'return true;'` would run endlessly
->             # once triggered, so repeat the outer condition
->             binary_sensor.is_on: button_1
->           then:
->             - light.dim_relative:
->                 id: light_1
->                 relative_brightness: 5%
->                 transition_length: 0.1s
->             - delay: 0.1s
-> ```
-
 {{< anchor "binary_sensor-on_double_click" >}}
 
 ### `on_double_click`
@@ -503,6 +464,40 @@ on_multi_click:
     - logger.log: "Single Short Clicked"
 ```
 
+While [`on_click`](#binary_sensor-on_click) only triggers on the falling edge of the signal,
+and [`on_double_click`](#binary_sensor-on_double_click) only on the second leading edge, an
+automation for `on_multi_click` can trigger at any time. For example, an `ON for at least`
+timing without an `OFF` does not await a falling edge. This supports implementing a
+continuous longpress, optionally also handling clicks for the very same sensor:
+
+```yaml
+binary_sensor:
+  - platform: gpio
+    id: button_1
+    # ...
+    on_multi_click:
+    # One can also replace this part with `on_click`
+    - timing:
+        - ON for at most 0.7s
+      then:
+        - light.turn_on:
+            id: light_1
+            brightness: 10%
+    - timing:
+        - ON for at least 1s
+      then:
+        - while:
+            condition:
+              # Self-reference this very sensor
+              binary_sensor.is_on: button_1
+            then:
+              - light.dim_relative:
+                  id: light_1
+                  relative_brightness: 5%
+                  transition_length: 0.1s
+              - delay: 0.1s
+```
+
 {{< anchor "binary_sensor-is_on_condition" >}}
 {{< anchor "binary_sensor-is_off_condition" >}}