[switch] Add control() method to API (#5506)

This is a copy of #5214, but in the new format.
That one should have been merged when esphome/esphome#10118 was merged, but for some reason it was missed.

Author: edwardtfn

content/components/switch/_index.md

@@ -182,7 +182,7 @@ advanced stuff (see the full API Reference for more info).
 >
 > For example, if you are using a {{< docref "/components/switch/gpio" >}}, calling `publish_state()` will
 > not change the GPIO pin level. To do that, you need to call `turn_on()`,
-> `turn_off()` or `toggle()`. The same applies to other switch platforms.
+> `turn_off()`, `toggle()` or `control()`. The same applies to other switch platforms.
 
 - `state`  : Retrieve the current state of the switch.
 
@@ -206,6 +206,16 @@ advanced stuff (see the full API Reference for more info).
     id(my_switch).toggle();
 ```
 
+- `control()`  : Control the switch state using a boolean parameter.
+  This provides a unified interface for setting switch state dynamically.
+
+```yaml
+    // Within lambda, control switch based on a condition
+    id(my_switch).control(true);   // Turn ON
+    id(my_switch).control(false);  // Turn OFF
+    id(my_switch).control(some_condition);  // Set based on condition
+```
+
 {{< anchor "switch-on_turn_on_off_trigger" >}}
 
 ### `switch.on_turn_on` / `switch.on_turn_off` Trigger