|
Creates a new page and adds it to a survey. Generates a new name if the name parameter is not specified.
- Type:
-
(name?: string, index?: number) => PageModel
- Parameters:
-
name, type: string
, a page name
index, type: number
, - a page index to where insert a new page. It is -1 by default and the page will be added into the end.
- Implemented in:
-
SurveyModel
- See also:
-
addPage
|
|
Adds an existing page to the survey.
- Type:
-
(page: PageModel, index?: number) => void
- Parameters:
-
page, type: PageModel
, a newly added page
index, type: number
, - a page index to where insert a page. It is -1 by default and the page will be added into the end.
- Implemented in:
-
SurveyModel
- See also:
-
addNewPage
|
|
Gets or sets whether a survey is automatically completed when goNextPageAutomatic = true . Set it to false if you do not want to submit survey automatically on completing the last survey page.
- Type:
-
boolean writable
- Implemented in:
-
SurveyModel
- See also:
-
goNextPageAutomatic
|
|
Gets or sets a list of calculated values in the survey.
- Type:
-
CalculatedValue[] writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
CalculatedValue
|
|
Cancels preview and switches back to the "running" state.
Details: Preview State
- Type:
-
(curPage?: any) => void
- Parameters:
-
curPage, type: any
, - A new current page. If the parameter is undefined then the last page becomes the current.
- Implemented in:
-
SurveyModel
- See also:
-
showPreviewBeforeComplete
, showPreview
, state
|
|
Gets or sets a value that specifies how the survey validates the question answers.
The following options are available:
onNextPage (default) - check errors on navigating to the next page or on completing the survey.
onValueChanged - check errors on every question value (i.e., answer) changing.
onValueChanging - check errors before setting value into survey. If there is an error, then survey data is not changed, but question value will be keeped.
onComplete - to validate all visible questions on complete button click. If there are errors on previous pages, then the page with the first error becomes the current.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- onNextPage
- You may set the following values into this property:
-
onNextPage
, onValueChanged
, onValueChanging
, onComplete
- Implemented in:
-
SurveyModel
|
|
Clears the survey data and state. If the survey has a completed state, it will get a running state.
- Type:
-
(clearData?: boolean, gotoFirstPage?: boolean) => void
- Parameters:
-
clearData, type: boolean
, clear the data
gotoFirstPage, type: boolean
, make the first page as a current page.
- Implemented in:
-
SurveyModel
- See also:
-
data
, state
, currentPage
|
|
Clears files from server.
- Type:
-
(question: IQuestion, name: string, value: any, fileName: string, callback: (status: string, data...
- Parameters:
-
question, type: IQuestion
, question
name, type: string
, question name
value, type: any
, file question value
fileName, type: string
callback, type: (status: string, data: any) => any
, call back function to get the status of the clearing operation
- Implemented in:
-
SurveyModel
|
|
Call this function to remove all question values from the survey, that end-user will not be able to enter.
For example the value that doesn't exists in a radiogroup/dropdown/checkbox choices or matrix rows/columns.
Please note, this function doesn't clear values for invisible questions or values that doesn't associated with questions.
In fact this function just call clearIncorrectValues function of all questions in the survey
- Type:
-
(removeNonExisingRootKeys?: boolean) => void
- Parameters:
-
removeNonExisingRootKeys, type: boolean
, - set this parameter to true to remove keys from survey.data that doesn't have corresponded questions and calculated values
- Implemented in:
-
SurveyModel
- See also:
-
Question.clearIncorrectValues
, Page.clearIncorrectValues
, Panel.clearIncorrectValues
|
|
Gets or sets a value that specifies how the invisible data is included in survey data.
The following options are available:
none - include the invisible values into the survey data.
onHidden - clear the question value when it becomes invisible. If a question has value and it was invisible initially then survey clears the value on completing.
onHiddenContainer - clear the question value when it or its parent (page or panel) becomes invisible. If a question has value and it was invisible initially then survey clears the value on completing.
onComplete (default) - clear invisible question values on survey complete. In this case, the invisible questions will not be stored on the server.
- Type:
-
any writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- onComplete
- You may set the following values into this property:
-
none
, onComplete
, onHidden
, onHiddenContainer
- Implemented in:
-
SurveyModel
- See also:
-
Question.visible
, onComplete
|
|
Removes a value from the survey results.
- Type:
-
(name: string) => void
- Parameters:
-
name, type: string
, The name of the value. Typically it is a question name.
- Implemented in:
-
SurveyModel
|
|
Gets or sets whether to clear value on disable items in checkbox, dropdown and radiogroup questions.
By default, values are not cleared on disabled the corresponded items. This property is not persisted in survey JSON and you have to set it in code.
- Type:
-
boolean writable
- Implemented in:
-
SurveyModel
|
|
Gets or sets user's identifier (e.g., e-mail or unique customer id) in your web application.
If you load survey or post survey results from/to api.surveyjs.io service, then the library do not allow users to run the same survey the second time.
On the second run, the user will see the survey complete page.
- Type:
-
string writable
- Implemented in:
-
SurveyModel
|
|
The HTML content displayed to an end user that has already completed the survey.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
clientId
, locale
|
|
Gets or sets the HTML content displayed on the complete page. Use this property to change the default complete page text.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
showCompletedPage
, completedHtmlOnCondition
, locale
|
|
The list of HTML condition items. If the expression of this item returns true , then a survey will use this item HTML instead of completedHtml .
- Type:
-
HtmlConditionItem[] writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
HtmlConditionItem
, completeHtml
|
|
Completes the survey, if the current page is the last one. It returns false if the last page has errors.
If the last page has no errors, completeLastPage calls doComplete and returns true .
- Type:
-
() => boolean
- Implemented in:
-
SurveyModel
- See also:
-
isCurrentPageHasErrors
, nextPage
, doComplete
|
|
Gets or sets the 'Complete' button caption.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
locale
|
|
Gets or sets a cookie name used to save information about completing the survey.
If the property is not empty, before starting the survey, the Survey library checks if the cookie with this name exists.
If it is true , the survey goes to complete mode and a user sees the survey complete page. On completing the survey the cookie with this name is created.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
|
|
Creates and returns a new page, but do not add it into the survey.
You can use addPage(page) function to add it into survey later.
- Type:
-
(name: string) => PageModel
- Parameters:
-
name, type: string
- Implemented in:
-
SurveyModel
- See also:
-
addPage
, addNewPage
|
|
Gets or sets the current survey page. If a survey is rendered, then this property returns a page that a user can see/edit.
- Type:
-
any writable
- Implemented in:
-
SurveyModel
|
|
The zero-based index of the current page in the visible pages array.
- Type:
-
number writable
- Implemented in:
-
SurveyModel
|
|
Gets or sets an object that stores the survey results/data. You can set it directly as { 'question name': questionValue, ... }
If you set the data property after creating the survey, you may need to set the currentPageNo to 0 , if you are using visibleIf properties for questions/pages/panels to ensure that you are starting from the first page.
- Type:
-
any writable
- Implemented in:
-
SurveyModel
- See also:
-
setValue
, getValue
, mergeData
, currentPageNo
|
|
Deletes the cookie with cookieName from the browser.
- Type:
-
() => void
- Implemented in:
-
SurveyModel
- See also:
-
cookieName
, hasCookie
, setCookie
|
|
Gets or sets a survey description. The survey description is displayed under a survey title.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
title
|
|
Use this method to dispose survey model properly.
- Type:
-
() => void
- Implemented in:
-
SurveyModel
|
|
Completes the survey.
Calling this function performs the following tasks:
- writes cookie if the
cookieName property is not empty
- sets the survey into
completed state
- fires the
onComplete event
- calls
sendResult function.
Calling the doComplete function does not perform any validation, unlike the completeLastPage function.
It calls navigateToUrl after calling onComplete event.
In case calling options.showDataSaving callback in the onComplete event, navigateToUrl is used on calling options.showDataSavingSuccess callback.
- Type:
-
(isCompleteOnTrigger?: boolean) => void
- Parameters:
-
isCompleteOnTrigger, type: boolean
- Implemented in:
-
SurveyModel
- See also:
-
completeLastPage
, cookieName
, state
, onComplete
, surveyPostId
, completeLastPage
, navigateToUrl
, navigateToUrlOnCondition
|
|
Downloads a file from server
- Type:
-
(questionName: string, fileValue: any, callback: (status: string, data: any) => any) => void
- Parameters:
-
questionName, type: string
fileValue, type: any
, a single file question value
callback, type: (status: string, data: any) => any
, a call back function to get the status on downloading the file and the downloaded file content
- Implemented in:
-
SurveyModel
|
|
Gets or sets the 'Edit' button caption.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
locale
, showPreviewBeforeComplete
, previewText
, cancelPreview
|
|
Returns the text that is displayed when there are no any visible pages and questiona.
- Type:
-
string readonly
- Implemented in:
-
SurveyModel
|
|
Checks whether survey elements (pages, panels, and questions) have unique question names.
You can check for unique names for individual page and panel (and all their elements) or a question.
If the parameter is not specified, then a survey checks that all its elements have unique names.
- Type:
-
(element?: ISurveyElement) => void
- Parameters:
-
element, type: ISurveyElement
, page, panel or question, it is `null` by default, that means all survey elements will be checked
- Implemented in:
-
SurveyModel
|
|
Gets or sets whether the first survey page is a start page. Set this property to true , to make the first page a starting page.
An end user cannot navigate to the start page and the start page does not affect a survey progress.
- Type:
-
boolean writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
|
|
Sets the input focus to the first question with the input field.
- Type:
-
() => void
- Implemented in:
-
SurveyModel
|
|
Gets or sets whether the first input is focused on showing a next or a previous page.
- Type:
-
boolean writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- True
- Implemented in:
-
SurveyModel
|
|
Gets or sets whether the first input is focused if the current page has errors.
Set this property to false (the default value is true ) if you do not want to bring the focus to the first question that has error on the page.
- Type:
-
boolean writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- True
- Implemented in:
-
SurveyModel
|
|
Returns a list of all survey's panels.
- Type:
-
(visibleOnly?: boolean, includingDesignTime?: boolean) => IPanel[]
- Parameters:
-
visibleOnly, type: boolean
includingDesignTime, type: boolean
- Implemented in:
-
SurveyModel
|
|
Returns a list of all questions in a survey.
- Type:
-
(visibleOnly?: boolean, includingDesignTime?: boolean) => Question[]
- Parameters:
-
visibleOnly, type: boolean
, set it `true`, if you want to get only visible questions
includingDesignTime, type: boolean
- Implemented in:
-
SurveyModel
|
|
Returns an amount of corrected quiz answers.
- Type:
-
() => number
- Implemented in:
-
SurveyModel
|
|
Returns an amount of incorrect quiz answers.
- Type:
-
() => number
- Implemented in:
-
SurveyModel
|
|
Returns a page on which an element (question or panel) is placed.
- Type:
-
(element: IElement) => PageModel
- Parameters:
-
element, type: IElement
, Question or Panel
- Implemented in:
-
SurveyModel
|
|
Returns a page by it's name.
- Type:
-
(name: string) => PageModel
- Parameters:
-
name, type: string
- Implemented in:
-
SurveyModel
|
|
Returns a page on which a question is located.
- Type:
-
(question: IQuestion) => PageModel
- Parameters:
-
question, type: IQuestion
- Implemented in:
-
SurveyModel
|
|
Returns a list of pages by their names.
- Type:
-
(names: string[]) => PageModel[]
- Parameters:
-
names, type: string[]
, a list of page names
- Implemented in:
-
SurveyModel
|
|
Returns a panel by its name.
- Type:
-
(name: string, caseInsensitive?: boolean) => IPanel
- Parameters:
-
name, type: string
, a panel name
caseInsensitive, type: boolean
- Implemented in:
-
SurveyModel
- See also:
-
getQuestionByName
|
|
Returns survey result data as an array of plain objects: with question title , name , value , and displayValue .
For complex questions (like matrix, etc.) isNode flag is set to true and data contains array of nested objects (rows).
Set options.includeEmpty to false if you want to skip empty answers.
- Type:
-
(options?: { includeEmpty?: boolean; includeQuestionTypes?: boolean; calculations?: { propertyNam...
- Parameters:
-
options, type: { includeEmpty?: boolean; includeQuestionTypes?: boolean; calculations?: { propertyName: string; ...
- Implemented in:
-
SurveyModel
|
|
Returns the progress that a user made while going through the survey.
It depends from progressBarType property
- Type:
-
() => number
- Implemented in:
-
SurveyModel
- See also:
-
progressBarType
, progressValue
|
|
Returns a question by its name.
- Type:
-
(name: string, caseInsensitive?: boolean) => Question
- Parameters:
-
name, type: string
, a question name
caseInsensitive, type: boolean
- Implemented in:
-
SurveyModel
- See also:
-
getQuestionByValueName
|
|
Returns a question by its value name
- Type:
-
(valueName: string, caseInsensitive?: boolean) => IQuestion
- Parameters:
-
valueName, type: string
, a question name
caseInsensitive, type: boolean
- Implemented in:
-
SurveyModel
- See also:
-
getQuestionByName
, getQuestionsByValueName
, Question.valueName
|
|
Gets a list of questions by their names.
- Type:
-
(names: string[], caseInsensitive?: boolean) => IQuestion[]
- Parameters:
-
names, type: string[]
, an array of question names
caseInsensitive, type: boolean
- Implemented in:
-
SurveyModel
|
|
Returns all questions by their valueName. name property is used if valueName property is empty.
- Type:
-
(valueName: string, caseInsensitive?: boolean) => Question[]
- Parameters:
-
valueName, type: string
, a question name
caseInsensitive, type: boolean
- Implemented in:
-
SurveyModel
- See also:
-
getQuestionByName
, getQuestionByValueName
, Question.valueName
|
|
Returns quiz question number. It may be different from getQuizQuestions.length because some widgets like matrix may have several questions.
- Type:
-
() => number
- Implemented in:
-
SurveyModel
- See also:
-
getQuizQuestions
|
|
Returns quiz questions. All visible questions that has input(s) widgets.
- Type:
-
() => IQuestion[]
- Implemented in:
-
SurveyModel
- See also:
-
getQuizQuestionCount
|
|
Calls the api.surveyjs.io service and, on callback, fires the onGetResult event with all answers that your users made for a question.
- Type:
-
(resultId: string, name: string) => void
- Parameters:
-
resultId, type: string
, [api.surveyjs.io](https://api.surveyjs.io) service resultId
name, type: string
, The question name
- Implemented in:
-
SurveyModel
- See also:
-
onGetResult
|
|
Returns an array of locales that are used in the survey's translation.
- Type:
-
() => string[]
- Implemented in:
-
SurveyModel
|
|
Returns a question value (answer) by a question's name.
- Type:
-
(name: string) => any
- Parameters:
-
name, type: string
, A question name
- Implemented in:
-
SurveyModel
- See also:
-
data
, setValue
|
|
Returns a variable value. Variable, unlike values, are not stored in the survey results.
- Type:
-
(name: string) => any
- Parameters:
-
name, type: string
, A variable name
- Implemented in:
-
SurveyModel
- See also:
-
SetVariable
|
|
Returns all variables in the survey. Use setVariable function to create a new variable.
- Type:
-
() => string[]
- Implemented in:
-
SurveyModel
- See also:
-
getVariable
, setVariable
|
|
Gets or ses whether a user can navigate the next page automatically after answering all the questions on a page without pressing the "Next" button.
The available options:
true - navigate the next page and submit survey data automatically.
autogonext - navigate the next page automatically but do not submit survey data.
false - do not navigate the next page and do not submit survey data automatically.
- Type:
-
boolean | "autogonext" writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
showNavigationButtons
|
|
Returns true , if a user has already completed the survey in this browser and there is a cookie about it. Survey goes to completed state if the function returns true .
- Type:
-
boolean readonly
- Implemented in:
-
SurveyModel
- See also:
-
cookieName
, setCookie
, deleteCookie
, state
|
|
Returns true , if any of the survey pages contains errors.
- Type:
-
(fireCallback?: boolean, focusOnFirstError?: boolean) => boolean
- Parameters:
-
fireCallback, type: boolean
, set it to `true`, to show errors in UI.
focusOnFirstError, type: boolean
, set it to `true` to focus on the first question that doesn't pass the validation and make the page, where the question is located, the current.
- Implemented in:
-
SurveyModel
|
|
Gets or sets whether to hide all required errors.
- Type:
-
boolean readonly
- Implemented in:
-
SurveyModel
|
|
Gets or sets whether the survey must ignore validation like required questions and others, on nextPage and completeLastPage function calls. The default is false .
- Type:
-
boolean readonly
- Implemented in:
-
SurveyModel
- See also:
-
nextPage
, completeLastPage
, mode
|
|
Returns true , if the current page contains errors, for example, the required question is empty or a question validation is failed.
- Type:
-
boolean readonly
- Implemented in:
-
SurveyModel
- See also:
-
nextPage
|
|
Returns true if the survey is in design mode. It is used by SurveyJS Editor.
- Type:
-
boolean readonly
- Implemented in:
-
SurveyModel
- See also:
-
setDesignMode
|
|
Returns true if the survey is in display mode or in preview mode.
- Type:
-
boolean readonly
- Implemented in:
-
SurveyModel
- See also:
-
mode
, showPreviewBeforeComplete
|
|
Returns true if the survey is in edit mode.
- Type:
-
boolean readonly
- Implemented in:
-
SurveyModel
- See also:
-
mode
|
|
Returns true if the survey contains no pages. The survey is empty.
- Type:
-
boolean readonly
- Implemented in:
-
SurveyModel
|
|
Gets whether the current page is the first one.
- Type:
-
boolean readonly
- Implemented in:
-
SurveyModel
|
|
Gets whether the current page is the last one.
- Type:
-
boolean readonly
- Implemented in:
-
SurveyModel
|
|
Returns the navigation buttons (i.e., 'Prev', 'Next', or 'Complete') position.
- Type:
-
string readonly
- Implemented in:
-
SurveyModel
|
|
Obsolete. Use the questionsOnPageMode property instead.
- Type:
-
boolean writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
questionsOnPageMode
|
|
Gets whether the question values on the current page are validating on the server at the current moment.
- Type:
-
boolean readonly
- Implemented in:
-
SurveyModel
- See also:
-
onServerValidateQuestions
|
|
The list of errors on loading survey JSON. If the list is empty after loading a JSON, then the JSON is correct and has no errors.
- Type:
-
JsonError[] readonly
- Implemented in:
-
SurveyModel
- See also:
-
JsonError
|
|
The HTML that shows on loading survey Json from the api.surveyjs.io service.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
surveyId
, locale
|
|
Loads the survey JSON from the api.surveyjs.io service.
If clientId is not null and a user had completed a survey before, the survey switches to completedbefore state.
- Type:
-
(surveyId?: string, cliendId?: string) => void
- Parameters:
-
surveyId, type: string
, [api.surveyjs.io](https://api.surveyjs.io) service surveyId
cliendId, type: string
- Implemented in:
-
SurveyModel
- See also:
-
state
, onLoadedSurveyFromService
|
|
Gets or sets the survey locale. The default value it is empty, this means the 'en' locale is used.
You can set it to 'de' - German, 'fr' - French and so on. The library has built-in localization for several languages. The library has a multi-language support as well.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- You may set the following values into this property:
-
, id
, ca
, cy
, da
, de
, et
, es
, fr
, hr
, it
, lv
, lt
, hu
, nl
, no
, pl
, pt
, pt-br
, ro
, fi
, sv
, sw
, tr
, is
, cs
, gr
, bg
, mk
, ru
, tg
, ua
, he
, ar
, fa
, th
, ka
, ja
, zh-cn
, zh-tw
, ko
- Implemented in:
-
SurveyModel
|
|
Gets or sets a survey logo.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
title
|
|
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- contain
- You may set the following values into this property:
-
none
, contain
, cover
, fill
- Implemented in:
-
SurveyModel
- See also:
-
logo
|
|
Gets or sets a survey logo height.
- Type:
-
number writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- 200
- Implemented in:
-
SurveyModel
- See also:
-
logo
|
|
Gets or sets a survey logo position.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- left
- You may set the following values into this property:
-
none
, left
, right
, top
, bottom
- Implemented in:
-
SurveyModel
- See also:
-
logo
|
|
Gets or sets a survey logo width.
- Type:
-
number writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- 300
- Implemented in:
-
SurveyModel
- See also:
-
logo
|
|
- Type:
-
number writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
Question.hasComment
, Question.hasOther
, maxTextLength
|
|
Specifies the default maximum length for questions like text and comment, including matrix cell questions.
The default value is 0 , that means that the text and comment have the same max length as the standard HTML input - 524288 characters: https://www.w3schools.com/tags/att_input_maxlength.asp.
- Type:
-
number writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
maxOthersLength
|
|
Gets or sets the maximum time in seconds that end user has to complete a survey. If the value is 0 or less, an end user has no time limit to finish a survey.
- Type:
-
number writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
startTimer
, maxTimeToFinishPage
|
|
Gets or sets the maximum time in seconds that end user has to complete a page in the survey. If the value is 0 or less, an end user has no time limit.
You may override this value for every page.
- Type:
-
number writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
startTimer
, maxTimeToFinish
, PageModel.maxTimeToFinish
|
|
Merge the values into survey.data. It works as survey.data, except it doesn't clean the existing data, but overrides them.
- Type:
-
(data: any) => void
- Parameters:
-
data, type: any
, data to merge. It should be an object {keyValue: Value, ...}
- Implemented in:
-
SurveyModel
- See also:
-
data
, setValue
|
|
Gets or sets the survey edit mode.
The following options are available:
edit (default) - make a survey editable,
display - make a survey read-only.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- edit
- You may set the following values into this property:
-
edit
, display
- Implemented in:
-
SurveyModel
|
|
Set this property to a url you want to navigate after a user completing the survey.
By default it uses after calling onComplete event. In case calling options.showDataSaving callback in onComplete event, navigateToUrl will be used on calling options.showDataSavingSuccess callback.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
|
|
Gets or sets a list of URL condition items. If the expression of this item returns true , then survey will navigate to the item URL.
- Type:
-
UrlConditionItem[] writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
UrlConditionItem
, navigateToUrl
|
|
Navigates user to the next page.
Returns false in the following cases:
- if the current page is the last page.
- if the current page contains errors (for example, a required question is empty).
- Type:
-
() => boolean
- Implemented in:
-
SurveyModel
- See also:
-
isCurrentPageHasErrors
, prevPage
, completeLastPage
|
|
The event is fired right after a page is rendered in DOM. Use it to modify HTML elements.
sender - the survey object that fires the event.
options.page - a page object for which the event is fired. Typically the current/active page.
options.htmlElement - an HTML element bound to the page object.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
|
|
The event is fired right after a panel is rendered in DOM. Use it to modify HTML elements.
sender - the survey object that fires the event
options.panel - a panel object for which the event is fired
options.htmlElement - an HTML element bound to the panel object
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
|
|
The event is fired right after a question is rendered in DOM. Use it to modify HTML elements.
sender - the survey object that fires the event.
options.question - a question object for which the event is fired.
options.htmlElement - an HTML element bound to the question object.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
|
|
The event is fired right after a non-composite question (text, comment, dropdown, radiogroup, checkbox) is rendered in DOM. Use it to modify HTML elements.
This event is not fired for matrices, panels, multiple text and image picker.
sender - the survey object that fires the event.
options.question - a question object for which the event is fired.
options.htmlElement - an HTML element bound to the question object.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
|
|
The event is fired right after survey is rendered in DOM.
sender - the survey object that fires the event.
options.htmlElement - a root HTML element bound to the survey object.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
|
|
This event is fired on clearing the value in a QuestionFile. Use this event to remove files stored on your server.
sender - the survey object that fires the event.
question - the question instance.
options.name - the question name.
options.value - the question value.
options.fileName - a removed file's name, set it to null to clear all files.
options.callback - a callback function to get the operation status.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
clearFiles
, onDownloadFile
, onUploadFiles
, View Examples
|
|
The event is fired after a user clicks the 'Complete' button and finishes a survey. Use this event to send the survey data to your web server.
sender - the survey object that fires the event.
options.showDataSaving(text) - call this method to show that the survey is saving survey data on your server. The text is an optional parameter to show a custom message instead of default.
options.showDataSavingError(text) - call this method to show that an error occurred while saving the data on your server. If you want to show a custom error, use an optional text parameter.
options.showDataSavingSuccess(text) - call this method to show that the data was successfully saved on the server.
options.showDataSavingClear - call this method to hide the text about the saving progress.
options.isCompleteOnTrigger - returns true if the survey is completed on "complete" trigger.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
data
, clearInvisibleValues
, completeLastPage
, surveyPostId
|
|
The event is fired before the survey is completed and the onComplete event is fired. You can prevent the survey from completing by setting options.allowComplete to false
sender - the survey object that fires the event.
options.allowComplete - Specifies whether a user can complete a survey. Set this property to false to prevent the survey from completing. The default value is true .
options.isCompleteOnTrigger - returns true if the survey is completing on "complete" trigger.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
onComplete
|
|
The event is fired when the current page has been changed to another page. Typically it happens when a user click on 'Next' or 'Prev' buttons.
sender - the survey object that fires the event.
option.oldCurrentPage - a previous current/active page.
option.newCurrentPage - a new current/active page.
option.isNextPage - commonly means, that end-user press the next page button. In general, it means that options.newCurrentPage is the next page after options.oldCurrentPage
option.isPrevPage - commonly means, that end-user press the previous page button. In general, it means that options.newCurrentPage is the previous page before options.oldCurrentPage
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
currentPage
, currentPageNo
, nextPage
, prevPage
, completeLastPage
, onCurrentPageChanging
|
|
The event is fired before the current page changes to another page. Typically it happens when a user click the 'Next' or 'Prev' buttons.
sender - the survey object that fires the event.
option.oldCurrentPage - the previous current/active page.
option.newCurrentPage - a new current/active page.
option.allowChanging - set it to false to disable the current page changing. It is true by default.
option.isNextPage - commonly means, that end-user press the next page button. In general, it means that options.newCurrentPage is the next page after options.oldCurrentPage
option.isPrevPage - commonly means, that end-user press the previous page button. In general, it means that options.newCurrentPage is the previous page before options.oldCurrentPage
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
currentPage
, currentPageNo
, nextPage
, prevPage
, completeLastPage
, onCurrentPageChanged
|
|
The event is fired on downloading a file in QuestionFile. Use this event to pass the file to a preview.
sender - the survey object that fires the event.
options.name - the question name.
options.content - the file content.
options.fileValue - single file question value.
options.callback - a callback function to get the file downloading status and the downloaded file content.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
downloadFile
, onClearFiles
, onUploadFiles
, View Examples
|
|
Use this event to control drag&drop operations during design mode.
sender - the survey object that fires the event.
options.allow - set it to false to disable dragging.
options.target - a target element that is dragged.
options.source - a source element. It can be null , if it is a new element, dragging from toolbox.
options.parent - a page or panel where target element is dragging.
options.insertBefore - an element before the target element is dragging. It can be null if parent container (page or panel) is empty or dragging an element after the last element in a container.
options.insertAfter - an element after the target element is dragging. It can be null if parent container (page or panel) is empty or dragging element to the first position within the parent container.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
setDesignMode
, isDesignMode
|
|
The event is fired on adding a new panel in Panel Dynamic question.
sender - the survey object that fires the event.
options.question - a panel question.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
QuestionPanelDynamicModel
, QuestionPanelDynamicModel.panels
|
|
The event is fired when item value is changed in Panel Dynamic question.
sender - the survey object that fires the event.
options.question - the panel question.
options.panel - the dynamic panel item.
options.name - the item name.
options.value - a new value.
options.itemIndex - the panel item index.
options.itemValue - the panel item object.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
onDynamicPanelAdded
, QuestionPanelDynamicModel
|
|
The event is fired on removing a panel from Panel Dynamic question.
sender - the survey object that fires the event.
options.question - a panel question.
options.panelIndex - a removed panel index.
options.panel - a removed panel.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
QuestionPanelDynamicModel
, QuestionPanelDynamicModel.panels
|
|
The event is fired after the survey element content was collapsed or expanded.
sender - the survey object that fires the event.
options.element - Specifies which survey element content was collapsed or expanded.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
onElementContentVisibilityChanged
|
|
Use the event to change the default error text.
sender - the survey object that fires the event.
options.text - an error text.
options.error - an instance of the SurveyError object.
options.name - the error name. The following error names are available:
required, requireoneanswer, requirenumeric, exceedsize, webrequest, webrequestempty, otherempty,
uploadingfile, requiredinallrowserror, minrowcounterror, keyduplicationerror, custom
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
|
|
Use this event to change the question no in code. If you want to remove question numbering then set showQuestionNumbers to "off".
sender - the survey object that fires the event.
options.no - a calculated question no, based on question visibleIndex , survey .questionStartIndex properties. You can change it.
options.question - a question object.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
showQuestionNumbers
, questionStartIndex
|
|
Use this event to change the question title in code. If you want to remove question numbering then set showQuestionNumbers to "off".
sender - the survey object that fires the event.
options.title - a calculated question title, based on question title , name .
options.question - a question object.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
showQuestionNumbers
, requiredText
Show More
|
|
Use it to get results after calling the getResult method. It returns a simple analytics from api.surveyjs.io service.
sender - the survey object that fires the event.
options.success - it is true if the results were got from the service successfully.
options.data - the object {AnswersCount, QuestionResult : {} } . AnswersCount is the number of posted survey results. QuestionResult is an object with all possible unique answers to the question and number of these answers.
options.dataList - an array of objects {name, value} , where name is a unique value/answer to the question and value is a number/count of such answers.
options.response - the server response.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
getResult
|
|
Use this event to define, whether an answer to a question is correct or not.
sender - the survey object that fires the event.
options.question - a question on which you have to decide if the answer is correct or not.
options.result - returns true , if an answer is correct, or false , if the answer is not correct. Use questions' value and correctAnswer properties to return the correct value.
options.correctAnswers - you may change the default number of correct or incorrect answers in the question, for example for matrix, where each row is a quiz question.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
Question.value
, Question.correctAnswer
|
|
The event is fired after choices for radiogroup, checkbox, and dropdown has been loaded from a RESTful service and before they are assigned to a question.
You may change the choices, before they are assigned or disable/enabled make visible/invisible question, based on loaded results.
sender - the survey object that fires the event.
question - the question where loaded choices are going to be assigned.
choices - the loaded choices. You can change the loaded choices to before they are assigned to question.
serverResult - a result that comes from the server as it is.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
|
|
The event is fired after survey is loaded from api.surveyjs.io service.
You can use this event to perform manipulation with the survey model after it was loaded from the web service.
sender - the survey object that fires the event.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
surveyId
, loadSurveyFromService
|
|
The event is fired for every cell after is has been rendered in DOM.
sender - the survey object that fires the event.
options.question - the matrix question.
options.cell - the matrix cell.
options.cellQuestion - the question/editor in the cell.
options.htmlElement - an HTML element bound to the cellQuestion object.
options.column - the matrix column object.
options.row - the matrix row object.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
onMatrixCellCreated
, QuestionMatrixDynamicModel
, QuestionMatrixDropdownModel
|
|
The event is fired before rendering "Remove" button for removing a row from Matrix Dynamic question.
sender - the survey object that fires the event
options.question - a matrix question.
options.rowIndex - a row index.
options.row - a row object.
options.allow - a boolean property. Set it to false to disable the row removing.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
QuestionMatrixDynamicModel
|
|
The event is fired before adding a new row in Matrix Dynamic question.
sender - the survey object that fires the event
options.question - a matrix question.
options.canAddRow - specifies whether a new row can be added
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
QuestionMatrixDynamicModel
, QuestionMatrixDynamicModel.visibleRows
|
|
The event is fired for every cell created in Matrix Dynamic and Matrix Dropdown questions.
sender - the survey object that fires the event.
options.question - the matrix question.
options.cell - the matrix cell.
options.cellQuestion - the question/editor in the cell. You may customize it, change it's properties, like choices or visible.
options.rowValue - the value of the current row. To access a particular column's value within the current row, use: options.rowValue["columnValue"] .
options.column - the matrix column object.
options.columnName - the matrix column name.
options.row - the matrix row object.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
onMatrixBeforeRowAdded
, onMatrixRowAdded
, QuestionMatrixDynamicModel
, QuestionMatrixDropdownModel
|
|
The event is fired when Matrix Dynamic and Matrix Dropdown questions validate the cell value.
sender - the survey object that fires the event.
options.error - an error string. It is empty by default.
options.question - the matrix question.
options.columnName - the matrix column name.
options.value - a cell value.
options.row - the matrix row object.
options.getCellQuestion(columnName) - the function that returns the cell question by column name.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
onMatrixBeforeRowAdded
, onMatrixRowAdded
, QuestionMatrixDynamicModel
, QuestionMatrixDropdownModel
|
|
The event is fired when cell value is changed in Matrix Dynamic and Matrix Dropdown questions.
sender - the survey object that fires the event.
options.question - the matrix question.
options.columnName - the matrix column name.
options.value - a new value.
options.row - the matrix row object.
options.getCellQuestion(columnName) - the function that returns the cell question by column name.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
onMatrixCellValueChanging
, onMatrixBeforeRowAdded
, onMatrixRowAdded
, QuestionMatrixDynamicModel
, QuestionMatrixDropdownModel
|
|
The event is fired on changing cell value in Matrix Dynamic and Matrix Dropdown questions. You may change the options.value property to change a cell value.
sender - the survey object that fires the event.
options.question - the matrix question.
options.columnName - the matrix column name.
options.value - a new value.
options.oldValue - the old value.
options.row - the matrix row object.
options.getCellQuestion(columnName) - the function that returns a cell question by column name.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
onMatrixCellValueChanged
, onMatrixBeforeRowAdded
, onMatrixRowAdded
, QuestionMatrixDynamicModel
, QuestionMatrixDropdownModel
|
|
The event is fired on adding a new row in Matrix Dynamic question.
sender - the survey object that fires the event
options.question - a matrix question.
options.row - a new added row.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
QuestionMatrixDynamicModel
, QuestionMatrixDynamicModel.visibleRows
|
|
The event is fired on removing a row from Matrix Dynamic question.
sender - the survey object that fires the event
options.question - a matrix question
options.rowIndex - a removed row index
options.row - a removed row object
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
QuestionMatrixDynamicModel
, QuestionMatrixDynamicModel.visibleRows
|
|
The event is fired after a user clicks the 'Complete' button. The event allows you to specify the URL opened after completing a survey.
Specify the navigateToUrl property to make survey navigate to another url.
sender - the survey object that fires the event.
options.url - Specifies a URL opened after completing a survey. Set this property to an empty string to cancel the navigation and show the completed survey page.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
navigateToUrl
, navigateToUrlOnCondition
|
|
The event is fired on adding a page into survey.
sender - the survey object that fires the event.
options.page - a newly added panel object.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
PanelModel
|
|
The event is fired on changing a page visibility.
sender - the survey object that fires the event.
options.page - a page which visibility has been changed.
options.visible - a page visible boolean value.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
PageModel.visibile
, PageModel.visibileIf
|
|
The event is fired on adding a panel into survey.
sender - the survey object that fires the event.
options.panel - a newly added panel object.
options.name - a panel name.
options.index - an index of the panel in the container (a page or panel).
options.parentPanel - a container (a page or panel) where a new panel is located.
options.rootPanel - a root container, typically it is a page.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
PanelModel
|
|
The event is fired on removing a panel from survey.
sender - the survey object that fires the event.
options.panel - a removed panel object.
options.name - a panel name.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
PanelModel
|
|
The event is fired on changing a panel visibility.
sender - the survey object that fires the event.
options.panel - a panel which visibility has been changed.
options.visible - a panel visible boolean value.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
PanelModel.visibile
, PanelModel.visibileIf
|
|
The event is fired on clicking the 'Next' button if the sendResultOnPageNext is set to true . You can use it to save the intermediate results, for example, if your survey is large enough.
sender - the survey object that fires the event.
- Type:
-
Event<(sender: SurveyModel) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
sendResultOnPageNext
|
|
Use this event to modify the HTML content before rendering, for example completeHtml or loadingHtml .
options.html - specifies the modified HTML content.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
completedHtml
, loadingHtml
|
|
The event is fired on processing the text when it finds a text in brackets: {somevalue} . By default, it uses the value of survey question values and variables.
For example, you may use the text processing in loading choices from the web. If your choicesByUrl.url equals to "UrlToServiceToGetAllCities//",
you may set on this event options.value to "all" or empty string when the "state" value/question is non selected by a user.
sender - the survey object that fires the event.
options.name - the name of the processing value, for example, "state" in our example.
options.value - the value of the processing text.
options.isExists - a boolean value. Set it to true if you want to use the value and set it to false if you don't.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
|
|
Use this event to change the progress text in code.
sender - the survey object that fires the event.
options.text - a progress text, that SurveyJS will render in progress bar.
options.questionCount - a number of questions that have input(s). We do not count html or expression questions
options.answeredQuestionCount - a number of questions that have input(s) and an user has answered.
options.requiredQuestionCount - a number of required questions that have input(s). We do not count html or expression questions
options.requiredAnsweredQuestionCount - a number of required questions that have input(s) and an user has answered.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
progressBarType
|
|
The event is fired on adding a new question into survey.
sender - the survey object that fires the event.
options.question - a newly added question object.
options.name - a question name.
options.index - an index of the question in the container (page or panel).
options.parentPanel - a container where a new question is located. It can be a page or panel.
options.rootPanel - typically, it is a page.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
Question
, onQuestionCreated
|
|
The event is fired on creating a new question.
Unlike the onQuestionAdded event, this event calls for all question created in survey including inside: a page, panel, matrix cell, dynamic panel and multiple text.
or inside a matrix cell or it can be a text question in multiple text items or inside a panel of a panel dynamic.
You can use this event to set up properties to a question based on it's type for all questions, regardless where they are located, on the page or inside a matrix cell.
Please note: If you want to use this event for questions loaded from JSON then you have to create survey with empty/null JSON parameter, assign the event and call survey.fromJSON(yourJSON) function.
sender - the survey object that fires the event.
options.question - a newly created question object.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
Question
, onQuestionAdded
|
|
The event is fired on removing a question from survey.
sender - the survey object that fires the event.
options.question - a removed question object.
options.name - a question name.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
Question
|
|
Use this event to control scrolling element to top. You can cancel the default behavior by setting options.cancel property to true.
sender - the survey object that fires the event.
options.element - an element that is going to be scrolled on top.
options.question - a question that is going to be scrolled on top. It can be null if options.page is not null.
options.page - a page that is going to be scrolled on top. It can be null if options.question is not null.
options.elementId - the unique element DOM Id.
options.cancel - set this property to true to cancel the default scrolling.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
|
|
The event fires when it gets response from the api.surveyjs.io service on saving survey results. Use it to find out if the results have been saved successfully.
sender - the survey object that fires the event.
options.success - it is true if the results has been sent to the service successfully.
options.response - a response from the service.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
|
|
Use this event to validate data on your server.
sender - the survey object that fires the event.
options.data - the values of all non-empty questions on the current page. You can get a question value as options.data["myQuestionName"] .
options.errors - set your errors to this object as: options.errors["myQuestionName"] = "Error text"; . It will be shown as a question error.
options.complete() - call this function to tell survey that your server callback has been processed.
- Type:
-
any readonly
- Implemented in:
-
SurveyModel
- See also:
-
onValidateQuestion
, onValidatePanel
|
|
The event is fired before errors are assigned to a question. You may add/remove/modify errors for a question.
sender - the survey object that fires the event.
options.question - a validated question.
options.errors - the list of errors. The list is empty by default and remains empty if a validated question has no errors.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
onValidateQuestion
|
|
The event is fired after the survey changed it's state from "starting" to "running". The "starting" state means that survey shows the started page.
The firstPageIsStarted property should be set to true , if you want to display a start page in your survey. In this case, an end user should click the "Start" button to start the survey.
- Type:
-
Event<(sender: SurveyModel) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
firstPageIsStarted
|
|
Use this event to process the markdown text.
sender - the survey object that fires the event.
options.element - SurveyJS element (a question, panel, page, or survey) where the string is going to be rendered.
options.name - a property name is going to be rendered.
options.text - a text that is going to be rendered.
options.html - an HTML content. It is null by default. Use this property to specify the HTML content rendered instead of options.text .
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
|
|
Use this event to specity render component name used for text rendering.
sender - the survey object that fires the event.
options.element - SurveyJS element (a question, panel, page, or survey) where the string is going to be rendered.
options.name - a property name is going to be rendered.
options.renderAs - a component name used for text rendering.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
|
|
The event is fired every second if the method startTimer has been called.
- Type:
-
Event<(sender: SurveyModel) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
startTimer
, timeSpent
, Page.timeSpent
|
|
The event is fired before displaying a new information in the Timer Panel. Use it to change the default text.
sender - the survey object that fires the event.
options.text - the timer panel info text.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
|
|
The event is fired before rendering a page. Use it to override the default page CSS classes.
sender - the survey object that fires the event.
options.page - a page for which you can change the CSS classes.
options.cssClasses - an object with CSS classes. For example {title: "sv_p_title", description: "small"} . You can change them to your own CSS classes.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
|
|
The event is fired before rendering a panel. Use it to override the default panel CSS classes.
sender - the survey object that fires the event.
options.panel - a panel for which you can change the CSS classes.
options.cssClasses - an object with CSS classes. For example {title: "sv_p_title", description: "small"} . You can change them to your own CSS classes.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
|
|
The event is fired before rendering a question. Use it to override the default question CSS classes.
sender - the survey object that fires the event.
options.question - a question for which you can change the CSS classes.
options.cssClasses - an object with CSS classes. For example {root: "table", button: "button"} . You can change them to your own CSS classes.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
|
|
The event is fired on uploading the file in QuestionFile when storeDataAsText is set to false . Use this event to change the uploaded file name or to prevent a particular file from being uploaded.
sender - the survey object that fires the event.
options.question - the file question instance.
options.name - the question name.
options.files - the Javascript File objects array to upload.
options.callback - a callback function to get the file upload status and the updloaded file content.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
uploadFiles
, QuestionFileModel.storeDataAsText
, onDownloadFile
, onClearFiles
, View Examples
|
|
Use the this event to be notified when the survey finished validate questions on the current page. It commonly happens when a user try to go to the next page or complete the survey
options.questions - the list of questions that have errors
options.errors - the list of errors
options.page - the page where question(s) are located
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
|
|
Use this event to modify the HTML before rendering, for example HTML on a completed page.
sender - the survey object that fires the event.
options.html - an HTML that you may change before text processing and then rendering.
The event is fired on validating a panel. Set your error to options.error and survey will show the error for the panel and block completing the survey or going to the next page.
sender - the survey object that fires the event.
options.name - a panel name.
options.error - an error string. It is empty by default.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
completedHtml
, loadingHtml
, QuestionHtmlModel.html
, onValidateQuestion
|
|
The event is fired on validating value in a question. You can specify a custom error message using options.error . The survey blocks completing the survey or going to the next page when the error messages are displayed.
sender - the survey object that fires the event.
options.question - a validated question.
options.name - a question name.
options.value - the current question value (answer).
options.error - an error string. It is empty by default.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
onServerValidateQuestions
, onSettingQuestionErrors
|
|
The event is fired when the question value (i.e., answer) has been changed. The question value can be changed in UI (by a user) or programmatically (on calling setValue method).
Use the onDynamicPanelItemValueChanged and onMatrixCellValueChanged events to handle changes in a question in the Panel Dynamic and a cell question in matrices.
sender - the survey object that fires the event.
options.name - the value name that has been changed.
options.question - a question which question.name equals to the value name. If there are several questions with the same name, the first question is used. If there is no such questions, the options.question is null .
options.value - a new value.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
setValue
, onValueChanging
, onDynamicPanelItemValueChanged
, onMatrixCellValueChanged
|
|
The event is fired before the question value (answer) is changed. It can be done via UI by a user or programmatically on calling the setValue method.
sender - the survey object that fires the event.
options.name - the value name that has being changed.
options.question - a question which question.name equals to the value name. If there are several questions with the same name, the first question is used. If there is no such questions, the options.question is null.
options.oldValue - an old, previous value.
options.value - a new value. You can change it.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
setValue
, onValueChanged
|
|
The event is fired when a question visibility has been changed.
sender - the survey object that fires the event.
options.question - a question which visibility has been changed.
options.name - a question name.
options.visible - a question visible boolean value.
- Type:
-
Event<(sender: SurveyModel, options: any) => any, any>
- Implemented in:
-
SurveyModel
- See also:
-
Question.visibile
, Question.visibileIf
|
|
Returns the survey page count.
- Type:
-
number readonly
- Implemented in:
-
SurveyModel
- See also:
-
visiblePageCount
, pages
|
|
Gets or sets the 'Next' button caption.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
locale
|
|
Gets or sets the 'Prev' button caption.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
locale
|
|
Returns a list of all pages in the survey, including invisible pages.
- Type:
-
PageModel[] readonly
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
PageModel
, visiblePages
|
|
Gets or sets the 'Preview' button caption.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
locale
, showPreviewBeforeComplete
, editText
, showPreview
|
|
Navigates user to a previous page. If the current page is the first page, prevPage returns false . prevPage does not perform any checks, required questions can be empty.
- Type:
-
() => boolean
- Implemented in:
-
SurveyModel
- See also:
-
isFirstPage
|
|
Returns the HTML content, that is shown to a user that had completed the survey before.
- Type:
-
string readonly
- Implemented in:
-
SurveyModel
- See also:
-
completedHtml
, cookieName
|
|
Returns the HTML content for the complete page.
- Type:
-
string readonly
- Implemented in:
-
SurveyModel
- See also:
-
completedHtml
|
|
Returns the HTML content, that is shows when a survey loads the survey JSON.
- Type:
-
string readonly
- Implemented in:
-
SurveyModel
|
|
Returns the text/HTML that is rendered as a survey title.
- Type:
-
string readonly
- Implemented in:
-
SurveyModel
|
|
Gets or sets the type of info in the progress bar.
The following options are available:
pages (default),
questions ,
requiredQuestions ,
correctQuestions ,
buttons
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- pages
- You may set the following values into this property:
-
pages
, questions
, requiredQuestions
, correctQuestions
, buttons
- Implemented in:
-
SurveyModel
|
|
Returns the text for the current progress.
- Type:
-
string readonly
- Implemented in:
-
SurveyModel
|
|
Returns the progress that a user made while going through the survey.
It depends from progressBarType property
- Type:
-
number readonly
- Implemented in:
-
SurveyModel
- See also:
-
progressBarType
|
|
Gets or sets the question description position.
The following options are available:
underTitle - show question description under the question title,
underInput - show question description under the question input instead of question title.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- underTitle
- You may set the following values into this property:
-
underInput
, underTitle
- Implemented in:
-
SurveyModel
|
|
Gets or sets the error message position.
The following options are available:
top - to show question error(s) over the question,
bottom - to show question error(s) under the question.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- top
- You may set the following values into this property:
-
top
, bottom
- Implemented in:
-
SurveyModel
|
|
Gets or sets a value that specifies how the survey combines questions, panels, and pages.
The following options are available:
singlePage - combine all survey pages in a single page. Pages will be converted to panels.
questionPerPage - show one question per page. Survey will create a separate page for every question.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- standard
- You may set the following values into this property:
-
singlePage
, standard
, questionPerPage
- Implemented in:
-
SurveyModel
|
|
Gets or sets the question display order. Use this property to randomize questions. You can randomize questions on a specific page.
The following options are available:
random - randomize questions
initial - keep questions in the same order, as in a survey model.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- initial
- You may set the following values into this property:
-
initial
, random
- Implemented in:
-
SurveyModel
- See also:
-
SurveyPage.questionsOrder
|
|
Gets or sets the first question index. The first question index is '1' by default. You may start it from '100' or from 'A', by setting '100' or 'A' to this property.
You can set the start index to "(1)" or "# A)" or "a)" to render question number as (1), # A) and a) accordingly.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
Question.title
, requiredText
|
|
Gets or sets the question title location.
The following options are available:
bottom - show a question title to bottom
left - show a question title to left
top - show a question title to top.
Some questions, for example matrixes, do not support 'left' value. The title for them will be displayed to the top.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- top
- You may set the following values into this property:
-
top
, bottom
, left
- Implemented in:
-
SurveyModel
|
|
Set the pattern for question title. Default is "numTitleRequire", 1. What is your name? *,
You can set it to numRequireTitle: 1. * What is your name?
You can set it to requireNumTitle: * 1. What is your name?
You can set it to numTitle (remove require symbol completely): 1. What is your name?
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- numTitleRequire
- Implemented in:
-
SurveyModel
- See also:
-
QuestionModel.title
|
|
Gets or sets a question title template. Obsolete, please use questionTitlePattern
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
QuestionModel.title
, questionTitlePattern
|
|
Removes a page from a survey.
- Type:
-
(page: PageModel) => void
- Parameters:
-
page, type: PageModel
- Implemented in:
-
SurveyModel
|
|
Gets or sets the required question mark. The required question mark is a char or string that is rendered in the required questions' titles.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- *
- Implemented in:
-
SurveyModel
- See also:
-
Question.title
|
|
Calculates a given expression and returns true or false .
- Type:
-
(expression: string) => boolean
- Parameters:
-
expression, type: string
- Implemented in:
-
SurveyModel
|
|
Calculates a given expression and returns a result value.
- Type:
-
(expression: string) => any
- Parameters:
-
expression, type: string
- Implemented in:
-
SurveyModel
|
|
Run all triggers that performs on value changed and not on moving to the next page.
- Type:
-
() => void
- Implemented in:
-
SurveyModel
|
|
- Type:
-
(postId?: string, clientId?: string, isPartialCompleted?: boolean) => void
- Parameters:
-
postId, type: string
, [api.surveyjs.io](https://api.surveyjs.io) service postId
clientId, type: string
, Typically a customer e-mail or an identifier
isPartialCompleted, type: boolean
, Set it to `true` if the survey is not completed yet and the results are intermediate
- Implemented in:
-
SurveyModel
- See also:
-
surveyPostId
, clientId
|
|
Gets or sets whether to save survey results on completing every page. If the property value is set to true , the onPartialSend event is fired.
- Type:
-
boolean writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
onPartialSend
, clientId
|
|
Set the cookie with cookieName in user's browser. It is done automatically on survey complete if the cookieName property value is not empty.
- Type:
-
() => void
- Implemented in:
-
SurveyModel
- See also:
-
cookieName
, hasCookie
, deleteCookie
|
|
Sets the survey into design mode.
- Type:
-
(value: boolean) => void
- Parameters:
-
value, type: boolean
, use true to set the survey into the design mode.
- Implemented in:
-
SurveyModel
|
|
Sets a question value (answer). It runs all triggers and conditions (visibleIf properties).
Goes to the next page if goNextPageAutomatic is true and all questions on the current page are answered correctly.
- Type:
-
(name: string, newQuestionValue: any, locNotification?: any, allowNotifyValueChanged?: boolean) =...
- Parameters:
-
name, type: string
, A question name
newQuestionValue, type: any
locNotification, type: any
allowNotifyValueChanged, type: boolean
- Implemented in:
-
SurveyModel
- See also:
-
data
, getValue
, PageModel.visibleIf
, Question.visibleIf
, goNextPageAutomatic
|
|
Sets a variable value. Variable, unlike values, are not stored in the survey results.
- Type:
-
(name: string, newValue: any) => void
- Parameters:
-
name, type: string
, A variable name
newValue, type: any
, A variable new value
- Implemented in:
-
SurveyModel
- See also:
-
GetVariable
|
|
On finishing the survey the complete page is shown. Set the property to false , to hide the complete page.
- Type:
-
boolean writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- True
- Implemented in:
-
SurveyModel
- See also:
-
data
, onComplete
, navigateToUrl
|
|
Gets or sets whether to show all elements in the survey, regardless their visibility. The default value is false .
- Type:
-
boolean writable
- Implemented in:
-
SurveyModel
|
|
Gets or sets the navigation buttons position.
Possible values: 'bottom' (default), 'top', 'both' and 'none'. Set it to 'none' to hide 'Prev', 'Next' and 'Complete' buttons.
It makes sense if you are going to create a custom navigation, have only a single page, or the goNextPageAutomatic property is set to true .
- Type:
-
any writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- bottom
- You may set the following values into this property:
-
none
, top
, bottom
, both
- Implemented in:
-
SurveyModel
- See also:
-
goNextPageAutomatic
, showPrevButton
|
|
Gets or sets whether the survey displays page numbers on pages titles.
- Type:
-
boolean writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
|
|
Gets or sets whether the Survey displays page titles. Set it to false to hide page titles.
- Type:
-
boolean writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- True
- Implemented in:
-
SurveyModel
- See also:
-
PageModel.title
|
|
Gets or sets whether the Survey displays "Prev" button in its pages. Set it to false to prevent end-users from going back to their answers.
- Type:
-
boolean writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- True
- Implemented in:
-
SurveyModel
- See also:
-
showNavigationButtons
|
|
Shows preview for the survey. Switches the survey to the "preview" state.
Details: Preview State
- Type:
-
() => boolean
- Implemented in:
-
SurveyModel
- See also:
-
showPreviewBeforeComplete
, cancelPreview
, state
, previewText
, editText
|
|
Set this property to "showAllQuestions" or "showAnsweredQuestions" to allow respondents to preview answers before submitting the survey results.
Details: Preview State
Example: Show Preview Before Complete
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- noPreview
- You may set the following values into this property:
-
noPreview
, showAllQuestions
, showAnsweredQuestions
- Implemented in:
-
SurveyModel
- See also:
-
showPreview
, cancelPreview
, state
, previewText
, editText
|
|
Gets or sets the survey progress bar position.
The following options are available:
off (default) - don't show progress bar
top - show progress bar in the top
bottom - show progress bar in the bottom
both - show progress bar in both sides: top and bottom.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- off
- You may set the following values into this property:
-
off
, top
, bottom
, both
- Implemented in:
-
SurveyModel
|
|
Gets or sets a value that specifies how the question numbers are displayed.
The following options are available:
on - display question numbers
onpage - display question numbers, start numbering on every page
off - turn off the numbering for questions titles
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- on
- You may set the following values into this property:
-
on
, onPage
, off
- Implemented in:
-
SurveyModel
|
|
Gets or sets a timer panel position. The timer panel displays information about how much time an end user spends on a survey/page.
The available options:
top - display timer panel in the top.
bottom - display timer panel in the bottom.
none - do not display a timer panel.
If the value is not equal to 'none', the survey calls the startTimer() method on survey rendering.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- none
- You may set the following values into this property:
-
none
, top
, bottom
- Implemented in:
-
SurveyModel
- See also:
-
showTimerPanelMode
, startTimer
, stopTimer
|
|
Gets or set a value that specifies whether the timer displays information for the page or for the entire survey.
The available options:
page - show timer information for page
survey - show timer information for survey
Use the onTimerPanelInfoText event to change the default text.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- all
- You may set the following values into this property:
-
all
, page
, survey
- Implemented in:
-
SurveyModel
- See also:
-
showTimerPanel
, onTimerPanelInfoText
|
|
Gets or sets whether the Survey displays survey title in its pages. Set it to false to hide a survey title.
- Type:
-
boolean writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- True
- Implemented in:
-
SurveyModel
- See also:
-
title
|
|
Starts the survey. Changes the survey mode from "starting" to "running". Call this function if your survey has a start page, otherwise this function does nothing.
- Type:
-
() => boolean
- Implemented in:
-
SurveyModel
- See also:
-
firstPageIsStarted
|
|
Returns the started page. This property works if the firstPageIsStarted property is set to true .
- Type:
-
PageModel readonly
- Implemented in:
-
SurveyModel
- See also:
-
firstPageIsStarted
|
|
Gets or sets the 'Start' button caption.
The 'Start' button is shown on the started page. Set the firstPageIsStarted property to true , to display the started page.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
firstPageIsStarted
, locale
|
|
Starts a timer that will calculate how much time end-user spends on the survey or on pages.
- Type:
-
() => void
- Implemented in:
-
SurveyModel
- See also:
-
stopTimer
, timeSpent
|
|
Returns the current survey state:
loading - the survey is being loaded from JSON,
empty - there is nothing to display in the current survey,
starting - the survey's start page is displayed,
running - a respondent is answering survey questions right now,
preview - a respondent is previewing answered questions before submitting the survey (see example),
completed - a respondent has completed the survey and submitted the results.
Details: Preview State
- Type:
-
string readonly
- Implemented in:
-
SurveyModel
|
|
- Type:
-
() => void
- Implemented in:
-
SurveyModel
- See also:
-
startTimer
, timeSpent
|
|
Gets or sets an identifier of a survey model loaded from the api.surveyjs.io service. When specified, the survey JSON is automatically loaded from api.surveyjs.io service.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
loadSurveyFromService
, onLoadedSurveyFromService
|
|
Gets or sets an identifier of a survey model saved to the api.surveyjs.io service. When specified, the survey data is automatically saved to the api.surveyjs.io service.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
onComplete
, surveyShowDataSaving
|
|
Gets or sets whether to show the progress on saving/sending data into the api.surveyjs.io service.
- Type:
-
boolean writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
surveyPostId
|
|
Gets or sets a value that specifies how the survey updates its questions' text values.
The following options are available:
onBlur (default) - the value is updated after an input loses the focus.
onTyping - update the value of text questions, "text" and "comment", on every key press.
Note, that setting to "onTyping" may lead to a performance degradation, in case you have many expressions in the survey.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- The default value is:
- onBlur
- You may set the following values into this property:
-
onBlur
, onTyping
- Implemented in:
-
SurveyModel
|
|
Returns the time in seconds an end user spends on the survey
- Type:
-
number readonly
- Implemented in:
-
SurveyModel
- See also:
-
startTimer
, PageModel.timeSpent
|
|
Gets or sets a survey title.
- Type:
-
string writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
description
|
|
Gets or sets a list of triggers in the survey.
- Type:
-
SurveyTrigger[] writable
The property is serializable. It is stored in survey json and you can edit it in the SurveyJS Creator.
- Implemented in:
-
SurveyModel
- See also:
-
SurveyTrigger
|
|
Uploads a file to server.
- Type:
-
(question: IQuestion, name: string, files: File[], uploadingCallback: (status: string, data: any)...
- Parameters:
-
question, type: IQuestion
, a file question object
name, type: string
, a question name
files, type: File[]
, files to upload
uploadingCallback, type: (status: string, data: any) => any
, a call back function to get the status on uploading the files
- Implemented in:
-
SurveyModel
|
|
Returns a number of visible pages within the survey.
- Type:
-
number readonly
- Implemented in:
-
SurveyModel
- See also:
-
pageCount
, visiblePages
|
|
Returns a list of visible pages. If all pages are visible, then this property returns the same list as the pages property.
- Type:
-
PageModel[] readonly
- Implemented in:
-
SurveyModel
- See also:
-
pages
, PageModel.visible
, PageModel.visibleIf
|