Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Document styling lines and polygons #1781

Merged
merged 1 commit into from
Jul 8, 2024
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
9 changes: 6 additions & 3 deletions docs/form-question-types.rst
Original file line number Diff line number Diff line change
Expand Up @@ -1094,10 +1094,13 @@ Choice properties

All of a choice's properties including ``geometry`` can be used in the rest of the form (see :ref:`referencing values in datasets <referencing-values-in-datasets>`) including in :ref:`choice filter <cascading-selects>` expressions. Even if the choices are specified from a GeoJSON file, the ``geometry`` property is made available to the form in :ref:`the ODK format <location-widgets>`, NOT as GeoJSON.

There are two special properties that can be used to style the marker for a ``Point`` choice:
There are special properties that can be used to style choices:

- **marker-color**: a valid long or short hex color code used to represent that marker's color (e.g. ``#aaccee`` or ``#ace``)
- **marker-symbol**: a single character used as that choice's marker (e.g. ``A`` or ``7`` or ``🏥`` or ``🟢``)
- **marker-color**: a valid long or short hex color representing the color of a marker (e.g. ``#aaccee`` or ``#ace``)
- **marker-symbol**: a single character displayed on a marker (e.g. ``A`` or ``7`` or ``🏥`` or ``🟢``)
Copy link
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The two first ones only apply to points, right? Maybe we should make that explicit. I can see someone expecting each vertex to have a marker or a symbol to show up in the middle of a polygon.

- **stroke**: a valid long or short hex color representing the color of a line or polygon (e.g. ``#aaccee`` or ``#ace``)
- **stroke-width**: a floating-point number (greater than or equal to 0) representing the width of a line or polygon (e.g. ``5`` or ``6.5``)
- **fill**: a valid long or short hex color representing the interior color of a polygon (e.g. ``#aaccee`` or ``#ace``)

If your geospatial data comes from an external source, you can :ref:`customize the label and underlying value <customizing-label-and-value>`.

Expand Down