ImageGrid/ui/gallery-prototype.js
Alex A. Naanou 4b48da396c ...
Signed-off-by: Alex A. Naanou <alex.nanou@gmail.com>
2012-08-08 06:21:00 +04:00

762 lines
19 KiB
JavaScript
Executable File

// XXX need a uniform way to address images (filename?)
/******************************************* Setup Data and Globals **/
// key configuration...
// XXX need to make this handle modifiers gracefully...
var keys = {
toggleHelp: [72], // ???
toggleSingleImageMode: [70, 13], // f, Enter
toggleSingleImageModeTransitions: [84], // t
toggleTransitions: [65], // a
toggleBackgroundModes: [66], // b
toggleControls: [9], // tab
close: [27, 88, 67], // ???
// zooming...
zoomIn: [187], // +
zoomOut: [189], // -
// zoom presets...
fitOne: [49], // 1
fitThree: [51], // 3
// XXX is this relivant?
zoomOriginal: [48], // 0
first: [36], // Home
last: [35], // End
previous: [37, 80, 188, 8], // Left, BkSp, p, <
next: [39, 78, 190, 32], // Right, Space, n, >
// these work with ctrl and shift modifiers...
down: [40], // Down
up: [38], // Up
// these work with ctrl modifier...
promote: [45], // ???
demote: [46], // ???
// XXX should these be s-up, s-down, ... ??
moveViewUp: [75], // k
moveViewDown: [74], // j
moveViewLeft: [72], // h
moveViewRight: [76], // l
centerCurrentImage: [79], // o
toggleMarkers: [77], // m
// keys to be ignored...
ignore: [16, 17, 18], // ???, ???, ???
// print unhandled keys...
helpShowOnUnknownKey: true
}
// the list of style modes...
// these are swithched through in order by toggleBackgroundModes()
var BACKGROUND_MODES = [
'dark',
'black'
]
// this sets the zooming factor used in manual zooming...
var ZOOM_FACTOR = 2
// sets the amoun of move when a key is pressed...
var MOVE_DELTA = 50
/********************************************************** Helpers **/
// this will create a function that will add/remove a css_class to elem
// calling the callbacks before and/or after.
// NOTE: of only one callback is given then it will be called after the
// class change...
// a way around this is to pass an empty function as callback_b
function createCSSClassToggler(elem, css_class, callback_a, callback_b){
// prepare the pre/post callbacks...
if(callback_b == null){
var callback_pre = null
var callback_post = callback_a
} else {
var callback_pre = callback_a
var callback_post = callback_b
}
// build the acual toggler function...
return function(action){
if(action == null){
action = 'on'
// get current state...
if( $(elem).hasClass(css_class) ){
action = 'off'
}
}
if(callback_pre != null){
callback_pre(action)
}
// play with the class...
if(action == 'on'){
$(elem).addClass(css_class)
} else {
$(elem).removeClass(css_class)
}
if(callback_post != null){
callback_post(action)
}
}
}
// disable transitions on obj, call func then enable transitions back...
function doWithoutTransitions(obj, func){
obj
.addClass('unanimated')
.one("webkitTransitionEnd oTransitionEnd msTransitionEnd transitionend", function(){
func()
$('.viewer')
.one("webkitTransitionEnd oTransitionEnd msTransitionEnd transitionend", function(){
obj.removeClass('unanimated')
})
})
}
// find an image object after which to position image ID...
// used for two main tasks:
// - positioning promoted/demoted images
// - centering ribbons
// returns:
// - null - empty ribbon or no element greater id should be first
// - element
// XXX do we need to make ids numbers for this to work?
function getImageBefore_lin(id, ribbon){
// walk the ribbon till we find two images one with an ID less and
// another greater that id...
id = parseInt(id)
var images = ribbon.children('.image')
var prev = null
for(var i=0; i < images.length; i++){
if(parseInt($(images[i]).attr('id')) > id){
return prev
}
prev = $(images[i])
}
return prev
}
// generic binery search for element just before the id...
// NOTE: if id is in lst, this will return the element just before it.
// NOTE: lst must be sorted.
function binarySearch(id, lst, get){
if(get == null){
get = function(o){return o}
}
// empty list...
if(lst.length == 0){
return null
}
// current section length
var l = Math.round((lst.length-1)/2)
// current position...
var i = l
while(true){
var i_id = get(lst[i])
// beginning of the array...
if(i == 0){
if(id > i_id){
return i
}
return null
}
// we got a hit...
if(i_id == id){
return i-1
}
// we are at the end...
if(i == lst.length-1 && id > i_id){
return i
}
var ii_id = get(lst[i+1])
// test if id is between i and i+1...
if( i_id < id && id < ii_id ){
return i
}
// prepare for next iteration...
// NOTE: we saturate the values so we will never get out of bounds.
l = Math.round(l/2)
if(id < i_id){
// lower half...
i = Math.max(0, i-l)
} else {
// upper half...
i = Math.min(i+l, lst.length-1)
}
}
}
// wrapper around binarySearch.
// this is here to make binarySearch simpler to test and debug...
function getImageBefore_bin(id, ribbon){
var images = ribbon.children('.image')
var i = binarySearch(
parseInt(id),
images,
function(o){return parseInt($(o).attr('id'))})
if(i == null){
return null
}
return $(images[i])
}
// set the default search...
var getImageBefore = getImageBefore_bin
/************************************************** Setup Functions **/
// XXX is this a correct place for these?
function setDefaultInitialState(){
if($('.current.ribbon').length == 0){
$('.ribbon').first().addClass('current')
}
if($('.current.image').length == 0){
$('.current.ribbon').children('.image').first().addClass('current')
}
}
function setupEvents(){
// resize...
$(window).resize(function() {
// XXX HACK
$('.current.image').click()
})
// keyboard...
$(document)
.keydown(handleKeys)
// swipe...
$('.viewer')
.swipe({
swipeLeft: nextImage,
swipeRight: prevImage,
swipeUp: shiftImageUp,
swipeDown: shiftImageDown
})
}
function setupControlElements(){
// images...
$(".image").click(setCurrentImage)
// buttons...
$('.screen-button.next-image').click(nextImage)
$('.screen-button.prev-image').click(prevImage)
// XXX rename classes to "shift-image-up" and "shift-image-down"...
$('.screen-button.demote').click(shiftImageUp)
$('.screen-button.promote').click(shiftImageDown)
$('.screen-button.zoom-in').click(function(){scaleContainerBy(ZOOM_FACTOR)})
$('.screen-button.zoom-out').click(function(){scaleContainerBy(1/ZOOM_FACTOR)})
$('.screen-button.toggle-wide').click(toggleWideView)
$('.screen-button.toggle-single').click(toggleSingleImageMode)
$('.screen-button.fit-three').click(fitThreeImages)
$('.screen-button.show-controls').click(showControls)
$('.screen-button.settings').click(function(){alert('not implemented yet...')})
}
function loadImages(json){
var images = json.images
var ribbon = $('.ribbon').last()
$('.image').remove()
for(var i = 0; i < images.length; i++){
$('<div class="image"></div>')
.css({ 'background-image': 'url('+images[i]+')' })
// set a unique id for each image...
.attr({'id': i})
.click(setCurrentImage)
.appendTo(ribbon)
}
ribbon.children().first().click()
}
/*************************************************** Event Handlers **/
function setCurrentImage(){
// set classes...
$('.current').removeClass('current')
$(this)
.addClass('current')
.parents('.ribbon')
.addClass('current')
// position the field and ribbons...
centerSquare()
alignRibbons()
}
function clickAfterTransitionsDone(img){
if(img == null){
img = $('.current.image')
}
$('.viewer')
.one("webkitTransitionEnd oTransitionEnd msTransitionEnd transitionend", function(){
img.click()
return true
})
}
// center other ribbons relative to current image...
// NOTE: only two ribbons are positioned at this point...
function alignRibbons(){
// XXX might be good to move this to a more generic location...
var id = $('.current.image').attr('id')
var directions = ['prev', 'next']
for(var i in directions){
var ribbon = $('.current.ribbon')[directions[i]]('.ribbon')
if(ribbon.length == 1){
var img = getImageBefore(id, ribbon)
if(img != null){
alignRibbon(img, 'before')
} else {
// there are no images before...
alignRibbon(ribbon.children('.image').first(), 'after')
}
}
}
}
// XXX revise...
function handleKeys(event){
var code = event.keyCode, fn = $.inArray;
var _ = (fn(code, keys.close) >= 0) ? function(){}()
: (fn(code, keys.first) >= 0) ? firstImage()
: (fn(code, keys.next) >= 0) ? nextImage()
: (fn(code, keys.previous) >= 0) ? prevImage()
: (fn(code, keys.last) >= 0) ? lastImage()
: (fn(code, keys.promote) >= 0) ? function(){
if(event.ctrlKey){
createRibbon('next')
}
shiftImageDown()
}()
: (fn(code, keys.demote) >= 0) ? function(){
if(event.ctrlKey){
createRibbon('prev')
}
shiftImageUp()
}()
: (fn(code, keys.down) >= 0) ? function(){
if(event.shiftKey){
if(event.ctrlKey){
createRibbon('next')
}
shiftImageDown()
} else {
focusBelowRibbon()
}
}()
: (fn(code, keys.up) >= 0) ? function(){
if(event.shiftKey){
if(event.ctrlKey){
createRibbon('prev')
}
shiftImageUp()
} else {
focusAboveRibbon()
}
}()
// zooming...
: (fn(code, keys.zoomIn) >= 0) ? scaleContainerBy(ZOOM_FACTOR)
: (fn(code, keys.zoomOut) >= 0) ? scaleContainerBy(1/ZOOM_FACTOR)
// zoom presets...
: (fn(code, keys.zoomOriginal) >= 0) ? setContainerScale(1)
: (fn(code, keys.fitOne) >= 0) ? fitImage()
: (fn(code, keys.fitThree) >= 0) ? fitThreeImages()
// moving view...
: (fn(code, keys.moveViewUp) >= 0) ? moveViewUp()
: (fn(code, keys.moveViewDown) >= 0) ? moveViewDown()
: (fn(code, keys.moveViewLeft) >= 0) ? moveViewLeft()
: (fn(code, keys.moveViewRight) >= 0) ? moveViewRight()
: (fn(code, keys.centerCurrentImage) >= 0) ? centerCurrentImage()
: (fn(code, keys.toggleSingleImageMode) >= 0) ? toggleSingleImageMode()
: (fn(code, keys.toggleSingleImageModeTransitions) >= 0) ? toggleSingleImageModeTransitions()
: (fn(code, keys.toggleTransitions) >= 0) ? toggleTransitions()
: (fn(code, keys.toggleBackgroundModes) >= 0) ? toggleBackgroundModes()
: (fn(code, keys.toggleControls) >= 0) ? toggleControls()
// debug...
: (fn(code, keys.toggleMarkers) >= 0) ? toggleMarkers()
: (fn(code, keys.ignore) >= 0) ? false
: (keys.helpShowOnUnknownKey) ? function(){alert(code)}()
: false;
return false;
}
/************************************************************ Modes **/
// ribbon/single view modes...
// global: stores the scale before we went into single image mode...
// XXX HACK
var ORIGINAL_FIELD_SCALE = 1
// remember the default backgrounds for modes...
// ...this effectively makes the modes independant...
// NOTE: null represent the default value...
// XXX HACK
var NORMAL_MODE_BG = null
var SINGLE_IMAGE_MODE_BG = BACKGROUND_MODES[BACKGROUND_MODES.length-1]
var toggleSingleImageMode = createCSSClassToggler('.viewer', 'single-image-mode',
// pre...
function(action){
if(action == 'on'){
NORMAL_MODE_BG = getBackgroundMode()
ORIGINAL_FIELD_SCALE = getElementScale($('.field'))
} else {
SINGLE_IMAGE_MODE_BG = getBackgroundMode()
}
},
// post...
function(action){
if(action == 'on'){
fitImage()
setBackgroundMode(SINGLE_IMAGE_MODE_BG)
} else {
setContainerScale(ORIGINAL_FIELD_SCALE)
setBackgroundMode(NORMAL_MODE_BG)
}
clickAfterTransitionsDone()
})
// wide view mode toggle...
var toggleWideView = createCSSClassToggler('.viewer', 'wide-view-mode', function(action){
if(action == 'on'){
ORIGINAL_FIELD_SCALE = getElementScale($('.field'))
setContainerScale(0.1)
} else {
setContainerScale(ORIGINAL_FIELD_SCALE)
}
}, function(){})
function getBackgroundMode(){
var mode = null
// find a mode to set...
for(var i = 0; i < BACKGROUND_MODES.length; i++){
// we found our mode...
if( $('.' + BACKGROUND_MODES[i]).length > 0 ){
return BACKGROUND_MODES[i]
}
}
return mode
}
// set the background mode
// NOTE: passing null will set the default.
function setBackgroundMode(mode){
var cur = BACKGROUND_MODES.indexOf(mode)
// invalid mode...
if( cur == -1 && mode != null ){
return null
}
// set the mode...
if(mode != null){
$('.viewer').addClass(mode)
}
// remove all others...
for(var i = 0; i < BACKGROUND_MODES.length; i++){
if( i == cur ){
continue
}
mode = BACKGROUND_MODES[i]
$('.' + mode).removeClass(mode)
}
}
// this will toggle through background theems: none -> dark -> black
function toggleBackgroundModes(){
var mode = getBackgroundMode()
// default -> first
if(mode == null){
setBackgroundMode(BACKGROUND_MODES[0])
// last -> default...
} else if(mode == BACKGROUND_MODES[BACKGROUND_MODES.length-1]){
setBackgroundMode()
// next...
} else {
setBackgroundMode(BACKGROUND_MODES[BACKGROUND_MODES.indexOf(mode)+1])
}
}
var toggleSingleImageModeTransitions = createCSSClassToggler('.viewer', 'no-single-image-transitions')
var toggleControls = createCSSClassToggler('.viewer', 'hidden-controls')
var showControls = function(){toggleControls('on')}
var hideControls = function(){toggleControls('off')}
var toggleTransitions = createCSSClassToggler('.viewer', 'transitions-enabled')
var enableTransitions = function(){toggleTransitions('on')}
var disableTransitions = function(){toggleTransitions('off')}
/********************************************************* Movement **/
// XXX for some odd reason these are not liner... something to do with origin?
// XXX virtually identical, see of can be merged...
function moveViewUp(){
var t = parseInt($('.field').css('top'))
$('.field').css({'top': t-(MOVE_DELTA)})
}
function moveViewDown(){
var t = parseInt($('.field').css('top'))
$('.field').css({'top': t+(MOVE_DELTA)})
}
function moveViewLeft(){
var l = parseInt($('.field').css('left'))
$('.field').css({'left': l-(MOVE_DELTA)})
}
function moveViewRight(){
var l = parseInt($('.field').css('left'))
$('.field').css({'left': l+(MOVE_DELTA)})
}
/******************************************************* Navigation **/
// basic navigation...
function firstImage(){
$('.current.ribbon').children('.image').first().click()
}
function prevImage(){
$('.current.image').prev('.image').click()
}
function nextImage(){
$('.current.image').next('.image').click()
}
function lastImage(){
$('.current.ribbon').children('.image').last().click()
}
// XXX add skip N images back and forth handlers...
// XXX
function focusRibbon(direction){
var id = $('.current.image').attr('id')
var prev = getImageBefore(id, $('.current.ribbon')[direction]('.ribbon'))
if(prev){
var next = prev.next()
// NOTE: direction is accounted for to make the up/down shifts
// symmetrical in the general case...
if(next.length == 0 || direction == 'next'){
prev.click()
} else {
next.click()
}
} else {
$('.current.ribbon')[direction]('.ribbon').children('.image').first().click()
}
}
function focusAboveRibbon(){
focusRibbon('prev')
}
function focusBelowRibbon(){
focusRibbon('next')
}
/********************************************************** Actions **/
// basic actions...
// NOTE: below 'direction' argument is meant in the html sence,
// i.e. next/prev...
// create ribbon above/below helpers...
// XXX adding a ribbon above the current is still jumpy, need to devise
// a cleaner way to do this...
function createRibbon(direction){
if(direction == 'next'){
var insert = 'insertAfter'
} else if(direction == 'prev') {
var insert = 'insertBefore'
} else {
return false
}
// adding a new ribbon above the current effectively pushes the
// whole view down, so we need to compensate for this.
// NOTE: the problem is partly caused by clicks fiering BEFORE the
// animation is done...
$('.field').addClass('unanimated')
if(direction == 'prev'){
$('.field').css({
'margin-top': parseInt($('.field').css('margin-top')) - $('.ribbon').outerHeight()
})
}
// the actual insert...
var res = $('<div class="ribbon"></div>')[insert]('.current.ribbon')
// restore the animated state...
$('.field').removeClass('unanimated')
return res
}
// merge current and direction ribbon...
// NOTE: this will take all the elements from direction ribbon and add
// them to current
// XXX this uses jquery animation...
// XXX one way to optimise this is to add the lesser ribbon to the
// greater disregarding their actual order...
function mergeRibbons(direction){
var current_ribbon = $('.current.ribbon')
var images = $('.current.ribbon')[direction]('.ribbon').children()
for(var i=0; i < images.length; i++){
var image = $(images[i])
// get previous element after which we need to put the current...
var prev_elem = getImageBefore(image.attr('id'), current_ribbon)
// check if we need to be before the first element...
if(prev_elem == null){
image
.detach()
.insertBefore(current_ribbon.children('.image').first())
} else {
image
.detach()
.insertAfter(prev_elem)
}
}
// animate...
$('.current.ribbon')[direction]('.ribbon')
.slideUp(function(){
$(this).remove()
$('.current.image').click()
})
}
/*************************************************** Editor Actions **/
// now the actual modifiers...
function shiftImage(direction){
if($('.current.ribbon')[direction]('.ribbon').length == 0){
createRibbon(direction)
}
// get previous element after which we need to put the current...
var prev_elem = getImageBefore(
$('.current.image').attr('id'),
$('.current.ribbon')[direction]('.ribbon'))
// last image in ribbon, merge...
if($('.current.ribbon').children('.image').length == 1){
mergeRibbons(direction)
} else {
img = $('.current.image')
if(img.next('.image').length == 0){
prevImage()
} else {
nextImage()
}
// do the actual move...
if(prev_elem){
// insert element after current...
img
.detach()
.insertAfter(prev_elem)
} else {
// empty ribbon or fisrt element...
img
.detach()
.prependTo($('.current.ribbon')[direction]('.ribbon'))
}
}
$('.current.image').click()
}
function shiftImageDown(){
return shiftImage('next')
}
function shiftImageUp(){
return shiftImage('prev')
}
function flipRibbons(){
var ribbons = $('.ribbon')
// index of current ribbon, needed to adjust placement of everything...
var cur = ribbon.index($('.current.ribbon'))
// XXX would have been nice if we could do detach reverse attach or just reverse...
}
/*********************************************************************/
// vim:set ts=4 sw=4 nowrap :