Add method to set zoom level

Author: stfnkth

docs/api/map.md

@@ -1,5 +1,5 @@
 # Map
 
-::: openlayers.map.Map
+::: openlayers.Map
 
-::: openlayers.anywidget.MapWidget
+::: openlayers.MapWidget

docs/concepts/controls.md

@@ -0,0 +1,9 @@
+# Map
+
+The [Map](../../api/map/#openlayers.Map) is the core component of your visualization, to which other components such as [controls](../controls), [layers](../layers) or overlays are added. Components can be added either during initialization or afterwards:
+
+```python
+-8<-- "concepts/basic_map.py"
+```
+
+The view state of the map ...

docs/concepts/layers.md

@@ -0,0 +1,11 @@
+import openlayers as ol
+
+# Add components during initialization
+m = ol.Map(controls=[ol.ZoomSliderControl()])
+
+# Add components after initialization
+m.add_control(ol.FullScreenControl())
+
+# m.add_view_call("setZoom", 5)
+m.set_zoom(5)
+m.save()

docs/concepts/map.md

@@ -33,7 +33,10 @@ markdown_extensions:
 
 nav:
   - Get started: index.md
-  # - Concepts: concept.md
+  - Concepts:
+      - Map: concepts/map.md
+      - Controls: concepts/controls.md
+      - Layers  and sources: concepts/layers.md
   - API documentation:
       - Map: api/map.md
       - Controls: api/controls.md

docs/examples/concepts/basic_map.py

@@ -52,6 +52,19 @@ def add_layer_call(self, layer_id: str, method_name: str, *args: Any):
         layer_call = dict(method=method_name, args=args)
         self.add_call("applyCallToLayer", layer_id, layer_call)
 
+    def add_view_call(self, method_name: str, *args: Any) -> None:
+        view_call = dict(method=method_name, args=args)
+        self.add_call("applyCallToView", view_call)
+    
+
+    def set_zoom(self, zoom_level: float | int) -> None:
+        """Set the zoom level ot the map view
+        
+        Args:
+            zoom_level (float | int): The zoom level of the view
+        """
+        self.add_view_call("setZoom", zoom_level)
+    
     def add_layer(self, layer: LayerT | LayerLike | dict) -> None:
         """Add a layer to the map
 
@@ -140,6 +153,8 @@ def set_style(self, layer_id: str, style: FlatStyle | dict) -> None:
 
         self.add_layer_call(layer_id, "setStyle", style)
 
+    def set_view(self, view: View) -> None: ...
+
     def to_html(self, **kwargs) -> str:
         """Render map to HTML"""
         data = self.map_options | dict(calls=self.calls)

mkdocs.yml

@@ -133,6 +133,15 @@ export default class MapWidget {
     this.fitBounds(exent);
   }
 
+  // --- View Methods
+  applyCallToView(call: OLAnyWidgetCall): void {
+    const view = this._map.getView();
+    console.log("run view method", view);
+
+    // @ts-expect-error
+    view[call.method](...call.args)
+  }
+
   // --- Layer methods
   getLayer(layerId: string): Layer | undefined {
     for (let layer of this._map.getLayers().getArray()) {