Add an element into Panel or Page. Returns true if the element added successfully. Otherwise returns false.

Creates a new panel and adds it into the end of the elements list. Returns null, if the panel could not be created or could not be added into page or panel.

Creates a new question and adds it at location of index, by default the end of the elements list. Returns null, if the question could not be created or could not be added into page or panel.

Add a panel into Panel or Page. Returns true if the panel added successfully. Otherwise returns false.

Fill list array with the panels.

Add a question into Panel or Page. Returns true if the question added successfully. Otherwise returns false.

Fill list array with the questions.

The property returns true, if the elements are randomized on the page

Call this function to clear all errors in the panel / page and all its child elements (panels and questions)

Call this function to remove all question values from the current page/panel, that end-user will not be able to enter. For example the value that doesn't exists in a radigroup/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.

Make a clone of the existing object. Create a new object of the same type and load all properties into it.

Collapse the Element

Returns true if the current element belongs to the Panel/Page. It looks in nested Panels as well.

Returns true if a question or a container (panel/page) or their chidren have an error. The value can be out of date. hasErrors function should be called to get the correct value.

Returns all css classes that used for rendering the question, panel or page. You can use survey.onUpdateQuestionCssClasses event to override css classes for a question, survey.onUpdatePanelCssClasses event for a panel and survey.onUpdatePageCssClasses for a page.

Question, Panel and Page description. It renders under element title by using smaller font. Unlike the question title, description can be empty. Please note, this property is hidden for questions without input, for example html question.

Returns the list of the elements in the object, Panel/Page. Elements can be questions or panels. The function doesn't return elements in the nested Panels.

An expression that returns true or false. If it returns false the Panel/Page becomes read only and an end-user will not able to answer on qustions inside it. The library runs the expression on survey start and on changing a question value. If the property is empty then readOnly property is used.

The list of errors. It is created by callig hasErrors functions

Expand the Element

Call it to focus the input of the first question that has an error.

Call it to focus the input on the first question

Load object properties and elements. It doesn't reset properties that was changed before and they are not defined in the json parameter.

Returns question comments on the current page

Return questions values as a JSON object with display text. For example, for dropdown, it would return the item text instead of item value.

Returns the element by its name. It works recursively.

Returns the current survey locale

Returns the list of all panels in the page

Returns the serializable property that belongs to this instance by property name. It returns null if the property is not exists.

Returns the property value by name

Returns the question by its name

Returns the element template name without prefix. Typically it equals to getType().

Returns the type of the object as a string as it represents in the json. It should be in lowcase.

Returns the type of the object as a string as it represents in the json. It should be in lowcase.

Returns question values on the current page

Returns true, if there is an error on this Page or inside the current Panel

A unique element identificator. It is generated automatically.

Returns the index of element parameter in the elements list.

Returns true if the object is inluded into survey, otherwise returns false.

Returns true if the current object is Page and it is the current page.

Returns true if the Element is in the collapsed state

Returns true if the question in design mode right now.

Returns true if the Element is in the expanded state

Returns true if the object is loading from Json at the current moment.

Returns true if it is a page.

Returns true if the current object is Panel. Returns false if the current object is Page (a root Panel).

Returns true if it is a panel.

Returns true if it is a question.

Returns true if readOnly property is true or survey is in display mode or parent panel/page is readOnly.

Set this property to true, to require the answer at least in one question in the panel.

Returns true, if the page is started page in the survey. It can be shown on the start only and the end-user could not comeback to it after it passed it.

Returns true if a value undefined, null, empty string or empty array.

Returns true if object is visible or survey is in design mode right now.

The maximum time in seconds that end-user has to complete the page. If the value is 0 or less, the end-user has unlimited number of time to finish the page.

This is the identifier of a survey element - question or panel.

Set this property to "hide" to make "Prev", "Next" and "Complete" buttons are invisible for this page. Set this property to "show" to make these buttons visible, even if survey showNavigationButtons property is false.

Use this property to show title in navigation buttons. If the value is empty then page name is used.

Event that raised on changing property of the ItemValue object. sender - the object that owns the property options.propertyName - the property name to which ItemValue array is belong. It can be "choices" for dropdown question options.obj - the instance of ItemValue object which property has been changed options.name - the property of ItemObject that has been changed options.oldValue - old value options.newValue - new value

Event that raise on property change of the sender object sender - the object that owns the property options.name - the property name that has been changed options.oldValue - old value. Please note, it equals to options.newValue if property is an array options.newValue - new value.

A parent element. It is always null for the Page object and always not null for the Panel object. Panel object may contain Questions and other Panels.

Returns rendered title text or html.

Returns the list of all questions located in the Panel/Page, including in the nested Panels.

Use this property to randomize questions. Set it to 'random' to randomize questions, 'initial' to keep them in the same order or 'default' to use the Survey questionsOrder property

Set this property different from "default" to set the specific question title location for this panel/page.

Set it to true to make an element question/panel/page readonly. Please note, this property is hidden for question without input, for example html question.

Register a function that will be called on a property value changed from the names list.

Register a function that will be called on a property value changed.

Remove an element (Panel or Question) from the elements list.

Remove question from the elements list.

The custom text that will be shown on required error. Use this property, if you do not want to show the default text.

An expression that returns true or false. If it returns true the Panel/Page becomes required. The library runs the expression on survey start and on changing a question value. If the property is empty then isRequired property is used.

Returns the char/string for a required panel.

Call it to scroll to the page top.

set property value

Set this property to "collapsed" to render only Panel title and expanded button and to "expanded" to render the collapsed button in the Panel caption

Returns the survey object.

Time in seconds end-user spent on this page

Question, Panel, Page and Survey title. If page and panel is empty then they are not rendered. Question renders question name if the title is empty. Use survey questionTitleTemplate property to change the title question rendering.

Toggle element's state

Deserialized the current object into JSON

Unregister notification on property value changed for all properties in the names list.

Unregister notification on property value changed

Use it to get/set the object visibility.

An expression that returns true or false. If it returns true the Panel becomes visible and if it returns false the Panel becomes invisible. The library runs the expression on survey start and on changing a question value. If the property is empty then visible property is used.

The visible index of the page. It has values from 0 to visible page count - 1.

The property returns true, if the page has been shown to the end-user.