Skip to content

Latest commit

 

History

History
56 lines (41 loc) · 2.66 KB

README.md

File metadata and controls

56 lines (41 loc) · 2.66 KB

Slider

Preview - two sliders on one screen

Description

Allows for a continuous slider with no markers along the way (for more subjective ratings)

Download now

Features

  • Display a slider with no markers
  • Allow for varying step size
  • Allow for displaying the value

Data Format

The field value will be the last value indicated on the slider. This will be an integer for an integer field or a decimal for a decimal field.

Default SurveyCTO feature support

Feature / Property Support
Supported field type(s) integer, decimal
Default values Yes
Constraint message Uses default behavior
Required message Uses default behavior
Read only Yes (shows the current value, if present)
media:image Yes
media:audio Yes
media:video Yes

How to use

  1. Download the test form extras/sample-form from this repo and upload it to your SurveyCTO server.
  2. Download the slider.fieldplugin.zip file from this repo, and attach it to the test form on your SurveyCTO server.
  3. Make sure to provide the correct parameters (see below).

Parameters

The plugin can take upto 4 parameters.

  1. min - The lowest value in the range of permitted values
  2. max - The greatest value in the range of permitted values
  3. step (optional) - The step attribute is a number that specifies the granularity that the value must adhere to. The default is 1 for integer and 0.1 for decimals
  4. display_value (optional) - Set to yes to display the current value of the slider below the slider. Default is not to show the value.

Example usage is as follows:

custom-slider(min="0", max="150", step=5)
custom-slider(min="0", max="1", step=0.01)
custom-slider(min="0", max="100", step=1, display_value='yes')

More Resources

Sample Form

You can find a form definition in this repo here: extras/sample_form. This form will help you create a sample form to test the functionality of the plugin.

Developer documentation

More instructions for developing and using field plug-ins can be found here: https://github.com/surveycto/Field-plug-in-resources