From 9816fdb11be173855125ba1aadbfd1acfcc85fbf Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Rodrigo=20Gir=C3=A3o=20Serr=C3=A3o?=
 <5621605+rodrigogiraoserrao@users.noreply.github.com>
Date: Mon, 19 Dec 2022 18:45:38 +0000
Subject: [PATCH] Complete reference for column-span.

---
 docs/styles/grid/column_span.md | 41 +++++++++++++++++++++++++++++++++
 1 file changed, 41 insertions(+)

diff --git a/docs/styles/grid/column_span.md b/docs/styles/grid/column_span.md
index 4bf511a8c..00442fbd1 100644
--- a/docs/styles/grid/column_span.md
+++ b/docs/styles/grid/column_span.md
@@ -1 +1,42 @@
 # Column-span
+
+The `column-span` style specifies how many rows a widget will span in a grid layout.
+
+## Syntax
+
+```sass
+column-span: <INTEGER>
+```
+
+## Example
+
+The example below shows a 4 by 4 grid where many placeholders span over several columns.
+
+=== "Output"
+
+    ```{.textual path="docs/examples/styles/column_span.py"}
+    ```
+
+=== "column_span.py"
+
+    ```py
+    --8<-- "docs/examples/styles/column_span.py"
+    ```
+
+=== "column_span.css"
+
+    ```css
+    --8<-- "docs/examples/styles/column_span.css"
+    ```
+
+## CSS
+
+```sass
+column-span: 3
+```
+
+## Python
+
+```py
+widget.styles.column_span = 3
+```