Skip to content

Latest commit

 

History

History
153 lines (125 loc) · 4.96 KB

README.md

File metadata and controls

153 lines (125 loc) · 4.96 KB
Raw

Angular 7 Cli (QuickStart Boilerplate) + SurveyJS: Survey Library and Survey Creator

This project was generated with Angular CLI and modified to use SurveyJS: Survey Library and Survey Creator.

You can just clone this repo and run "npm i" and "npm start" command :

git clone https://github.com/surveyjs/surveyjs_angular_cli.git
cd surveyjs_angular_cli
npm i
npm start

Steps to add SurveyJS: Survey Library and Survey Creator into the generated empty project

  1. Create a new project.

    ng new surveyjs-angular-cli
cd surveyjs-angular-cli

  2. Add SurveyJS: Survey Library and Survey Creator dependencies.

    npm install -save survey-angular
npm install -save surveyjs-widgets
npm install -save survey-creator
npm install -save survey-pdf
npm install -save bootstrap

  3. Add knockout typings to the '/src/tsconfig.app.json' file.

    "types": [
  "knockout"
]

  4. Enable experimentalDecorators in the '/src/tsconfig.app.json' file

    ...
compilerOptions: {
  ...
  experimentalDecorators: true
  ...
}
...

  5. Add Survey and Survey Creator components files.

    src/app/survey.component.ts
src/app/survey.creator.component.ts
src/app/customwidget.ts

  6. Use compoents in the app.module.ts file.

    import { SurveyComponent } from './survey.component';
import { SurveyCreatorComponent } from './survey.creator.component';
@NgModule({
declarations: [
  AppComponent,
  SurveyComponent,
  SurveyCreatorComponent
],

  7. Change markup in the app.component.html file.

    <h1>Survey</h1><survey [json]="json"></survey>
<h1>SurveyJS Creator</h1><survey-creator></survey-creator>

  8. Add "jQuery polyfill" for bootstrap in the polyfills.ts file (angular/angular-cli#2129).

    import * as jQuery from 'jquery';
window['jQuery'] = jQuery;

  9. Update the "build" section of the angular.json file to include the following:

     "styles": [
          "src/styles.css",
          "node_modules/bootstrap/dist/css/bootstrap.min.css",
          "node_modules/survey-angular/survey.css",
          "node_modules/survey-creator/survey-creator.css",
          "node_modules/jquery-ui/themes/base/theme.css",
          "node_modules/jquery-ui/themes/base/datepicker.css",
          "node_modules/nouislider/distribute/nouislider.css",
          "node_modules/select2/dist/css/select2.css",
          "node_modules/pretty-checkbox/dist/pretty-checkbox.css",
          "node_modules/bootstrap-slider/dist/css/bootstrap-slider.css",
          "node_modules/jquery-bar-rating/dist/themes/bars-pill.css",
          "node_modules/jquery-bar-rating/dist/themes/css-stars.css",
          "node_modules/jquery-bar-rating/dist/themes/fontawesome-stars.css",
          "node_modules/jquery-bar-rating/dist/themes/bars-1to10.css",
          "node_modules/jquery-bar-rating/dist/themes/bars-horizontal.css",
          "node_modules/jquery-bar-rating/dist/themes/bars-movie.css",
          "node_modules/jquery-bar-rating/dist/themes/bars-reversed.css",
          "node_modules/jquery-bar-rating/dist/themes/bars-square.css",
          "node_modules/jquery-bar-rating/dist/themes/bootstrap-stars.css",
          "node_modules/jquery-bar-rating/dist/themes/fontawesome-stars-o.css"
        ],
        "scripts": [
          "node_modules/jquery/dist/jquery.js",
          "node_modules/jquery-ui/ui/widgets/datepicker.js",
          "node_modules/select2/dist/js/select2.js",
          "node_modules/jquery-bar-rating/dist/jquery.barrating.min.js",
          "node_modules/emotion-ratings/dist/emotion-ratings.js"
        ]

  10. Add json object for survey to AppComponent

    export class AppComponent {
      ...
      json = {
        ...
      };
      ...
}

  11. Run project.

    ng serve

Development server

Run ng serve for a dev server. Navigate to http://localhost:4200/. The app will automatically reload if you change any of the source files.

Code scaffolding

Run ng generate component component-name to generate a new component. You can also use ng generate directive/pipe/service/class/module.

Build

Run ng build to build the project. The build artifacts will be stored in the dist/ directory. Use the -prod flag for a production build.

Running unit tests

Run ng test to execute the unit tests via Karma.

Running end-to-end tests

Run ng e2e to execute the end-to-end tests via Protractor. Before running the tests make sure you are serving the app via ng serve.

Further help

To get more help on the Angular CLI use ng help or go check out the Angular CLI README.