====== dualSidedSlider- Slider for trade-off between two items ======
The **dualSidedSlider** function allows for the measurement of the trade-off between two items. It automatically allocates percentages (or some other allocation) to two items when the slider is moved and records both values. The **dualSidedSlider** function supports:

  * Not Applicable option
  * Allocations other than percentage
  * Item randomization
  * Mobile devices

Here is a quick video demonstration:\\
{{ ::dualSidedSlider.mp4?800 |dualSidedSlider Demonstration}}

This function is available for a reasonable fee. Contact [[https://community.qualtrics.com/XMcommunity/messages/add/TomG|TomG]] on the Qualtrics Community to learn more.

===== Set-up Instructions =====
==== Set-up Questions ====
**dualSidedSlider** requires two questions, a Slider question followed immediately by a Form Field question that will be hidden from the respondent.
=== Slider Question ===
Requirements for the Slider question:
  * One row - the row label can be any text and won't be displayed
  * Two labels - the two items being compared
  * Scale must start at zero
  * Show value on
  * Mobile friendly off (dualSidedSlider is still mobile compatible even though Mobile friendly is turned off)
  * Start position at midpoint
=== Text Form Question ===
Requirements for the Form Field question:
  * Must immediately follow Slider question
  * Two fields
  * First field must match left label in Slider question
  * Second field must match right label in Slider question
==== Add Function To Survey ====
Add the **dualSidedSlider** function to the survey header to make it available to any page/question in the survey. Go to Look & Feel -> General -> Header edit -> {{::icon_source.jpg?20|}} and paste the provided freezeTopQ function JS:
<code>
<script>/*Paste dualSidedSlider function JS here*/</script>
</code>
Alternatively, paste the dualSidedSlider function JS into a slider question's JS __outside__ the existing Qualtrics functions to make it available to questions on the page.
==== JavaScript Function Call ====
Add JS to call the dualSidedSlider function to apply it to the slider question as follows:
<code>
Qualtrics.SurveyEngine.addOnload(function() {
	dualSidedSlider(this);
});
</code>

To change the default **[[dualsidedslider#Options|options]]**, specify the desired options in the second function argument as an object. For example:
<code>
Qualtrics.SurveyEngine.addOnload(function() {
	dualSidedSlider(this,{max:10,after:"&nbsp;",random:true});
});
</code>
===== Options =====
==== after ====
**after** specifies the character(s) to show after the value.

Default: %%"%"%%
==== debug ====
**debug** turns on debug mode to see the values captured in the hidden question.

Default: false
==== max ====
**max** specifies the scale maximum (should match the slider scale maximum).

Default: 100
==== random ====
**random** turns on randomization, which randomly flips the left and right items.

Default: false
====== Qualtrics Wiki ======
[[start|Qualtrics Wiki]]