A simple and customizable popup.
A simple and customizable popup.
screenpop does allow you to...
screenpop does not use a popular library like jQuery to interface with the DOM. Instead, it uses purpose-built modules I've made -elemst, lockfn, domwh, lsn. With the modules its minified size is ~7.2kb. Without the modules, its minified size is ~3.5kb. Modules are isolated on public screenpop methods and may be redefined with methods using jQuery or any library.
screenpop does not add or include structural elements, such as titles, footer links or close buttons. Write a wrapper for constructing a themed screenpop for repeated titles or buttons.
A sample themed
screenpop is included in the tests:
As shown above, methods on
screenpop can keep a popup visible when the document is scrolled. The screenpop above is called with a
20 pixels and when the document is scrolled down, 20 pixels of the popup are kept visible:
screenpophintSize : 20onRenderfnnull '' +'<div class="pop">' +' <div class="pop-header">' +' <h2 class="pop-header-title">title</h2>' +' <a id="CloseLink" class="pop-header-close">' +' <span class="pop-header-close-sprite"></span>' +' </a>' +' </div>' +' <div class="pop-content">' +' <p>some popup content</p>' +' </div>' +'</div>';onOpenvar close = documentgetElementById'CloseLink';if closescreenshut;;pop;
To ensure visibility, popups are rendered to a 'container' element (.sp-layers) at the bottom of the document, just before the closing
</body>tag. The container holds a 'layer' element (.sp-layers-layer) for each popup.
'container', 'layer' and 'load' elements are created only when a popup renders. If removed, they are created for the next popup rendered. A layer is created for each new popup.
screenpop attaches throttled listeners to window resize and document scroll. On resize, an 'open' popup is centered. On scroll, an 'open' popup is vertically translated to remain visible on screen.
if popup is vertically centered and too tall to fit viewport, top of popup is aligned with top of viewport. scroll down to see rest of popup.
if popup bottom or top is scrolled out of viewport, popup is translated up or down to maintain visibility
'Loading' can pose a UX problem for a popup. When a user clicks to open, visual feedback may be desired if content is generated during a wait process...
Scenarious to avoid:
screenpop uses the same solution for quick and slow render popups. The popup appears fully formed at once and any loading indicator slowly fades away. The loading indicator is an html/css visualization above the darkened screen to be positioned where needed, preferably uncovered by the appearing popup.
screenpop may have its own loading indicator or the prototype may be redefined with a loading indicator for all popups.
screenpop tests use this for the loading indicator:
return '' +'<div class="loading-container">' +' <div class="loading">' +' <span class="b"></span><span class="b"></span><span class="b"></span><span class="b"></span><span class="b"></span><br/>' +' <span class="b"></span><span class="t"></span><span class="t"></span><span class="t"></span><span class="t"></span><br/>' +' <span class="b"></span><span class="t"></span><span class="t"></span><span class="r"></span><span class="b"></span><br/>' +' <span class="b"></span><span class="t"></span><span class="t"></span><span class="t"></span><span class="b"></span><br/>' +' <span class="b"></span><span class="b"></span><span class="b"></span><span class="b"></span><span class="b"></span>' +' </div>' +'</div>';;
Two properties are useful for the screenpop constructor. Default values are
beasthintSize : 20 // number of pixels used to display hint arealoadElemStr : '' // string formatted html for loading indicator
A reference to the last popup rendered by screenpop
Centers any 'open' popup
Vertically centers any 'open' popup
Shuts any 'open' popup
Removes the popup reference by
screenpop.screenobjLast from the document
proto is not a method but a property defined on the screenpop namespace. the prototype is used to construct screenpop objects. proto may be accessed to redefine its default properties.
Important methods on screenpop objects are listed below
The given function is called when the popup is rendered.
The given function is called when the popup is shut.
The given function is called when the popup is open. Useful for modifiying behaviour or adding events to the popup once it is rendered.
The given function is given a callback to be called with an error as the first parameter or content as the second parameter.
Returns the string HTML to used for the loading indicator.
Returns the layer element parenting the 'screen', 'load' and 'content' elements of the popup.
Returns the content element of the popup.
Returns the load element of the popup.
Centers the popup.
Vertically centers the popup.
Uses innerHTML or appendChild to add given content to the popup.
Generates markup for the popup, obtains content for the popup using
screenPop.onRender, updates classNames on the popup to make it visible and then calls
Updates classNames on the popup to make it visble.
Updates classNames on the popup to make loading indicator visible.
Updates classNames on the popup to hide it.
Removes the popup from the document.
screenpop may be downloaded directly or installed through
$ npm install screenpop
$ git clone$ cd screenpop && npm install
Run npm start to build a sample screenpop page and to see a themed screenpop.
Tests are not automated and are performed by loading a document in the browser and using the browser console.
build test files
test/index.html in your browser and run tests from the console
(The MIT License)
Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the 'Software'), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.