Differences

This shows you the differences between two versions of the page.

--- scaledmatrix [2022/02/06 11:17] – [scaledMatrix - Flexible, mobile friendly NPS style matrix] admin
+++ scaledmatrix [2024/04/30 07:45] (current) – [Matrix Question] admin
@@ Line 4: / Line 4: @@
 Functionality includes:
   * Option for formatting single row matrix questions
-  * Option for formatting for last column 'NA', 'Not sure' etc. including width and format of divider
+  * Option for formatting one or more 'NA', 'Not sure' etc. columns including width and format of divider
   * Options for repeating headers in middle or on bottom
   * Supports scale images
   * Supports middle labels, not just end labels (unlike NPS question)
+  * Supports choice groups
   * Optionally control width of scale labels
   * Optionally add and format scale dividers
-  * Compatible with [[likerthighlightunanswered|likertHighlightUnanswered]] function
+  * Compatible with **[[matrixhighlightunanswered|matrixHighlightUnanswered]]**
 ;#;
@@ Line 21: / Line 22: @@
 {{ :formatscaledmatrix_mobile.png?300 |}}
-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.
+This function is available for a reasonable fee. Contact **[[https://community.qualtrics.com/inbox/conversation?with=373|TomG]]** on the Qualtrics Community to learn more.
 ===== Set-up Instructions =====
 ==== Survey Header ====
-To make the function available to all questions in the survey, copy the function to the Survey Header inside a script tag:
 Add the scaledMatrix 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 scaledMatrix function JS:
 <code>
@@ Line 30: / Line 30: @@
 </code>
 Alternatively, paste the scaledMatrix function JS into a question's JS outside the existing Qualtrics functions to make it available to questions on the page.
-==== Multiple Choice Question ====
+==== Matrix Question ====
 === Question Settings ===
 Set the following single choice Likert Matrix options:
@@ Line 43: / Line 43: @@
 </code>
-To override the default options, specify the desired options in the second function argument as an object. For example:
+To override the default **[[scaledmatrix#options|options]]**, specify the desired options in the second function argument as an object. For example:
 <code>
 Qualtrics.SurveyEngine.addOnload(function() {
-	scaledMatrix(this,{lastNA:true,scaleLabels:["Extremely<br>dissatisfied","Extremely<br>satisfied"]});
+	scaledMatrix(this,{NAcols:1,scaleLabels:["Extremely dissatisfied","Extremely satisfied"]});
 });
 </code>
 ===== Options =====
 ==== labelsBottom ====
-**labelsBottom** specifies whether scale labels should be repeated on the bottom. Set to true to turn on bottom labels
+**labelsBottom** specifies whether scale labels should be repeated on the bottom. Set to true to turn on bottom labels.
 Default: false
 ==== labelsBottomMin ====
-**labelsBottomMin** specifies the minimum number of rows before bottom labels will be displayed when [[formatscaledmatrix#labelsBottom|labelsBottom]] is true.
+**labelsBottomMin** specifies the minimum number of rows before bottom scale labels will be displayed when **[[scaledmatrix#labelsBottom|labelsBottom]]** is true.
 Default: 3
-==== lastNA ====
+==== labelsMiddle ====
-**lastNA** specifies the last column as 'NA', 'Not sure' etc. when set to true. Turning on automatically adjusts the position of the right scale anchor.
+**labelsMiddle** specifies how often middle repeat scale labels should be shown in number of rows.  Setting to 0 (zero) turns middle labels off.
-Default: false
-==== middleLabels ====
-**middleLabels** specifies how often middle repeat headers should be shown in number of rows.  Setting to 0 (zero) turns middle labels off.
 Default: 0
+==== labelsTopHide ====
+**labelsTopHide** specifies whether top scale labels should be hidden. Set to true to hide top scale labels.
+Default: false
+==== NAcols ====
+**NAcols** specifies the number of 'NA', 'Not sure', etc. columns on the right side of the scale. When greater than 0 (zero), the position of the right scale anchor is adjusted.
+Default: 0
 ==== NAdividerStyle ====
-**NAdividerStyle** specifies the CSS style of the NA divider that separate the NA answer from the other answers when [[formatscaledmatrix#lastNA|lastNA]] is true.
+**NAdividerStyle** specifies the CSS style of the NA divider that separate the NA columns from the other answers when **[[scaledmatrix#lastNA|NAcols]]** is greater than 0 (zero).
-Default: : "1px solid #666666"
+Default: : %%"1px solid #666666"%%
 ==== NAwidth ====
-**NAwidth** is used to override the default width of NA column to make it a different width that the other columns when [[formatscaledmatrix#lastNA|lastNA]] is true. Specified as a percentage. Set to 0 (zero) to use default width.
+**NAwidth** is used to override the default width of NA columns to make them a different width that the other columns when **[[scaledmatrix#lastNA|NAcols]]** is greater than 0 (zero). Specified as a percentage. Set to 0 (zero) to use default width.
 Default: 0
@@ Line 83: / Line 87: @@
 Default: [] (no dividers)
 ==== scaleDividerStyle ====
-**scaleDividerStyle** specifies the CSS style of the scale dividers when [[formatscaledmatrix#scaleDividers|scaleDividers]] is specified.
+**scaleDividerStyle** specifies the CSS style of the scale dividers when **[[scaledmatrix#scaleDividers|scaleDividers]]** is specified.
-Default: "1px solid #666666"
+Default: %%"1px solid #666666"%%
 ==== scaleImage ====
 **scaleImage** specifies the url of the image that will be displayed above the scale.
-Default: "" (none)
+Default: %%""%% (none)
 ==== scaleLabels ====
 **scaleLabels** is an array that specifies the scale labels.
-Default: ["Extremely<br>Unlikely","Extremely<br>Likely"]
+Default: %%["Extremely<br>Unlikely","Extremely<br>Likely"]%%
 ==== scaleLabelWidth ====
-**scaleLabelsWidths** is an array that specifies the width of the scale labels. For example: ["30%","40%","30%"]. If provided it must match the number of [[scaledmatrix#scaleLabels]].  Setting to [] (blank) auto-calculates the widths.
+**scaleLabelsWidths** is an array that specifies the width of the scale labels. For example: ["30%","40%","30%"]. If provided it must match the number of **[[scaledmatrix#scaleLabels|scaleLabels]]**.  Setting to [] (blank) auto-calculates the widths.
 Default: [] (blank)
+====== Qualtrics Wiki ======
+[[start|Qualtrics Wiki]]