Differences

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

--- sbsselectalphabetize [2022/10/02 14:02] – [select] admin
+++ sbsselectalphabetize [2023/09/25 07:49] (current) – admin
@@ Line 1: / Line 1: @@
-====== sbsSelectAlphabetize - Alphabetize selects (aka dropsdowns) within a Side-by-Side on-the-fly ======
+====== sbsSelectAlphabetize - Alphabetize selects (aka dropdowns) within a Side-by-Side on-the-fly ======
 The **sbsSelectAlphabetize** function arranges choices with side-by-side selects (aka dropdowns) into alphabetical order on-the-fly. It is useful for translated surveys where you want the choices in alphabetical order for every language. It is also useful if you don't want to manually alphabetize each time you add a dropdown choice within a side-by-side.
@@ Line 5: / Line 5: @@
   * Alphabetizes based on current language
   * Supports anchoring of choices to the bottom of the list
-  * Can be used on any dropdown column in a side-by-side
+  * Can be used on all dropdowns or specific dropdown columns in a side-by-side
-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.
+To alphabetize choices in multiple choice questions on-the-fly, see **[[mcAlphabetize|mcAlphabetize]]**.
 ===== Set-up Instructions =====
@@ Line 33: / Line 35: @@
 ===== Options =====
 ==== anchors ====
-**anchors** specifies the array of choice ids that should be anchored to the bottom of the list.
+**anchors** specifies the array of choice ids that should be anchored to the bottom of the list. Choice ids should be listed in the order they should be displayed.
 To identify choice ids (i.e., option values), preview the question and use the Inspect feature of your browser.
 Default: [] (nothing anchored)
-==== lang ====
+==== langs ====
-**lang** is a two character Qualtrics language string that should be used to do the alphabetization.
+**langs** is an object for mapping Qualtrics language codes to valid JavaScript locale languages for correct sorting. It is only needed if the Qualtrics language code doesn't resolve to valid JavaScript locale language code. Of the built-in Qualtrics languages, only ZH-S (Simplified Chinese) and ZH-T (Traditional Chinese) don't resolve, but they are included in the **langs** object by default.
+If you have created your own language code, you made need to add your language to the langs object if it doesn't automatically resolve. A new language specification would look like %%langs:{"XX":"yy"}%%.
+==== qlang ====
+**qlang** is the Qualtrics language code string that should be used to do the alphabetization. By default, this is the current language of the survey.
 Default: %%"${e://Field/Q_Langauge}"%%
@@ Line 45: / Line 51: @@
 **select** is the css selector for the selects to be alpabetize.  By default all selects (dropdowns) in the Side-by-Side (SBS) will be alphabetized. To specify a specific SBS column add the column class before 'select'. For example to specify the first answer column use '.SBS1 select'.
-Default: "select"
+Default: %%"select"%%
 ====== Qualtrics Wiki ======
 [[start|Qualtrics Wiki]]