Changes between Version 4 and Version 5 of DeveloperGuidelines/EdenMobile/DataFormats

Timestamp:

08/30/19 08:19:26 (6 years ago)

Author:

Dominic König

Comment:

--

DeveloperGuidelines/EdenMobile/DataFormats

@@ -51 +51 @@
 
 NB In future, the field settings will fall back to values introspected from the web2py Field instance (requires/widget/represent), but this does not happen yet, so it is essential to configure the "mobile" section in the settings for EdenMobile to handle the field correctly. If no mobile settings are provided, EdenMobile will assume defaults, which may differ from what is configured for the field on the server!
+
+=== Widget-specific Configurations ===
+
+==== Likert-scale ====
+
+ - Field is type "string"
+
+Field settings to use pre-defined scales:
+{{{
+"mobile": {
+    "widget": {
+        "type": "likert",
+        "scale": "appropriateness"|"confidence"|"frequency"|"safety"|"satisfaction"|"smiley-5"|"smiley-3"
+    }
+}
+}}}
+
+ - predefined scale sets field options and option<=>icon mapping
+
+Field settings to use custom scale:
+{{{
+"mobile": {
+    "widget": {
+        "type": "likert",
+        "icons": {
+            "option": "icon-css-class", ...
+        },
+        "iconsOnly": true|false
+    }
+}
+}}}
+
+ - with custom scale, the field must have options defined
+ - scales without icons-only are rendered as standard vertical radio list (single-select)
+ - scales with icons-only are rendered as horizontal radio bar with icons
 
 === Form Description ===