survey-react 1.9.74 → 1.9.76
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +10 -208
- package/defaultV2.css +100 -61
- package/defaultV2.min.css +2 -2
- package/modern.css +52 -15
- package/modern.min.css +2 -2
- package/package.json +1 -1
- package/survey.css +13 -20
- package/survey.min.css +2 -2
- package/survey.react.d.ts +86 -9
- package/survey.react.js +386 -114
- package/survey.react.min.js +3 -3
package/README.md
CHANGED
|
@@ -1,214 +1,16 @@
|
|
|
1
|
-
|
|
1
|
+
# SurveyJS Form Library for React (OBSOLETE)
|
|
2
2
|
|
|
3
|
-
|
|
3
|
+
SurveyJS Form Library is a free and open-source MIT-licensed JavaScript form builder library that allows you to design dynamic, data-driven, multi-language survey forms and run them in your web applications.
|
|
4
4
|
|
|
5
|
-
[
|
|
6
|
-
[](LICENSE)
|
|
7
|
-
<a href="https://github.com/DevExpress/testcafe">
|
|
8
|
-
<img alt="Tested with TestCafe" src="https://img.shields.io/badge/tested%20with-TestCafe-2fa4cf.svg">
|
|
9
|
-
</a>
|
|
10
|
-
<a href="https://github.com/surveyjs/survey-library/issues">
|
|
11
|
-
<img alt="Issues" title="Open Issues" src="https://img.shields.io/github/issues/surveyjs/survey-library.svg">
|
|
12
|
-
</a>
|
|
13
|
-
<a href="https://github.com/surveyjs/survey-library/issues?utf8=%E2%9C%93&q=is%3Aissue+is%3Aclosed+">
|
|
14
|
-
<img alt="Closed issues" title="Closed Issues" src="https://img.shields.io/github/issues-closed/surveyjs/survey-library.svg">
|
|
15
|
-
</a>
|
|
5
|
+
> **NOTE**: This package contains an obsolete Knockout-dependent version of SurveyJS Form Library for React. We recommend using a new [native implementation of SurveyJS React Form Library](https://www.npmjs.com/package/survey-react-ui). For information on how to integrate it into your application, refer to the following tutorial: [Add a Survey to a React Application](https://surveyjs.io/form-library/documentation/get-started-react).
|
|
16
6
|
|
|
17
|
-
##
|
|
7
|
+
## Resources
|
|
18
8
|
|
|
19
|
-
[
|
|
9
|
+
- [Website](https://surveyjs.io/)
|
|
10
|
+
- [Documentation](https://surveyjs.io/Documentation/Library)
|
|
11
|
+
- [Live Examples](https://surveyjs.io/form-library/examples/nps-question/reactjs)
|
|
12
|
+
- [What's New](https://surveyjs.io/WhatsNew)
|
|
20
13
|
|
|
21
|
-
##
|
|
14
|
+
## Licensing
|
|
22
15
|
|
|
23
|
-
|
|
24
|
-
|
|
25
|
-
## Survey Creator / Form Builder
|
|
26
|
-
|
|
27
|
-
[Create your Survey or Form now](https://surveyjs.io/create-survey)
|
|
28
|
-
|
|
29
|
-
Survey Creator sources are [here](https://github.com/surveyjs/survey-creator)
|
|
30
|
-
|
|
31
|
-
## Export Survey to PDF
|
|
32
|
-
|
|
33
|
-
[Export to PDF overview](https://surveyjs.io/Overview/Survey-Pdf-Export)
|
|
34
|
-
|
|
35
|
-
Export to PDF sources are [here](https://github.com/surveyjs/survey-pdf)
|
|
36
|
-
|
|
37
|
-
## More info about SurveyJS
|
|
38
|
-
|
|
39
|
-
**SurveyJS** is the most feature-rich Survey / Form Library available at the current moment. It can be easily customized and extended to suit your needs.
|
|
40
|
-
|
|
41
|
-
|
|
42
|
-
|
|
43
|
-
## Main Features
|
|
44
|
-
|
|
45
|
-
### A lot of question types with a lot of built-in functionalities.
|
|
46
|
-
|
|
47
|
-
* [Text Question](https://surveyjs.io/Examples/Library/?id=questiontype-text)
|
|
48
|
-
* [Radigroup Question](https://surveyjs.io/Examples/Library/?id=questiontype-radiogroup)
|
|
49
|
-
* [Dropdown Question](https://surveyjs.io/Examples/Library/?id=questiontype-dropdown)
|
|
50
|
-
* [Checkboxes Question](https://surveyjs.io/Examples/Library/?id=questiontype-checkbox)
|
|
51
|
-
* [Boolean Question](https://surveyjs.io/Examples/Library/?id=questiontype-boolean)
|
|
52
|
-
* [Matrix Question](https://surveyjs.io/Examples/Library/?id=questiontype-matrix)
|
|
53
|
-
* [Matrix Rubric Question](https://surveyjs.io/Examples/Library/?id=questiontype-matrix-rubric)
|
|
54
|
-
* [Matrix Dropdown Question](https://surveyjs.io/Examples/Library/?id=questiontype-matrixdropdown)
|
|
55
|
-
* [Matrix Dynamic Question](https://surveyjs.io/Examples/Library/?id=questiontype-matrixdynamic)
|
|
56
|
-
* [Multiple Text Question](https://surveyjs.io/Examples/Library/?id=questiontype-multipletext)
|
|
57
|
-
* [Rating Question](https://surveyjs.io/Examples/Library/?id=questiontype-rating)
|
|
58
|
-
* [Ranking Question](https://surveyjs.io/Examples/Library?id=questiontype-ranking)
|
|
59
|
-
* [Comment Question](https://surveyjs.io/Examples/Library/?id=questiontype-comment)
|
|
60
|
-
* [Html Question](https://surveyjs.io/Examples/Library/?id=questiontype-html)
|
|
61
|
-
* [Files uploading Question](https://surveyjs.io/Examples/Library/?id=questiontype-file)
|
|
62
|
-
* [Panel Container](https://surveyjs.io/Examples/Library/?id=questiontype-panel)
|
|
63
|
-
* [Panel Dynamic Question](https://surveyjs.io/Examples/Library/?id=questiontype-paneldynamic)
|
|
64
|
-
* [Expression Question](https://surveyjs.io/Examples/Library/?id=questiontype-expression)
|
|
65
|
-
* [Image Picker Question](https://surveyjs.io/Examples/Library/?id=questiontype-imagepicker)
|
|
66
|
-
* [Support for third-party popular UI widgets](https://surveyjs.io/Examples/Library/?id=custom-widget-select2). The custom widgets [GitHub repo](https://github.com/surveyjs/widgets)
|
|
67
|
-
|
|
68
|
-
### Multiple Pages Support
|
|
69
|
-
|
|
70
|
-
You may create a very complex forms with a lot of pages, like [this one](https://surveyjs.io/Examples/Library/?id=real-patient-history).
|
|
71
|
-
|
|
72
|
-
### Dynamically change survey logic and questions content
|
|
73
|
-
|
|
74
|
-
* [Change questions visibility using logical expressions](https://surveyjs.io/Examples/Library/?id=condition-kids)
|
|
75
|
-
* [Create custom functions to use it in expression](https://surveyjs.io/Examples/Library/?id=condition-customfunctions)
|
|
76
|
-
* [Filter choices in checkbox, radiogroup and dropdown questions](https://surveyjs.io/Examples/Library/?id=condition-choicesVisibleIf)
|
|
77
|
-
* [Filter rows and columns in matrix question](https://surveyjs.io/Examples/Library/?id=condition-matrixVisibleIf)
|
|
78
|
-
* [Disabled/enabled questions based on logical expressions](https://surveyjs.io/Examples/Library/?id=condition-enable-kids)
|
|
79
|
-
* [Questions value validation](https://surveyjs.io/Examples/Library/?id=validators-standard)
|
|
80
|
-
|
|
81
|
-
### Localization and Multiple language support
|
|
82
|
-
|
|
83
|
-
* [Localization for over 20 languages](https://surveyjs.io/Examples/Library/?id=survey-localization&platform)
|
|
84
|
-
* [Multiple language support in one survey](https://surveyjs.io/Examples/Library/?id=survey-multilanguages)
|
|
85
|
-
|
|
86
|
-
### Appearance and custom Rendering
|
|
87
|
-
|
|
88
|
-
* [Seven built-in Themes](https://surveyjs.io/Examples/Library/?id=darkblue-theme)
|
|
89
|
-
* [Bootstrap support](https://surveyjs.io/Examples/Library/?id=bootstrap-theme)
|
|
90
|
-
* [CSS styles customization](https://surveyjs.io/Examples/Library/?id=survey-cssclasses)
|
|
91
|
-
* [API for adding new or changing existing HTML elements](https://surveyjs.io/Examples/Library/?id=survey-afterrender)
|
|
92
|
-
* [Render Questions in one line](https://surveyjs.io/Examples/Library/?id=survey-startwithnewline)
|
|
93
|
-
* [Markdown support](https://surveyjs.io/Examples/Library/?id=survey-markdown-radiogroup)
|
|
94
|
-
|
|
95
|
-
### Frequently used functionalities
|
|
96
|
-
|
|
97
|
-
* [Quiz creation](https://surveyjs.io/Examples/Library/?id=survey-quiz)
|
|
98
|
-
* [Show survey or form in the popup window](https://surveyjs.io/Examples/Library/?id=survey-window)
|
|
99
|
-
* [Display mode](https://surveyjs.io/Examples/Library/?id=survey-displaymode)
|
|
100
|
-
* [Custom navigation](https://surveyjs.io/Examples/Library/?id=survey-customnavigation)
|
|
101
|
-
* [Sharing same data between questions](https://surveyjs.io/Examples/Library/?id=survey-shareddata)
|
|
102
|
-
|
|
103
|
-
### To find out more about the library
|
|
104
|
-
|
|
105
|
-
* go to the [SurveyJS Library Site](https://surveyjs.io/Library)
|
|
106
|
-
* explore the live [Examples](https://www.surveyjs.io/Examples/Library)
|
|
107
|
-
* and create a survey or form using [Survey Creator](https://surveyjs.io/survey/Builder/)
|
|
108
|
-
|
|
109
|
-
#### You can use our quickstart repos:
|
|
110
|
-
|
|
111
|
-
* [Angular CLI](https://github.com/surveyjs/surveyjs_angular_cli)
|
|
112
|
-
* [React](https://github.com/surveyjs/surveyjs_react_quickstart)
|
|
113
|
-
* [Vue](https://github.com/surveyjs/surveyjs_vue_quickstart)
|
|
114
|
-
|
|
115
|
-
## Getting started
|
|
116
|
-
|
|
117
|
-
Install the library using npm.
|
|
118
|
-
|
|
119
|
-
Angular version:
|
|
120
|
-
|
|
121
|
-
```
|
|
122
|
-
npm install survey-angular
|
|
123
|
-
```
|
|
124
|
-
|
|
125
|
-
jQuery version:
|
|
126
|
-
|
|
127
|
-
```
|
|
128
|
-
npm install survey-jquery
|
|
129
|
-
```
|
|
130
|
-
|
|
131
|
-
Knockout version:
|
|
132
|
-
|
|
133
|
-
```
|
|
134
|
-
npm install survey-knockout
|
|
135
|
-
```
|
|
136
|
-
|
|
137
|
-
React version:
|
|
138
|
-
|
|
139
|
-
```
|
|
140
|
-
npm install survey-react
|
|
141
|
-
```
|
|
142
|
-
|
|
143
|
-
Vue version:
|
|
144
|
-
|
|
145
|
-
```
|
|
146
|
-
npm install survey-vue
|
|
147
|
-
```
|
|
148
|
-
|
|
149
|
-
Or use unpkg CDN:
|
|
150
|
-
|
|
151
|
-
* https://unpkg.com/survey-angular@{version-number}/survey.angular.min.js
|
|
152
|
-
* https://unpkg.com/survey-knockout@{version-number}/survey.ko.min.js
|
|
153
|
-
* https://unpkg.com/survey-react@{version-number}/survey.react.min.js
|
|
154
|
-
* https://unpkg.com/survey-jquery@{version-number}/survey.jquery.min.js
|
|
155
|
-
* https://unpkg.com/survey-vue@{version-number}/survey.vue.min.js
|
|
156
|
-
|
|
157
|
-
You find all versions/builds in the [surveyjs/build repo](https://github.com/surveyjs/builds).
|
|
158
|
-
|
|
159
|
-
Or dowload a version as zip file from [Releases](https://github.com/surveyjs/survey-library/releases)
|
|
160
|
-
|
|
161
|
-
If you want to import it in another script:
|
|
162
|
-
|
|
163
|
-
```javascript
|
|
164
|
-
import * as Survey from "survey-jquery";
|
|
165
|
-
```
|
|
166
|
-
|
|
167
|
-
## Building survey.js from sources
|
|
168
|
-
|
|
169
|
-
To build library yourself:
|
|
170
|
-
|
|
171
|
-
1. **Clone the repo from GitHub**
|
|
172
|
-
|
|
173
|
-
```
|
|
174
|
-
git clone https://github.com/surveyjs/survey-library.git
|
|
175
|
-
cd survey-library
|
|
176
|
-
```
|
|
177
|
-
|
|
178
|
-
2. **Acquire build dependencies.** Make sure you have [Node.js](http://nodejs.org/) installed on your workstation. You need a version of Node.js greater than 6.0.0 and npm greater than 2.7.0. This is only needed to _build_ surveyjs from sources.
|
|
179
|
-
|
|
180
|
-
```
|
|
181
|
-
npm install -g karma-cli
|
|
182
|
-
npm install
|
|
183
|
-
```
|
|
184
|
-
|
|
185
|
-
3. **Build the library**
|
|
186
|
-
|
|
187
|
-
```
|
|
188
|
-
npm run build_prod
|
|
189
|
-
```
|
|
190
|
-
|
|
191
|
-
After that you should have the libraries (angular, jquery, knockout, react and vue) at 'packages' directory.
|
|
192
|
-
|
|
193
|
-
4. **Run samples**
|
|
194
|
-
|
|
195
|
-
```
|
|
196
|
-
npm start
|
|
197
|
-
```
|
|
198
|
-
|
|
199
|
-
This command will run local http server at the http://localhost:7777
|
|
200
|
-
You can open http://localhost:7777/examples/knockout to view KnockoutJS samples, http://localhost:7777/examples/react to view ReactJS samples and so on
|
|
201
|
-
|
|
202
|
-
5. **Run unit tests**
|
|
203
|
-
```
|
|
204
|
-
karma start
|
|
205
|
-
```
|
|
206
|
-
This command will run unit tests using [Karma](https://karma-runner.github.io/0.13/index.html)
|
|
207
|
-
|
|
208
|
-
### WordPress integration
|
|
209
|
-
|
|
210
|
-
[SurveyJS WordPress plugin](https://wordpress.org/plugins/surveyjs/)
|
|
211
|
-
|
|
212
|
-
## License
|
|
213
|
-
|
|
214
|
-
[MIT license](https://github.com/surveyjs/survey-library/blob/master/LICENSE)
|
|
16
|
+
SurveyJS Form Library is distributed under the [MIT license](https://github.com/surveyjs/survey-library/blob/master/LICENSE).
|