Skip to content

stefan-1st/birdview

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

45 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Birdview.js

Screenshot

Get a glance at a whole web page with an aerial view.

See demo & full documentation here.

Setup

Include birdview.js and birdview.css in HTML:

<link rel="stylesheet" type="text/css" href="birdview.css"/>
<script type="text/javascript" src="birdview.js"></script>

Then enable Birdview with the initialization method:

birdview.init();

Usage

To trigger birdview, you can either:

  • Press the Z key
  • Pinch-in on a touch device

You can also trigger birdview by clicking any HTML element with a birdview_toggle class:

<button class="birdview_toggle">Birdview</button>

Or you can toggle birdview programmatically using the toggle method:

birdview.toggle();

There are a few options available so you can tweak birdview the way you need it.

	const defaults = {
		shortcut: 90,
		button: true,
		button_text: 'Birdview',
		speed: 0.3,
		easing: 'ease',
		overlay: true,
		overlay_transition: 0.3,
		origin_X: 50,
		callback_start: null,
		callback_end: null,
		touch: true,
		debug: false,
		text_h1: 'Birdview',
		text_close: 'X',
		text_home: 'Home',
		text_title: document.title,
		text_usage: 'Click to dive<br>Press Z or pinch to toggle birdview',
		text_zooming: 'Zooming...'
	};

Let's say you want to change the zooming text to something different:

birdview.toggle({
    text_zooming: 'Watch the magic happen...'
});

You can stop birdview from running on your page by calling:

birdview.destroy();

The destruction method is called inside the initialization method. Calling birdview.init() multiple times shouldn't create any undesirable overlapping.

License

Birdview.js is published under the GNU General Public License.

About

User interface experiment and JavaScript plugin.

Resources

License

Stars

Watchers

Forks

Packages

No packages published

Languages

  • JavaScript 66.8%
  • CSS 33.2%