diff --git a/src/layer/numbers/index.md b/src/layer/numbers/index.md index d7d41c5d..baf18da2 100644 --- a/src/layer/numbers/index.md +++ b/src/layer/numbers/index.md @@ -4,12 +4,15 @@ description: See how to set up Editable Range or Range Slider to record numbers # Numbers -Number fields can be handled by the **Range** widget that offers two options supported by the : [editable range](#range) and [slider](#slider). +Number fields, both *integers* and *decimal numbers*, can be handled by the **Range** widget that offers two options supported by the : [editable range](#range) and [slider](#slider). + +For decimal numbers, it can sometimes be useful to use the [Text edit](#text-edit) widget. |
Widget
|Preview in the | |:---:|:---:| | Editable range | ![Mergin Maps mobile app numeric field form](./mobile-form-number-editable-preview.jpg "Mergin Maps mobile app numeric field form") | | Slider | ![Mergin Maps mobile app slider field form](./mobile-form-number-slider-preview.jpg "Mergin Maps mobile app slider field form") | +| Decimal numbers - Text edit | ![Mergin Maps mobile app decimal field form](./mobile-form-decimal-preview.webp "Mergin Maps mobile app decimal field form") | :::tip Example project available This public project: uses various options for entering numbers. Download or clone it to see this setup. @@ -22,11 +25,19 @@ Prefer a video? Here is a short tutorial about number widgets: To set up the **editable range widget**: 1. Right-click on a layer, select **Properties** and go to the **Attributes form** tab. -2. In the list of **Available Widgets** select the integer field you want to work with (here: `numbers-range-editable`). -3. In the **Widget Type** tab the **Range** widget and the **Editable** option should be selected by default. If this is not the case, select these options from the drop-down menus. +2. In the list of **Available Widgets**, select the integer field you want to work with (here: `numbers-range-editable`). +3. In the **Widget Type** tab, select the **Range** widget with the **Editable** option. + + If needed, you can define the **Minimum**, **Maximum**, and **Step** values. + + ![QGIS number editable range field form](./qgis-form-number-range-editable.webp "QGIS number editable range field form") + + For *decimal numbers*, the **Precision** (the number of decimal digits) needs to be specified in the **Advanced Options** of the widget, so that the **Minimum**, **Maximum**, and **Step** values can be set as decimal numbers. + + ![QGIS decimal number editable range field form](./qgis-form-decimal-range-editable.webp "QGIS decimal number editable range field form") + 4. **Apply** the changes. Don't forget to save and sync your project! -![QGIS number editable range field form](./qgis-form-number-range-editable.jpg "QGIS number editable range field form") In the , the numbers can be entered manually or by using the +/- buttons: @@ -36,16 +47,35 @@ In the , the numbers can be entered manually or by using t To set up the **Slider**: 1. Right-click on a layer, select **Properties** and go to the **Attributes form** tab. -2. In the list of **Available Widgets** select the numeric field you want to work with (here: `numbers-range-slider`). -3. In the **Widget Type** tab: - - the **Range** widget should be selected by default (if not, select it from the menu) - - set the edit widget to **Slider** - - set the **Minimum**, **Maximum** and **Step** values of the slider -4. **Apply** the changes. Don't forget to save and sync your project! +2. In the list of **Available Widgets**, select the numeric field you want to work with (here: `numbers-range-slider`). +3. In the **Widget Type** tab, select the **Range** widget with the **Slider** option. -![QGIS number range field form](./qgis-form-number-range-slider.jpg "QGIS number range field form") + Set the **Minimum**, **Maximum**, and **Step** values of the slider as needed. + + ![QGIS number range field form](./qgis-form-number-range-slider.jpg "QGIS number range field form") + + For *decimal numbers*, the **Precision** (the number of decimal digits) needs to be specified in the **Advanced Options** of the widget, so that the **Minimum**, **Maximum**, and **Step** values can be set as decimal numbers. + + ![QGIS decimal number slider field form](./qgis-form-decimal-range-slider.webp "QGIS decimal number slider field form") + +4. **Apply** the changes. Don't forget to save and sync your project! In the , the **Slider** looks like this. The number can be filled in by moving the slider: ![Mergin Maps mobile app number range field form](./mobile-form-range-slider.jpg "Mergin Maps mobile app number range field form") +## Text edit +The **Text edit** widget can be used for a simple entry of a decimal number. + +1. Right-click on a layer, select **Properties** and go to the **Attributes form** tab. +2. In the list of **Available Widgets**, select the numeric field you want to work with (here: `decimal`). +3. In the **Widget Type** tab, select the **Text edit** widget. + + ![QGIS decimal number text edit form](./qgis-form-decimal-text-edit.webp "QGIS decimal number text edit form") + +4. **Apply** the changes. Don't forget to save and sync your project! + +In the , the **Text widget** for a decimal number looks like this. The number can be filled in manually using the keyboard: + +![Mergin Maps mobile app decimal number text edit form](./mobile-form-decimal-text-edit.webp "Mergin Maps mobile app decimal number text edit form") + diff --git a/src/layer/numbers/mobile-form-decimal-preview.webp b/src/layer/numbers/mobile-form-decimal-preview.webp new file mode 100644 index 00000000..6a9ebed7 Binary files /dev/null and b/src/layer/numbers/mobile-form-decimal-preview.webp differ diff --git a/src/layer/numbers/mobile-form-decimal-preview.xcf b/src/layer/numbers/mobile-form-decimal-preview.xcf new file mode 100644 index 00000000..0b611e25 Binary files /dev/null and b/src/layer/numbers/mobile-form-decimal-preview.xcf differ diff --git a/src/layer/numbers/mobile-form-decimal-text-edit.webp b/src/layer/numbers/mobile-form-decimal-text-edit.webp new file mode 100644 index 00000000..f6dd26da Binary files /dev/null and b/src/layer/numbers/mobile-form-decimal-text-edit.webp differ diff --git a/src/layer/numbers/mobile-form-decimal-text-edit.xcf b/src/layer/numbers/mobile-form-decimal-text-edit.xcf new file mode 100644 index 00000000..b90f4ef8 Binary files /dev/null and b/src/layer/numbers/mobile-form-decimal-text-edit.xcf differ diff --git a/src/layer/numbers/qgis-form-decimal-range-editable.webp b/src/layer/numbers/qgis-form-decimal-range-editable.webp new file mode 100644 index 00000000..ef272c52 Binary files /dev/null and b/src/layer/numbers/qgis-form-decimal-range-editable.webp differ diff --git a/src/layer/numbers/qgis-form-decimal-range-editable.xcf b/src/layer/numbers/qgis-form-decimal-range-editable.xcf new file mode 100644 index 00000000..3e7b94f4 Binary files /dev/null and b/src/layer/numbers/qgis-form-decimal-range-editable.xcf differ diff --git a/src/layer/numbers/qgis-form-decimal-range-slider.webp b/src/layer/numbers/qgis-form-decimal-range-slider.webp new file mode 100644 index 00000000..f2a4e68e Binary files /dev/null and b/src/layer/numbers/qgis-form-decimal-range-slider.webp differ diff --git a/src/layer/numbers/qgis-form-decimal-range-slider.xcf b/src/layer/numbers/qgis-form-decimal-range-slider.xcf new file mode 100644 index 00000000..01926c2e Binary files /dev/null and b/src/layer/numbers/qgis-form-decimal-range-slider.xcf differ diff --git a/src/layer/numbers/qgis-form-decimal-text-edit.webp b/src/layer/numbers/qgis-form-decimal-text-edit.webp new file mode 100644 index 00000000..8b0cefac Binary files /dev/null and b/src/layer/numbers/qgis-form-decimal-text-edit.webp differ diff --git a/src/layer/numbers/qgis-form-decimal-text-edit.xcf b/src/layer/numbers/qgis-form-decimal-text-edit.xcf new file mode 100644 index 00000000..b1655644 Binary files /dev/null and b/src/layer/numbers/qgis-form-decimal-text-edit.xcf differ diff --git a/src/layer/numbers/qgis-form-number-range-editable.jpg b/src/layer/numbers/qgis-form-number-range-editable.jpg deleted file mode 100644 index e1f24038..00000000 Binary files a/src/layer/numbers/qgis-form-number-range-editable.jpg and /dev/null differ diff --git a/src/layer/numbers/qgis-form-number-range-editable.webp b/src/layer/numbers/qgis-form-number-range-editable.webp new file mode 100644 index 00000000..c978562d Binary files /dev/null and b/src/layer/numbers/qgis-form-number-range-editable.webp differ