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.

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.

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:

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.

View Demo

The Power of Form Animation

Dashboard: Disable the Layout Engine

Customize PDF Forms

Form Library

• setValueExpression and resetValueIf 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 the valueName 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)

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

npm i survey-core@1.10.1 survey-react-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

npm i survey-core@1.10.1 survey-vue3-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

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

<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>