Differences

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

--- csranks [2022/12/12 10:18] – [rankText] admin
+++ csranks [2025/02/15 09:38] (current) – [otherSortArr] admin
@@ Line 11: / Line 11: @@
   * Supports two modes: allow ties or break ties
   * Supports tie breaking based on question randomization or one or more of these other choice fields: text, id, variable name, html, or recode. Other choices fields can be sorted ascending or descending for tie breaking purposes.
-  * Saves labels of choices to embedded data fields. Labels can be saved as HTML, text only, or variable names.
+  * Saves labels of choices to embedded data fields. Labels can be saved as HTML, text only, variable names, or entered text.
   * Saves values of choices to embedded data fields.
   * Ranked items can be piped on the next page - no additional questions, blocks, or survey flow logic needed.
@@ Line 62: / Line 62: @@
 **and** is text used to join the last label when **[[csranks#allowTies|allowTies]]** is true. If **and** is not empty, a space is added before and after if it does not start with a comma (,), colon (:), semi-colon (;), or pipe (|). For translated surveys pipe the value from a translated question.
-Default: "and"
+Default: %%"and"%%
 ==== delim ====
 **delim** is a delimiter used to break the embedded data field names into sections. The delimiter is placed between each section.
-Default: "."
+Default: %%"."%%
 ==== join ====
 **join** is text used to join three or more labels when **[[csranks#allowTies|allowTies]]** is true.
-Default: ", "
+Default: %%", "%%
 ==== labelText ====
 **labelText** is used in embedded data field names that capture labels of ranked items.
-Default: "text"
+Default: %%"text"%%
 ==== last ====
 **last** is text used in embedded data field names for the last ranked item in place of a rank number (e.g., Q1.rank.text.last).
-Default: "last"
+Default: %%"last"%%
 ==== otherSortArr ====
-**otherSortArr** is an array used to specify the fields used for tie breaking. It also specifies to order of combined labels when **[[csranks#allowTies|allowTies]]** is true. An empty array (the default) means ties will be broken based on the randomized order of the choices in the question. If other fields are specified, they should be specified by field name in priority order. Add a minus sign (-) in front of the field name to specify descending order. Available fields (case sensitive) are: Text, id, VariableName, html, and Recode. For example, to specify a tie breaker of descending recode followed by choice text, the function would be called like this:
+**otherSortArr** is an array used to specify the fields used for tie breaking. It also specifies the order of combined labels when **[[csranks#allowTies|allowTies]]** is true. An empty array (the default) means ties will be broken based on the randomized order of the choices in the question. If other fields are specified, they should be specified by field name in priority order. Add a minus sign (-) in front of the field name to specify descending order. Available fields (case sensitive) are: Text, id, VariableName, html, and Recode. For example, to specify a tie breaker of descending recode followed by choice text, the function would be called like this:
 <code>
 csRanks(this,{otherSortArr:['-Recode','Text']});
@@ Line 87: / Line 87: @@
 Default: []
 ==== oxford ====
-**oxford** is text used before **[[csranks#and|and]]** when **[[csranks#allowTies|allowTies]]** is true and three or more labels are joined. In the text "Item1, Item2, and Item3" the comma before "and" is called an Oxford comma. Change **oxford** to "" to remove the Oxford comma.
+**oxford** is text used before **[[csranks#and|and]]** when **[[csranks#allowTies|allowTies]]** is true and three or more labels are joined. In the text "Item1, Item2, and Item3" the comma before "and" is called an Oxford comma. Change **oxford** to %%""%% to remove the Oxford comma.
-Default: ","
+Default: %%","%%
 ==== prefixText ====
 **prefixText**, if not blank, is used at the beginning of embedded data field names.
-Default: "" (empty)
+Default: %%""%% (empty)
 ==== rankText ====
 **rankText** is the text used in the rank section of embedded data field names.
-Default: "rank"
+Default: %%"rank"%%
 ==== rankZero ====
 **rankZero** is a boolean that specifies if choices with a value of zero should be included in ranking.
@@ Line 106: / Line 106: @@
 Default: false
+==== textEnter ====
+**textEnter** is a boolean used to capture entered text for the choice label when ‘Allow text’ is turned on.
+Default: true
 ==== textOnly ====
 **textOnly** is a boolean used to remove HTML from labels when set to true.
@@ Line 117: / Line 121: @@
 **valueText** is used in embedded data field names that capture values of ranked items.
-Default: "value"
+Default: %%"value"%%
 ====== Qualtrics Wiki ======
 [[start|Qualtrics Wiki]]