jqCube is a jQuery library for adding cubes to pages, such as the one pictured below. A full API is included for manipulating these cubes, allowing you to change its colors, dimensions, and animate it. You can put any content you like on each side of the cube.
You can play around with the API-accessible features on this playground page
You can read some extended discussion about the user interface implications of rotating cubes. Having seen it's popularity there among user interface professionals, I have decided to release it as an open source project so that anybody can include cubes in their own websites.
You can download the source files by cloning this repository, or just copying it from this GitHub hosted url:
http://peterolson.github.com/jqCube/jqCube.jquery.min.js
Include it as a script on your page. It depends on jQuery, so make sure you include it after jQuery.
Create a div on your page, and include six divs inside of it, and each should have one of the classes "front", "back", "left", "right", "bottom", "top", like this:
<div id="myCube">
<div class="front">Front Side</div>
<div class="back">Back Side</div>
<div class="left">Left Side</div>
<div class="right">Right Side</div>
<div class="bottom">Bottom Side</div>
<div class="top">Top Side</div>
</div>
Then you can make myCube into a cube. For default settings, just call .cube on a jQuery element with no arguments.
$("#myCube").cube();
If you want to initialize the cube with custom settings, you can pass a settings object as an argument.
$("#myCube").cube({ /* settings */ });
Sets the dimensions of the cube in pixels with these three settings.
Expected Value: Integer
Default: 400
Sets the center point of the cube. Defined by pixel offsets to the left and top of the page.
Expected Value: [Integer, Integer]
Default: [300, 300]
Sets the direction light comes from. Defined by a proportion of [lightFromRight, lightFromTop, lightFromFront] facing toward the cube. You can use negative values to reverse the direction.
Expected Value: [Number, Number, Number]
Default: [1, 1, 1]
Sets the hue of the cube.
Expected Value: Integer in range [0, 255]
Default: 128
Sets the saturation of the cube.
Expected Value: Integer in range [0, 100]
Default: 50
Sets the opacity/transparency of the cube. 0 is transparent, and 100 is opaque.
Expected Value: Integer in range [0, 100]
Default: 100
Sets the luminosity of the darkest face of the cube.
Expected Value: Integer in range [0, 100]
Default: 50
Sets the luminosity of the brightest face of the cube.
Expected Value: Integer in range [0, 100]
Default: 85
Boolean indicating whether the cube will animate.
Expected Value: Boolean
Default: true
Sets the number of frames drawn per second when the cube animates.
Expected Value: Integer
Default: 20
Sets the approximate time in seconds it will take the cube to rotate fully about one axis at default spinning speed.
Expected Value: Integer
Default: 5
Sets the initial position of the cube in terms of 90 degree [turnsRight, turnsUp] from the default position where the front side is facing forward with the top, bottom, left, and right sides respectively above, below, left, and right of the front side. You can use non-integers to specify partial turns.
Expected Value: [Number, Number]
Default: [0, 0]
The relative speed that the cube will rotate in a horizontal direction.
Expected Value: Number
Default: 1
The relative speed that the cube will rotate in a vertical direction.
Expected Value: Number
Default: 1
Used to dynamically change the cube's settings.
Starts animating the cube
Stops animating the cube
Moves the cube to the specified position (see initialPosition setting) in the given time in seconds at the given frames per second. Accepts face names ("front", "back", "left", "right", "top", "botton") as positions.
Turns the cube the given number of turns to the right in the given time in seconds at the given number of frames per second.
Turns the cube the given number of turns to the left in the given time in seconds at the given number of frames per second.
Turns the cube the given number of turns upward in the given time in seconds at the given number of frames per second.
Turns the cube the given number of turns downward in the given time in seconds at the given number of frames per second.
Turns the cube the given number of turns in the horizontal and vertical directions at the same time in the given time in seconds at the given number of frames per second. Negative numbers may be used to turn left or down.