Sequence - The jQuery Slider Plugin with Infinite Style
Sequence is the jQuery slider plugin with infinite style. It provides the complete functionality for a website slider without forcing you to use a set theme. In fact, Sequence has no in-built theme, leaving you complete creative control to build a unique slider using only CSS3 -- no jQuery knowledge required!
- Unique transition styles created using CSS3
- Supports all modern browsers
- Gracefully degrades in older browsers*
- Supports responsive layouts
- Supports touch devices and swiping
- Many developer features with even more to come
- Semantic and easy to use markup
- Open source
*Tested down to Firefox 3.6 and IE7. Extensive support details to come
The unashamedly technical documentation can be found here: SequenceJS Demo. Quick guides are on their way!
Ian Lunn (say hi on Twitter!)
sequence.js is a FREE script and is dual licensed under the following: http://www.opensource.org/licenses/mit-license.php | http://www.gnu.org/licenses/gpl.html
Note: 0.6.7 may not be backwards compatible with existing themes if those themes use the afterPreload callback, which has now been renamed to afterLoaded
- Fixed bug that prevented Sequence from initiating when the preloader was disabled
- Changed the name of the afterPreload callback to afterLoaded and made it execute whether a preloader is used or not
- Changed the name of the
fallbacknow has an option within it called
theme. In the future, the
themeoption can be given different strings such as
slideto provide different fallback themes for older browsers.
- A few minor adjustments to improve or remove redundant code
Bug fix for Multiple Instances of Sequence
The documentation has been slightly modified to better assist with multiple instances of Sequence on the same page. The default Sequence preloader was originally appended to the Sequence container as an ID but this caused issues when using more than one Sequence instance, so it's now a class.
Note: 0.6.5 may not be backwards compatible with existing themes if those themes use the delayDuringOutInTransitions setting, which has now been renamed to transitionThreshold
You can now use afterCurrentFrameAnimatesOut which is triggered once the current frame reaches the end of its animate out transition
Minor changes to delayDuringOutInTransitions Setting
delayDurintOutInTransitions option renamed to
transitionThreshold which now makes all possible settings work
Minor changes to how the nextButton/prevButton/pauseButton and prependNextButton/prependPrevButton/prependPauseButton options work. Now closer match how they are described in the documentation.
Check out the updated Apple Style theme that showcases the new pause options and callbacks.
New Pause Options
pauseButton, prependPauseButton, pauseButtonSrc, pauseButtonAlt, unpauseDelay have been added to allow for a pause button when using autoPlay.
New Pause Callbacks
Two new callbacks added for pause and unpause
New customKeyEvent for Pausing
If using customKeyEvents, you can now hook a key to the pause event.
startAutoPlay Public Method Bug Fix
The public method startAutoPlay accepted an argument that would cause Sequence to wait x amount of milliseconds before autoPlay was started. This argument wasn't correctly implemented but should now work.
Sequence Container is Given a Class of "sequence-fallback" When in Fallback Mode
If Sequence goes into fallback mode because the browser doesn't support CSS3 transitions, it is given the class of "sequence-fallback" allowing for the application of styles specifically for older browsers
Note: 0.6.2 may not be backwards compatible with existing themes if those themes use the touchEnabled and keysNavigate settings (these settings have changed names, see below)
Added keyEvents Option
keyEvents allows you to specify which way the left and right arrows should cause Sequence to navigate. See Keyboard Options
Added customKeyEvents Option
customKeyEvents are keyEvents on steroids! Specify a key (using a keyCode) and the event to be trigger when the user hits that key. Example: 65: "prev" causes Sequence to navigate backwards when the "a" key is pressed on the keyboard.
Added numericKeysGoToFrames Option
When the keyboards numeric keys are pressed, if there is a frame that represents that number, Sequence will navigate to that frame.
Added swipeEvents Option
swipeEvents allows you to specify which way Sequence should navigate when the user swipes in a particular direction. Up/Down/Left/Right supported.
Added swipePreventsDefault Option
If set to true, on touch devices, when swiping over Sequence, the default will be prevented (the page will not scroll). Useful if you want up/down swiping to cause Sequence to navigate but be careful that this doesn't affect user experience by preventing scrolling the page all together.
Changed the Names of a Few Options
touchEnabled changed to swipeNavigation keysNavigate changed to keyNavigation
Tidied up the Documentation
Changed the layout of the options in the documentation
In previous versions of Sequence, all frame elements HAD to have a class for Sequence to work. This was unintentional but is now resolved in 0.6.1. Use IDs and classes as you see fit, but they're no longer necessary.
Code Optimisation and General Tweaks
Note: 0.6 may not be backwards compatible with existing themes, particularly if they use before/after callbacks or rely on the "current" class
A frame is now only deemed as being "current" when it is in the viewport but not animating. If animating in, it will have a class of "next-frame". The "current" frame now has a class of "current-frame".
Changed the before/after callbacks. These callbacks are now beforeNextFrameAnimatesIn, afterNextFrameAnimatesIn, beforeCurrentFrameAnimatesOut. Please consult the documentation and the http://sequencejs.com/themes/documentation-demo/ to better understand this.
before/after callbacks are now working correctly in the fallback themes.
Fix for Reversed Animation Speeds
If an element animates-in at 2 seconds and then animates-out at 3, when it reverses in (from the animate-out position), it will take 3 seconds.
Made 'Modern Slide In' Responsive
The theme 'Modern Slide In' is now responsive.
No changes made to Sequence.js.
Touch Swiping Improved
Swiping on touch devices has been improved and swipeThreshold is working again. Links within frames are clickable and the page can be scrolled vertically without initiating a frame change.
Changed Default Values for nextButton and prevButton
The nextButton and prevButton options are now turned off out of the box. To turn them on, either use the defaults by setting these options to true or by specifying a CSS selector to use your own custom buttons
Multiple Instances Now Working
Merged a pull request that got multiple instances of Sequence on one page working.
Previous/Next Button Options
The previous and next buttons now have a couple more options:
- nextButtonSrc: specify a path to an image to be used as the next button
- nextButtonAlt: specify a string to be used as the alt text for the next button image
- prevButtonSrc: specify a path to an image to be used as the previous button
- prevButtonAlt: specify a string to be used as the alt text for the previous button image
General tidy up of the script. Made some changes for better practice -- now only using one jQuery function etc, all dependencies are enclosed within the Sequence function. Also optimised .init().
Sequence will now detect whether Modernizr.prefixed is installed on the site, if it's not, it'll use its own instance.
Sequence will now only trigger the pause function when hovering over its child elements inside the container. If you'd like Sequence to pause when hovering on child elements outside of the container, set this to true.
In update v0.2, the pauseIcon option got broken. This is now fixed.
Sequence now has a default preloader or support for a custom preloader. When preloading is complete, a class of "preloading-complete" can be added to one or multiple elements to allow you to write your own reveal using CSS3 transitions. Also comes with a callback for when the preloading is complete.
Choose whether Sequence should go back to the start when it reaches the last frame (or the first frame if navigating backwards)
When navigating backwards, you can now specify whether frames should animate forwards or in reverse