Differences

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

--- bubbleburst [2023/09/23 16:15] – ['No More' choice] admin
+++ bubbleburst [2025/09/02 15:36] (current) – admin
@@ Line 3: / Line 3: @@
   * Supports text or image choices
   * Automatically detects Rank or Top //n// mode based on "allow text" configuration
-  * Specify number of items to be ranked/selected
+  * Specify minimum or minimum/maximum number of items to be ranked/selected
+  * Automatically adjusts maximum based on number of displayed choices
   * Optional auto advance when last item ranked/selected
   * Optional auto ranking/selection of last item when only one item remains
@@ Line 45: / Line 46: @@
 ==== Ranking ====
 To enable ranking turn on "Allow Text" for each choice in the multiple choice question.  If "Allow Text" is not enabled for __all__ choices, the bubbleBurst function is in Top N (where N is max) mode.
-==== Min/Max ====
-To set a minimum and maximum number of items to pick or rank, turn on 'Add validation' in the question settings and set 'Answer range' to set a minimum and maximum or 'Minimum choices selected' to set only a minimum.
-The bubbleBurst function automatically adjusts the minimum and maximum to accommodate exclusive choices and choice display logic. If an exclusive choice is selected the minimum is set to 1.  For choice display logic both the minimum and maximum may be updated based on the number of displayed choices. For example, if the maximum is set to 5, but the number of non-exclusive choices is 4, the maximum is updated to 4.
 ==== 'No More' choice ====
 A 'no more' choice is a choice used to by the respondent to end the pick/rank process once the minimum number of items have been selected. It is only visible once the minimum number of choices have been selected. It is similar to an exclusive choice, except it is only exclusive among the remaining choices instead of all choices. To create a 'no more' choice, use html like the following:
@@ Line 79: / Line 76: @@
 Default: false
+==== max ====
+**max** is the maximum number of items that should be ranked. The bubbleBurst function will automatically adjust max to accommodate exclusive choices and choice display logic. If max=0, max is set to the number of displayed choices excluding exclusive choices.
+Default: 0
+==== min ====
+**min** is the minimum number of items that should be ranked when Force Response is turned on. The next button id disabled until the min number of choices have been selected. The bubbleBurst function will automatically adjust min to accommodate exclusive choices, no more choices, and choice display logic. If min=0, min is set to the number of displayed choices excluding exclusive choices. For a true min of zero turn off Force Response.
+Default: 0
 ==== opacity ====
 **opacity** is an array containing the start and stop opacity for text or image animations.
@@ Line 96: / Line 101: @@
 Default: Reset
 ==== statusDone ====
-**statusDone** specifies the status text to display when the last (max) item has been ranked/selected. [ordinal], [count], and [max] are valid tokens that are dynamically updated.
+**statusDone** specifies the status text to display when the last (max) item has been ranked/selected. [ordinal], [count], [min], and [max] are valid tokens that are dynamically updated.
 Default: %%"Done! ([count]/[max])"%%
 ==== statusUpdate ====
-**statusUpdate** specifies the status update text before the last item is selected/ranked. [ordinal], [count], and [max] are valid tokens that are dynamically updated.
+**statusUpdate** specifies the status update text before the last item is selected/ranked. [ordinal], [count], [min], and [max] are valid tokens that are dynamically updated.
 Default: %%"Select the [ordinal] most important item. ([count]/[max])"%%