====== matrixSelectAll - Select all non-exclusive answers for a statement in a multi-select matrix ======
The **matrixSelectAll** function changes an answer (aka scale point) in a multi-select matrix to a 'Select all' answer. Features include:
  * 'Select all' answer can be placed in any order (first, last, etc.)
  * Compatible with:
    * Exclusive answers (aka scale points)
    * Transposed matrix
    * Position text above
    * Mobile accordion format
    * Back button

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

Here is a quick demonstration of a transposed matrix:\\
{{ ::matrixselectall_transposed.mp4?800 |matrixSelectAll Transposed Demonstration}}

To select all choices in multiple choice question see **[[mcselectall|mcSelectAll]]**.

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 =====
==== Survey Header ====
Add the matrixSelectAll function to the survey header to make it available to any question in the survey. Go to Look & Feel -> General -> Header edit -> {{::icon_source.jpg?20|}} and paste the provided matrixSelectAll function JS:
<code>
<script>/*Paste matrixSelectAll function JS here*/</script>
</code>
Alternatively, paste the matrixSelectAll function JS into a question's JS outside the existing Qualtrics functions to make it available to questions on the page.
==== Select All Answer Setup ====
To specify the 'Select all' answer (aka scale point), put the answer text inside a span with the class ''selectAll'' (''selectAll'' is the default class and can be changed in **[[matrixselectall#options|options]]**). For example:
<code>
<span class="selectAll">All options</span>
</code>
There should be one and only one 'select all' answer.
=== Question JavaScript ===
Add JS to call the matrixSelectAll function to apply it to the multiple choice question as follows:
<code>
Qualtrics.SurveyEngine.addOnload(function() {
	matrixSelectAll(this);
});
</code>

To override the default options, specify the desired **[[matrixselectall#options|options]]** is the second function argument as an object. For example:
<code>
Qualtrics.SurveyEngine.addOnload(function() {
	matrixSelectAll(this,{selectClass:'altClassName'});
});
</code>
===== Options =====
==== selectClass ====
The html class name of the span used to identify the Select/Deselect all choice. See **[[matrixselectall#select_all_answer_setup|Select All Answer Setup]]**.

Default: %%"selectAll"%%
====== Qualtrics Wiki ======
[[start|Qualtrics Wiki]]