diff --git a/docs/img/web-forms/geoshape.png b/docs/img/web-forms/geoshape.png new file mode 100644 index 000000000..dc82df64e --- /dev/null +++ b/docs/img/web-forms/geoshape.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:0807273d325b5410520126e5353271e8531d0b3b4572d195539e90be3f2fb774 +size 2208736 diff --git a/docs/img/web-forms/geotrace.png b/docs/img/web-forms/geotrace.png new file mode 100644 index 000000000..70fbb4b8b --- /dev/null +++ b/docs/img/web-forms/geotrace.png @@ -0,0 +1,3 @@ +version https://git-lfs.github.com/spec/v1 +oid sha256:eabec39687d7d0979702e7ebd50ba8b0b9a97d2a43ccdfab6743d26ac080ec28 +size 1532671 diff --git a/docs/web-forms-intro.rst b/docs/web-forms-intro.rst index e4c72d9e7..e802746b0 100644 --- a/docs/web-forms-intro.rst +++ b/docs/web-forms-intro.rst @@ -46,17 +46,13 @@ Question types To know which question types are currently supported in Web Forms, see `the Github feature matrix `_. While most supported functionality is very similar to Collect's, this section describes question types with more complex functionality or that differ from Collect. -Web Forms currently supports 3 geo question types and appearances: +Web Forms currently supports 5 geo question types and appearances: * :ref:`Geopoint ` * :ref:`Maps appearance ` * :ref:`Placement-map appearance ` - -**Coming soon** - -- Geoshape -- Geotrace -- Editing all map appearances +* :ref:`Geoshape ` +* :ref:`Geotrace ` Geopoint without appearance ~~~~~~~~ @@ -95,6 +91,30 @@ For both `maps` and `placement-map` appearances, location capture stops when the .. image:: /img/web-forms/geopoint-placement-map-appearance.* :alt: Web forms geopoint with placement-map appearance +Geoshape +~~~~~~~~ + +The geoshape question type allows users to capture a polygon area on a map by adding at least three points to form a closed shape. + +The status bar shows `No points saved` when having fewer than 3 points. Long-press to add points; the shape closes automatically and auto-saves, updating the status bar (e.g., `4 points saved`). The last point is highlighted in a darker tone, and it’s larger. Long-press to drag and move points. + +Select the shape to delete entirely (with confirmation); select a vertex to delete it (no confirmation). Tap off the shape to deselect. Undo reverts the last change. + +.. image:: /img/web-forms/geoshape.* + :alt: Web forms geoshape + +Geotrace +~~~~~~~~ + +The geotrace question type allows users to capture a line on a map by adding at least two points. + +The status bar shows `No points saved` when having fewer than 2 points. Long-press to add points; auto-saves continuously, updating the status bar (e.g., `3 saved points`). The last point is highlighted in a darker tone, and it’s larger. Long-press to drag and move points. + +Select the trace to delete entirely (with confirmation); select a vertex to delete it (no confirmation). Tap off the line to deselect. Undo reverts the last change. + +.. image:: /img/web-forms/geotrace.* + :alt: Web forms geotrace + Image ~~~~~~~~