windowsPopup-dev

Development Environment for 'windowsPopup' AngularJS Module.

Angular Core Dependency: ~1.2.0

Module License: MIT

Added by: Sam Deering

GitHub

Repository

ervinn/windowspopup-dev

Stats

Stars: 0

Watchers: 0

Forks: 0

Author

Ervin
Ervin

Module Description

Development Environment for 'windowsPopup' AngularJS Module

This project is an application skeleton/demo for a typical usage of windowsPopup AngularJS Module .

To download the latest stable Development Environment (v0.0.5) click here

Next Version -> 0.0.6 -(Released NOT YET)


#####New in v0.0.6 :

  • Add attributes wnp-left-click, wnp-dbl-click, and wnp-right-click, those can be used to control which mouse click will open the Popup and Modal windows. (To open a separate browser window by the wnp-popup directive, the default is normal left mouse click. Add wnp-dbl-click to open it by double click. To open a Modal window by the wnp-pop directive, the default is the mouse right click. The default can overwritten by the added new attributes, those are : wnp-left-click, wnp-dbl-click, and wnp-right-click. Note: Because of the popup blockers on most browsers, new browser window can not be opened by the right mouse click.)
  • update Demo window to show the use of the new attributes.

#####New in v0.0.5 :

  • Add more unit and E2E test cases for the new wnp-pop, directive.
  • Add more help description for how to use the wnp-pop directive (add a "Modal usega Help" modal window).
  • Fix some text spelling mistakes on the Demo window.
  • BUG Fix : make sure only one Modal DOM element is added to the page, for each URL and name.

#####New in v0.0.4 :

  • Two new optional attributes are added to wnp-popup directive. Those are wnp-on-open and wnp-on-close. Now it is possible to add two callback functions, the function specified in wnp-on-open will be called when your window is opened, and the function in wnp-on-close will be called when your window is closed. Usage : ... wnp-on-open="yourOnOpenFnc(wnpName)" ... wnp-on-close="yourOnCloseFnc(wnpName)". Note : you need to use wnpName so the Window name will be passed in to your callback. The spelling is important for wnpName but the function name can be your choise.
  • BUG Fix : When the Child window reseted by pressing the F5 key, now the connections between Child and Parent are not lost.
  • Now, Parent window checks if the Child window loaded the AngularJS and windowPopup modules, before the `wnpOnOpen(wnpName)' method is called. If those are not loaded after a certain time interval, then an alert error mesage is presented, and the popup window is closed. The time interval will be configurable.
  • Add E2E (end to end) test cases for the Demo program using Protractor. These tests are run with the Protractor End-to-End test runner.
  • Add new directive wnp-pop. Sometimes you do not want to open a new browser window, just a simple Modal window would do. The wnp-pop directive is similar to wnp-popup, but it opens a Modal window not a new browser window. The good thing is that you can use the same html partial, whatever is in the url attribute will be used. The wnp-pop is using a new attribute, that is wnp-pop-name, to use pre-defined Modal windows. The main difference is that the wnp-pop directive open the Modal window by the right mouse click. This way, this new directive could also be used to open a context menu for you application. ( TODO: After this we will add a directive to open a drop down menu by right click, we plan to call it wnp-pop-dn or wnp-pop-down .) So you will have the option to have a simple drop down or you you can have a Modal window for more complex context menu, depending of your needs.

#####New in v0.0.3 :

  • Made data binding bi-directional. Now when parent updates model data that is linked to child model, the child model is updated automatically.
  • Rename directives and services names. All names are prefixed with wnp-* .
  • Pass a Title text (wnp-title) to the Child window, or if that is not specified pass the text of the link the user clicked.
  • Add 'Build Your Window' section to the Demo app.

#####New in v0.0.2 :

  • Now a child window can be a parent and open its own child window.
  • A new configuration parameter is added. The new configuration parameter is autoUpdate. This value can be specified in the default level, and the Pre-defined window level, or can be passed as an attribute auto-update in the wnp-popup directive. If the auto-update value is true (that was always true in v0.0.1), parent window will be automatically updated as data is typed on the Child. If that value is false, the parent won't be automatically updated. A new directive was created (wnp-update-parent), which must be placed to a buttom or link, which clicked, the parent window is updated at that time.
  • Added angular-route to the Demo application for the popup windows loading. Now windowsPopup.html is used as template, and based on the #/value on the URL, different partial HTMLs can be loaded inside windowsPopup.html .
  • New Sample popup partial windows were added to the Demo program, to demonstrate the new features.
  • Added test cases for the directive popup-link-model.

Getting Started

To get you started you can simply clone the windowsPopup-dev repository and install the dependencies:

Prerequisites

You need git to clone the angular-seed repository. You can get git from http://git-scm.com/.

We also use a number of node.js tools to initialize and test angular-seed. You must have node.js and its package manager (npm) installed. You can get them from http://nodejs.org/.

Clone windowsPopup-dev

Clone the windowsPopup-dev repository using [git][git]:

git clone https://github.com/ervinn/windowsPopup-dev
cd windowsPopup-dev

Install Dependencies

We have two kinds of dependencies in this project: tools and angular framework code. The tools help us manage and test the application.

  • We get the tools we depend upon via npm, the [node package manager][npm].
  • We get the angular code via bower, a [client-side code package manager][bower].

We have preconfigured npm to automatically run bower so we can simply do:

npm install

Behind the scenes this will also call bower install. You should find that you have two new folders in your project.

  • node_modules - contains the npm packages for the tools we need
  • app/bower_components - contains the angular framework files

Run the Application

We have preconfigured the project with a simple development web server. The simplest way to start this server is:

npm start

Now browse to the app at http://localhost:8000/app/index.html.

Testing

Running Unit Tests

This DEMO app comes preconfigured with unit tests. These are written in [Jasmine][jasmine], which we run with the [Karma Test Runner][karma]. We provide a Karma configuration file to run them.

  • the configuration is found at karma.conf.js
  • the unit tests are found next to the code they are testing and are named as ..._test.js.

The easiest way to run the unit tests is to use the supplied npm script:

npm test

This script will start the Karma test runner to execute the unit tests. Moreover, Karma will sit and watch the source and test files for changes and then re-run the tests whenever any of them change. This is the recommended strategy; if your unit tests are being run every time you save a file then you receive instant feedback on any changes that break the expected code functionality.

You can also ask Karma to do a single run of the tests and then exit. This is useful if you want to check that a particular version of the code is operating as expected. The project contains a predefined script to do this:

npm run test-single-run

End to end testing

This DEMO app comes with end-to-end tests, again written in [Jasmine][jasmine]. These tests are run with the Protractor End-to-End test runner. It uses native events and has special features for Angular applications.

  • the configuration is found at e2e-tests/protractor-conf.js
  • the end-to-end tests are found in e2e-tests/scenarios.js

Protractor simulates interaction with our web app and verifies that the application responds correctly. Therefore, our web server needs to be serving up the application, so that Protractor can interact with it.

npm start

In addition, since Protractor is built upon WebDriver we need to install this. The angular-seed project comes with a predefined script to do this:

npm run update-webdriver

This will download and install the latest version of the stand-alone WebDriver tool.

Once you have ensured that the development web server hosting our application is up and running and WebDriver is updated, you can run the end-to-end tests using the supplied npm script:

npm run protractor

This script will execute the end-to-end tests against the application being hosted on the development server.


Module stats last updated: 2015-06-04 23:18:55

Disclaimer: Some data on this page may have been gathered from the authors GitHub respository. If you see any mistakes or outdated information please let us know. Thanks!