Update docs

Author: stfnkth

docs/api/styles.md

@@ -2,3 +2,4 @@
 
 ::: openlayers.styles.FlatStyle
 
+::: openlayers.styles.default_style

docs/concepts/layers.md

@@ -24,4 +24,25 @@ Sources state which data the map should display.
 
 ## Styles
 
-...
+Vector layers can be styled with a style object containing properties for _stroke_, _fill_, etc.:
+
+```python
+style = ol.FlatStyle(
+    stroke_color = "yellow",
+    stroke_width = 1.5,
+    fill_color = "orange" 
+)
+```
+
+It is also possible to use a simple dictonary instead. In this case property names must use hyphens instead
+of underscores:
+
+```python
+const style = {
+  "stroke-color": "yellow",
+  "stroke-width": 1.5,
+  "fill-color": "orange",
+}
+```
+
+> See [Styles API](../../api/styles/) and [ol/style/flat](https://openlayers.org/en/latest/apidoc/module-ol_style_flat.html) for details.

examples/standalone/layers/vector_image_layer.py

@@ -1,7 +1,6 @@
 # See https://openlayers.org/en/latest/examples/image-vector-layer.html
 
 import openlayers as ol
-# from openlayers.models.layers import VectorImageLayer
 
 data = "https://openlayers.org/data/vector/ecoregions.json"
 

src/openlayers/styles.py

@@ -15,11 +15,13 @@ def fix_keys(d: dict) -> dict:
 # TODO: Move to models folder
 # See https://openlayers.org/en/latest/apidoc/module-ol_style_flat.html
 class FlatStyle(BaseModel):
-    """Flat style
+    """A style object for vector layers
+
+    Underscores in the property names are automatically converted to hyphens.
 
     Note:
-        See [ol-apidoc/module-ol_style_flat](https://openlayers.org/en/latest/apidoc/module-ol_style_flat.html)
-        for all available style parameters.
+        See [ol/style/flat](https://openlayers.org/en/latest/apidoc/module-ol_style_flat.html)
+        for all available style properties.
     """
 
     model_config = ConfigDict(extra="allow")
@@ -54,6 +56,15 @@ def model_dump2(self) -> dict:
 
 
 def default_style(**kwargs) -> FlatStyle:
+    """Create a default style object for vector layers
+
+    Args:
+        **kwargs (Any): Additional style properties or
+            updates of the default properties
+
+    Returns:
+        A style object
+    """
     return FlatStyle(
         fill_color="rgba(255,255,255,0.4)",
         # ---
@@ -65,16 +76,3 @@ def default_style(**kwargs) -> FlatStyle:
         circle_stroke_width=1.25,
         circle_stroke_color="#3399CC",
     ).model_copy(update=kwargs)
-
-
-# class CircleStyle(FlatStyle): ...
-
-"""
-class IconStyle(FlatStyle):
-    icon_src: str | None = None
-    icon_color: str | None = None
-    icon_opacity: float | int | None = None
-    icon_scale: float | int | None = None
-"""
-
-# class FillStyle(FlatStyle): ...