--- title: Merge Question Values product: Form Library description: Split your complex forms into multiple parts and link them with each other to save survey results in a single object or array. View a free demo for JavaScript to learn more. framework: React source: https://surveyjs.io/form-library/examples/merge-question-values/reactjs index: https://surveyjs.io/form-library/examples/overview.md --- # Merge Question Values (React) You can merge values from multiple questions into a single array or object. This functionality enables you to split complex forms into connected parts. For example, you can create a form where users enter a list of employees in one question and fill out details about them in a dedicated section of questions that generates dynamically once a new employer has been added to the list. If you link the questions with each other, their values will be merged into a single array. ## Associate Compatible Questions To link two questions, set their [`valueName`](https://surveyjs.io/form-library/documentation/api-reference/question#valueName) property to the same value. This value will be used as a name for the property that will contain the merged array. In this demo, the employment history form contains two questions of the [Dynamic Matrix](https://surveyjs.io/form-library/documentation/api-reference/dynamic-matrix-table-question-model) and [Dynamic Panel](https://surveyjs.io/form-library/documentation/api-reference/dynamic-panel-model) types. Respondents enter a list of employer names into the matrix and details about each employer into multiple panels. Together, Dynamic Matrix and Dynamic Panel produce an `employees` array of objects. The matrix supplies the `employee-name` field values; the panel supplies the remaining field values. Once bound via `valueName`, two questions can reference each other's values. For example, values from the matrix can be displayed in panel headers, as shown in this demo. ## Associate Incompatible Questions Dynamic Matrix and Dynamic Panel are compatible because they both produce arrays of objects when they are used as standalone questions. In some instances, you need to associate two or more questions that produce results in different formats and as such are incompatible. For example, the Checkboxes question type produces an array of primitive values, and a primitive value cannot be merged with an object. To force a Checkboxes question to produce an array of objects, specify the [`valuePropertyName`](https://surveyjs.io/form-library/documentation/api-reference/checkbox-question-model#valuePropertyName) property with a field name that should store question values. In this demo, on the second survey page respondents are asked about their language skills. Respondents should select languages they speak from a Checkboxes question. For each selected language, a Dynamic Panel question generates a detail panel. The two questions are associated via `valueName`, and the Checkboxes question produces an array of objects. The `language` object field stores the selected language. This field is used to reference languages in panel headers. ## Files ### `public/index.html` ```html
``` ### `src/SurveyComponent.jsx` ```js import React from "react"; import { Model } from "survey-core"; import { Survey } from "survey-react-ui"; import "survey-core/survey-core.min.css"; import "./index.css"; import { json } from "./json"; function SurveyComponent() { const survey = new Model(json); survey.onComplete.add((sender, options) => { console.log(JSON.stringify(sender.data, null, 3)); }); return (); } export default SurveyComponent; ``` ### `src/index.css` ```css /* You can add your custom CSS here. */ ``` ### `src/index.js` ```js import React from "react"; import { createRoot } from "react-dom/client"; import SurveyComponent from "./SurveyComponent"; const root = createRoot(document.getElementById("surveyElement")); root.render(); ``` ### `src/json.js` ```js export const json = { "title": "Employment History", "pages": [ { "name": "employers-page", "elements": [ { "type": "matrixdynamic", "name": "employerNames", "title": "Please add your previous and current employers", "valueName": "employers", "isRequired": true, "showHeader": false, "columns": [ { "name": "employee-name", "cellType": "text", "isRequired": true } ], "rowCount": 1, "minRowCount": 1, "addRowText": "Add Employer" }, { "type": "paneldynamic", "name": "employers_info", "title": "Details", "valueName": "employers", "templateElements": [ { "type": "panel", "name": "panel_employer_address", "elements": [ { "type": "text", "name": "jobTitle", "title": "Job Title", "titleLocation": "left" }, { "type": "text", "name": "city", "startWithNewLine": false, "title": "City", "titleLocation": "left" }, { "type": "panel", "name": "workingDate", "elements": [ { "type": "text", "name": "startDate", "title": "Start Date", "titleLocation": "left", "inputType": "month", "validators": [ { "type": "expression", "text": "The value should not be less than the current date", "expression": "getDate({panel.startDate}) < currentDate()" } ] }, { "type": "text", "name": "endDate", "title": "End Date", "titleLocation": "left", "validators": [ { "type": "expression", "text": "The value should not be less than a start date", "expression": "getDate({panel.endDate}) > getDate({panel.startDate})" } ], "inputType": "month" } ] }, { "type": "comment", "name": "jobDescription", "startWithNewLine": false, "title": "Description", "description": "Describe your achievements. If possible, use numbers/facts (e.g., Achieved X, Measured by Y)", "placeholder": "e.g. Implemented a new digital marketing strategy that increased website traffic by 50% and improved lead generation by 30% over a period of six months.", "autoGrow": true } ] } ], "templateTitle": "Employer: {panel.employee-name}", "allowAddPanel": false, "allowRemovePanel": false } ], "description": "Please provide necessary information about your relevant experience. Click the Add Employer button below and enter the information about your employer. Fill out the additional fields in the form provided." }, { "name": "language-page", "elements": [ { "type": "checkbox", "name": "languages", "title": "Please select all languages that you are proficient in.", "isRequired": true, "choices": [ "English", "German", "Chinese", "French", "Japanese" ], "valuePropertyName": "language" }, { "type": "paneldynamic", "name": "languageInfo", "title": "Additional Details", "valueName": "languages", "templateElements": [ { "type": "rating", "name": "level", "title": "Level of proficiency:", "rateValues": [ "Beginner", "Intermediate", "Advanced", "Expert" ] }, { "type": "text", "name": "experience", "startWithNewLine": false, "title": "Years of experience:", "titleLocation": "left", "inputType": "number", "min": 1 } ], "templateTitle": "Language: {panel.language}", "allowAddPanel": false, "allowRemovePanel": false } ] } ] }; ``` ### `src/theme.js` ```js export const themeJson = {}; ``` ### `package.json` ```json { "dependencies": { "react": "latest", "react-dom": "latest", "survey-core": "latest", "survey-react-ui": "latest" }, "devDependencies": { "react-scripts": "latest" } } ``` ## Other Frameworks - [Angular](https://surveyjs.io/form-library/examples/merge-question-values/angular.md) - [Vue 3](https://surveyjs.io/form-library/examples/merge-question-values/vue3js.md) - [jQuery](https://surveyjs.io/form-library/examples/merge-question-values/jquery.md) - [Vanilla JS](https://surveyjs.io/form-library/examples/merge-question-values/vanillajs.md)