SurveyJS v1.10.1
Released: April 23, 2024
SurveyJS v1.10.1 introduces a breaking change: expressions that reference questions with valuePropertyName
now require additional configuration. New features include animated effects in Dynamic Panel and Dynamic Matrix and the capability to select items to rank using a click in Ranking questions.
[Breaking Change] Expressions that reference questions with valuePropertyName
now require additional configuration
The valuePropertyName
setting specifies a property for storing the value of a Checkboxes question. With this setting, the question value contains an array of objects instead of an array of primitive values. However, expressions previously treated the question value as if it contained an array of primitive values, regardless of the valuePropertyName
setting. This made referencing the target question more simple, as shown by the visibleIf
expression in the following JSON schema:
{
"elements": [{
"type": "checkbox",
"name": "q1",
"choices": ["apple", "banana", "orange"],
"valuePropertyName": "fruit"
}, {
"type": "text",
"name": "q2",
"visibleIf": "{q1} allof ['apple', 'orange']"
}]
}
However, this simplification produced an error in cases when the question with valuePropertyName
merged its value with a matrix question and then was used within such functions as sumInArray
:
{
"elements": [{
"type": "checkbox",
"name": "q1",
"choices": ["apple", "banana", "orange"],
"valuePropertyName": "fruit"
}, {
"type": "matrixdynamic",
"name": "q2",
"valueName": "q1",
"columns": [{
"name": "total",
"cellType": "text",
"inputType": "number"
}],
"rowCount": 0
}, {
"type": "expression",
"name": "q3",
// Doesn't work because {q1} refers to an array of strings, not objects
"expression": "sumInArray({q1}, 'total')"
}]
}
To resolve this issue, SurveyJS Form Library introduces a breaking change. To access an array of primitive values when you reference a question with valuePropertyName
, you now need to add the -unwrapped
suffix to the question name within expressions. Without the suffix, the question name now refers to an array of objects.
{
"elements": [{
"type": "checkbox",
"name": "q1",
"choices": ["apple", "banana", "orange"],
"valuePropertyName": "fruit"
}, {
"type": "text",
"name": "q2",
"visibleIf": "{q1-unwrapped} allof ['apple', 'orange']"
}]
}
Please update your JSON schemas if they use questions with specified valuePropertyName
within expressions.
New Animated Effects in Dynamic Panel and Dynamic Matrix
We continue to add animated effects to survey elements. The first set of enhancements became available with SurveyJS v1.9.137. The new release introduces animated effects to Dynamic Panel and Dynamic Matrix questions:
Dynamic Panel - List View: Animated addition and removal of entries
Dynamic Panel - Card View: Animatied addition, removal, and switching between entries
Dynamic Panel - Tab View: Animatied addition, removal, and switching between entries
Dynamic Matrix: Animated addition/removal of rows and display of row expansion sections
Ranking: Select items to rank using a click
We made it even easier for users to select items they want to rank. Previously, you needed to drag an item from the ranked to the unranked area. Since SurveyJS v1.10.1, you can simply click the required item.
New Blog Posts
New and Updated Demos
Dashboard: Disable the Layout Engine
Bug Fixes and Minor Enhancements
Form Library
setValueExpression
andresetValueIf
do not change the question value if the question is read-only (#8130)- Input masks: Calculate text alignment dynamically to allow proper inheritance from mask classes (#8133)
- Do not execute the
"runexpression"
trigger on switching to the next page (#8135) - Dynamic Panel with Tab View: The Menu button doesn't appear after adding many panels (#8119)
- Dropdown: A gap appears in the drop-down menu when the question is located at the bottom of a form (#8047)
- Rating Scale: Switching the "Rating configuration" option to Auto throws an error (#8147)
- Line breaks do not apply to question titles in Survey Creator (#8161)
- The
onValueChanged
event is not raised when changing a question comment if thevalueName
property is set (#8137)
Survey Creator
- Image Picker: Screen readers do not announce the Upload, Delete, and Add Image button captions properly (#5408)
Dashboard
- Implement an API to make a visualizer default (#427)
WordPress Plugin
- Survey Creator throws an error when trying to create a new survey without using custom themes (#46)
How to Update SurveyJS Libraries in Your Application
Angular
npm i survey-core@1.10.1 survey-angular-ui@1.10.1 --save
npm i survey-creator-core@1.10.1 survey-creator-angular@1.10.1 --save
npm i survey-analytics@1.10.1 --save
npm i survey-pdf@1.10.1 --save
React
npm i survey-core@1.10.1 survey-react-ui@1.10.1 --save
npm i survey-creator-core@1.10.1 survey-creator-react@1.10.1 --save
npm i survey-analytics@1.10.1 --save
npm i survey-pdf@1.10.1 --save
Vue 3
npm i survey-core@1.10.1 survey-vue3-ui@1.10.1 --save
npm i survey-creator-core@1.10.1 survey-creator-vue@1.10.1 --save
npm i survey-analytics@1.10.1 --save
npm i survey-pdf@1.10.1 --save
Vue 2
npm i survey-core@1.10.1 survey-vue-ui@1.10.1 --save
npm i survey-creator-core@1.10.1 survey-creator-knockout@1.10.1 --save
npm i survey-analytics@1.10.1 --save
npm i survey-pdf@1.10.1 --save
Knockout / jQuery
<link href="https://unpkg.com/survey-core@1.10.1/defaultV2.min.css" type="text/css" rel="stylesheet">
<script type="text/javascript" src="https://unpkg.com/survey-core@1.10.1/survey.core.min.js"></script>
<script type="text/javascript" src="https://unpkg.com/survey-knockout-ui@1.10.1/survey-knockout-ui.min.js"></script>
<link href="https://unpkg.com/survey-creator-core@1.10.1/survey-creator-core.min.css" type="text/css" rel="stylesheet">
<script src="https://unpkg.com/survey-creator-core@1.10.1/survey-creator-core.min.js"></script>
<script src="https://unpkg.com/survey-creator-knockout@1.10.1/survey-creator-knockout.min.js"></script>
<link href="https://unpkg.com/survey-analytics@1.10.1/survey.analytics.min.css" rel="stylesheet">
<script src="https://unpkg.com/survey-analytics@1.10.1/survey.analytics.min.js"></script>
<script src="https://unpkg.com/survey-pdf@1.10.1/survey.pdf.min.js"></script>