Differences

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

--- stateregion [2021/09/28 17:48] – [Series of Questions] admin
+++ stateregion [2023/10/05 08:38] (current) – [stateRegion - Automatically group states or other geographic areas into regions] admin
@@ Line 5: / Line 5: @@
   * Flexible assignment of states and regions to support any country
   * Produces highly usable response data
-  * Searchable drop-downs
+  * Searchable state drop-down
   * Supports using either a single Side-by-Side question or a series of Multiple Choice questions
   * Optionally records state abbreviation
   * Optional state selection based on IP location
+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 =====
@@ Line 38: / Line 40: @@
 As an alternative to a Side-by-side question, a series of 3 or 4 separate questions may be used. The series of questions must the last questions on the page. The first question must be a drop-down with delimited states/regions as choices. The choices are either in the format state|region (e.g., Alabama|South) or state|abbreviation|region (e.g., Alabama|AL|South). The second question is a drop-down with the regions as choices. The region names must match the region names used in the first question. The third question is a text entry question for the state name. The fourth question is a text entry question for the state abbreviation and is only needed if the delimited choices in the first question include abbreviation.
-The advantages of using a series of questions are that the drop downs are easier to configure, and if the Madlib happens to be a screening question, it enables generation of test responses with Q_PopulateResponse (due to a bug in Generate Test Responses Side-by-side questions don't work properly when the answer is specified with Q_PopulateResponse)
+The advantages of using a series of questions are that the drop downs are easier to configure, and if it happens to be a screening question, it enables generation of test responses with Q_PopulateResponse (due to a bug in Generate Test Responses Side-by-side questions don't work properly when the answer is specified with Q_PopulateResponse)
 ==== JavaScript Function Call ====
@@ Line 60: / Line 62: @@
 The width of the state input field.
-Default: "auto"
+Default: %%"auto"%%
 == debug ==
@@ Line 73: / Line 75: @@
 == ipLoc ==
-Boolean to automatically select the state based on IP location.
+Boolean to automatically select the lookup field (i.e., state) based on IP location.
 Default: false
+== ipLocName ==
+The name of the ip location field for the lookup field (i.e., state) when ipLoc is true. Valid values are %%"region" (state, province, etc.), "region_code", "city", "country_name",
+and "country_code"%%.
-== padTopClass ==
+Default: %%"region"%%
-The class of the <div> (see [[madlibs#padTopHide|padTopHide]]) used to push the stateRegion question(s) off the bottom of the screen while it loads.
-Default: "padTopHide"
 == placeholder ==
 Placeholder text to show before state is selected.
-Default: "select or type state"
+Default: %%"select or type state"%%
 ==== Question Text HTML ====
 The side-by-side question or the first drop-down question with the delimited state/region choices must have the following html as the question text. Click on the Question Text and click the HTML View tab. **__ONLY__** edit the stateRegion question in HTML View. Qualtrics will make unexpected changes to question HTML when edited in other modes.
 <code>
-<div class="padTopHide" style="${e://Field/padTopHide}"></div>
 In which state do you currently live?
 <div style="padding-top:1em"><input class="state" type="text"></div>
+<style>.Skin {opacity:0;}</style>
 </code>
+====== Qualtrics Wiki ======
-The embedded data field padTopHide should be set at the top of the survey flow:
+[[start|Qualtrics Wiki]]
-<code>
-padTopHide = padding-top:2500px;
-</code>