@filamentgroup/tau
v0.5.4
Published
A 360 degree image viewer
Downloads
29
Keywords
Readme
Tau
Tau is a small and simple 360 gallery library. The primary goal is to start with a very light weight core and extend it with optional features as part of the build process. The core supports touch, mouse events, and automatic rotation. You can see a demo here.
Setup
After including library in your document you can create an instance of Tau with:
var tau = new window.componentNamespace.Tau( domElement );
Where domElement
is an element conforming to the following markup pattern:
<div class="tau" data-tau>
<div class="loading">loading...</div>
<img src="http://example.com/1.png"
data-src-template="http://example.com/$FRAME.png"
data-frames="72"
data-reduced-step-size="4"
data-auto-rotate-delay="200"></img>
</div>
The default img
provides a fallback for browsers that fail to execute the instantiation. The data-src-template
will be used to create the rest of the images images inside the parent element annotated with data-tau
. Finally, an element tagged with the loading
class will be displayed when the rotation hits an image that hasn't yet fired its loading event. It can be customized with additional markup and CSS as needs be.
Quirks
Internet Explorer (up to and including 11) decodes the images slowly enough that they blink as they do the initial automatic rotation. To get IE to decode the images sooner we create a div
inside the Tau element and load each of the images as 1px width and height, and then remove them once they are all loaded.
Configuration
The following attributes are required on the initial img
unless otherwise specified.
data-src-template
- the template for the additionalimg
tags inserted by Taudata-frames
- the number of images to be inserteddata-reduced-step-size
- factor of reduction for less capable browsers (ie, browsers with no raf)data-auto-rotate-delay
- ms to wait after initialization to start auto-rotate
Styles
The core styles can be found in src/core.css
. The demo page also includes some styles for clarity that are not required by the library:
.tau {
border: 3px solid #ccc;
margin-bottom: 2em;
position: relative;
}
.tau img {
width: 100%;
}
.tau .loading {
position: absolute;
z-index: 2;
left: 0;
top: 0;
}