jQuery core style guide conformance: jquery.mobile.forms.slider.js

This commit is contained in:
Rick Waldron 2011-06-28 21:12:34 -04:00
parent 2a232a06e0
commit 5dbbf68d4e

View file

@ -4,134 +4,159 @@
* Dual licensed under the MIT or GPL Version 2 licenses. * Dual licensed under the MIT or GPL Version 2 licenses.
* http://jquery.org/license * http://jquery.org/license
*/ */
(function($, undefined ) {
( function( $, undefined ) {
$.widget( "mobile.slider", $.mobile.widget, { $.widget( "mobile.slider", $.mobile.widget, {
options: { options: {
theme: null, theme: null,
trackTheme: null, trackTheme: null,
disabled: false disabled: false
}, },
_create: function(){
_create: function() {
// TODO: Each of these should have comments explain what they're for
var self = this, var self = this,
control = this.element, control = this.element,
parentTheme = control.parents('[class*=ui-bar-],[class*=ui-body-]').eq(0), parentTheme = control.parents( "[class*='ui-bar-'],[class*='ui-body-']" ).eq( 0 ),
parentTheme = parentTheme.length ? parentTheme.attr('class').match(/ui-(bar|body)-([a-z])/)[2] : 'c', parentTheme = parentTheme.length ? parentTheme.attr( "class" ).match( /ui-(bar|body)-([a-z])/ )[ 2 ] : "c",
theme = this.options.theme ? this.options.theme : parentTheme, theme = this.options.theme ? this.options.theme : parentTheme,
trackTheme = this.options.trackTheme ? this.options.trackTheme : parentTheme, trackTheme = this.options.trackTheme ? this.options.trackTheme : parentTheme,
cType = control[0].nodeName.toLowerCase(), cType = control[ 0 ].nodeName.toLowerCase(),
selectClass = (cType == 'select') ? 'ui-slider-switch' : '',
controlID = control.attr('id'),
labelID = controlID + '-label',
label = $('[for="'+ controlID +'"]').attr('id',labelID),
val = function(){
return (cType == 'input') ? parseFloat(control.val()) : control[0].selectedIndex;
},
min = (cType == 'input') ? parseFloat(control.attr('min')) : 0,
max = (cType == 'input') ? parseFloat(control.attr('max')) : control.find('option').length-1,
step = window.parseFloat(control.attr('step') || 1),
slider = $('<div class="ui-slider '+ selectClass +' ui-btn-down-'+ trackTheme+' ui-btn-corner-all" role="application"></div>'),
handle = $('<a href="#" class="ui-slider-handle"></a>')
.appendTo(slider)
.buttonMarkup({corners: true, theme: theme, shadow: true})
.attr({
'role': 'slider',
'aria-valuemin': min,
'aria-valuemax': max,
'aria-valuenow': val(),
'aria-valuetext': val(),
'title': val(),
'aria-labelledby': labelID
});
$.extend(this, { selectClass = ( cType == "select" ) ? "ui-slider-switch" : "",
controlID = control.attr( "id" ),
labelID = controlID + "-label",
label = $( "[for='"+ controlID +"']" ).attr( "id", labelID ),
val = function() {
return cType == "input" ? parseFloat( control.val() ) : control[0].selectedIndex;
},
min = cType == "input" ? parseFloat( control.attr( "min" ) ) : 0,
max = cType == "input" ? parseFloat( control.attr( "max" ) ) : control.find( "option" ).length-1,
step = window.parseFloat( control.attr( "step" ) || 1 ),
slider = $( "<div class='ui-slider " + selectClass + " ui-btn-down-" + trackTheme +
" ui-btn-corner-all' role='application'></div>" ),
handle = $( "<a href='#' class='ui-slider-handle'></a>" )
.appendTo( slider )
.buttonMarkup({ corners: true, theme: theme, shadow: true })
.attr({
"role": "slider",
"aria-valuemin": min,
"aria-valuemax": max,
"aria-valuenow": val(),
"aria-valuetext": val(),
"title": val(),
"aria-labelledby": labelID
}),
options;
$.extend( this, {
slider: slider, slider: slider,
handle: handle, handle: handle,
dragging: false, dragging: false,
beforeStart: null beforeStart: null
}); });
if(cType == 'select'){ if ( cType == "select" ) {
slider.wrapInner('<div class="ui-slider-inneroffset"></div>');
var options = control.find('option');
control.find('option').each(function(i){ slider.wrapInner( "<div class='ui-slider-inneroffset'></div>" );
var side = (i==0) ?'b':'a',
corners = (i==0) ? 'right' :'left', options = control.find( "option" );
theme = (i==0) ? ' ui-btn-down-' + trackTheme :' ui-btn-active';
$('<div class="ui-slider-labelbg ui-slider-labelbg-'+ side + theme +' ui-btn-corner-'+ corners+'"></div>').prependTo(slider); control.find( "option" ).each(function( i ) {
$('<span class="ui-slider-label ui-slider-label-'+ side + theme +' ui-btn-corner-'+ corners+'" role="img">'+$(this).text()+'</span>').prependTo(handle);
var side = !i ? "b":"a",
corners = !i ? "right" :"left",
theme = !i ? " ui-btn-down-" + trackTheme :" ui-btn-active";
$( "<div class='ui-slider-labelbg ui-slider-labelbg-" + side + theme + " ui-btn-corner-" + corners + "'></div>" )
.prependTo( slider );
$( "<span class='ui-slider-label ui-slider-label-" + side + theme + " ui-btn-corner-" + corners + "' role='img'>" + $( this ).text() + "</span>" )
.prependTo( handle );
}); });
} }
label.addClass('ui-slider'); label.addClass( "ui-slider" );
// monitor the input for updated values // monitor the input for updated values
control control.addClass( cType === "input" ? "ui-slider-input" : "ui-slider-switch" )
.addClass((cType == 'input') ? 'ui-slider-input' : 'ui-slider-switch') .change( function() {
.change(function(){
self.refresh( val(), true ); self.refresh( val(), true );
}) })
.keyup(function(){ // necessary? .keyup( function() { // necessary?
self.refresh( val(), true, true ); self.refresh( val(), true, true );
}) })
.blur(function(){ .blur( function() {
self.refresh( val(), true ); self.refresh( val(), true );
}); });
// prevent screen drag when slider activated // prevent screen drag when slider activated
$(document).bind( "vmousemove", function(event){ $( document ).bind( "vmousemove", function( event ) {
if ( self.dragging ) { if ( self.dragging ) {
self.refresh( event ); self.refresh( event );
return false; return false;
} }
}); });
slider slider.bind( "vmousedown", function( event ) {
.bind( "vmousedown", function(event){ self.dragging = true;
self.dragging = true;
if ( cType === "select" ) {
self.beforeStart = control[0].selectedIndex;
}
self.refresh( event );
return false;
});
slider if ( cType === "select" ) {
.add(document) self.beforeStart = control[0].selectedIndex;
.bind( "vmouseup", function(){ }
self.refresh( event );
return false;
});
slider.add( document )
.bind( "vmouseup", function() {
if ( self.dragging ) { if ( self.dragging ) {
self.dragging = false; self.dragging = false;
if ( cType === "select" ) { if ( cType === "select" ) {
if ( self.beforeStart === control[0].selectedIndex ) {
//tap occurred, but value didn't change. flip it! if ( self.beforeStart === control[ 0 ].selectedIndex ) {
self.refresh( self.beforeStart === 0 ? 1 : 0 ); //tap occurred, but value didn"t change. flip it!
self.refresh( !self.beforeStart ? 1 : 0 );
} }
var curval = val(); var curval = val();
var snapped = Math.round( curval / (max - min) * 100 ); var snapped = Math.round( curval / ( max - min ) * 100 );
handle handle
.addClass("ui-slider-handle-snapping") .addClass( "ui-slider-handle-snapping" )
.css("left", snapped + "%") .css( "left", snapped + "%" )
.animationComplete(function(){ .animationComplete( function() {
handle.removeClass("ui-slider-handle-snapping"); handle.removeClass( "ui-slider-handle-snapping" );
}); });
} }
return false; return false;
} }
}); });
slider.insertAfter(control); slider.insertAfter( control );
// NOTE force focus on handle // NOTE force focus on handle
this.handle this.handle
.bind( "vmousedown", function(){ .bind( "vmousedown", function() {
$(this).focus(); $( this ).focus();
}) })
.bind( "vclick", false ); .bind( "vclick", false );
@ -165,24 +190,24 @@ $.widget( "mobile.slider", $.mobile.widget, {
// move the slider according to the keypress // move the slider according to the keypress
switch ( event.keyCode ) { switch ( event.keyCode ) {
case $.mobile.keyCode.HOME: case $.mobile.keyCode.HOME:
self.refresh(min); self.refresh( min );
break; break;
case $.mobile.keyCode.END: case $.mobile.keyCode.END:
self.refresh(max); self.refresh( max );
break; break;
case $.mobile.keyCode.PAGE_UP: case $.mobile.keyCode.PAGE_UP:
case $.mobile.keyCode.UP: case $.mobile.keyCode.UP:
case $.mobile.keyCode.RIGHT: case $.mobile.keyCode.RIGHT:
self.refresh(index + step); self.refresh( index + step );
break; break;
case $.mobile.keyCode.PAGE_DOWN: case $.mobile.keyCode.PAGE_DOWN:
case $.mobile.keyCode.DOWN: case $.mobile.keyCode.DOWN:
case $.mobile.keyCode.LEFT: case $.mobile.keyCode.LEFT:
self.refresh(index - step); self.refresh( index - step );
break; break;
} }
}) // remove active mark }) // remove active mark
.keyup(function( event ) { .keyup( function( event ) {
if ( self._keySliding ) { if ( self._keySliding ) {
self._keySliding = false; self._keySliding = false;
$( this ).removeClass( "ui-state-active" ); $( this ).removeClass( "ui-state-active" );
@ -192,82 +217,98 @@ $.widget( "mobile.slider", $.mobile.widget, {
this.refresh(); this.refresh();
}, },
refresh: function(val, isfromControl, preventInputUpdate){ refresh: function( val, isfromControl, preventInputUpdate ) {
if ( this.options.disabled ) { return; } if ( this.options.disabled ) { return; }
var control = this.element, percent, var control = this.element, percent,
cType = control[0].nodeName.toLowerCase(), cType = control[0].nodeName.toLowerCase(),
min = (cType === "input") ? parseFloat(control.attr("min")) : 0, min = cType === "input" ? parseFloat( control.attr( "min" ) ) : 0,
max = (cType === "input") ? parseFloat(control.attr("max")) : control.find("option").length - 1; max = cType === "input" ? parseFloat( control.attr( "max" ) ) : control.find( "option" ).length - 1;
if ( typeof val === "object" ) { if ( typeof val === "object" ) {
var data = val, var data = val,
// a slight tolerance helped get to the ends of the slider // a slight tolerance helped get to the ends of the slider
tol = 8; tol = 8;
if ( !this.dragging if ( !this.dragging ||
|| data.pageX < this.slider.offset().left - tol data.pageX < this.slider.offset().left - tol ||
|| data.pageX > this.slider.offset().left + this.slider.width() + tol ) { data.pageX > this.slider.offset().left + this.slider.width() + tol ) {
return; return;
} }
percent = Math.round( ((data.pageX - this.slider.offset().left) / this.slider.width() ) * 100 ); percent = Math.round( ( ( data.pageX - this.slider.offset().left ) / this.slider.width() ) * 100 );
} else { } else {
if ( val == null ) { if ( val == null ) {
val = (cType === "input") ? parseFloat(control.val()) : control[0].selectedIndex; val = cType === "input" ? parseFloat( control.val() ) : control[0].selectedIndex;
} }
percent = (parseFloat(val) - min) / (max - min) * 100; percent = ( parseFloat( val ) - min ) / ( max - min ) * 100;
} }
if ( isNaN(percent) ) { return; } if ( isNaN( percent ) ) {
if ( percent < 0 ) { percent = 0; } return;
if ( percent > 100 ) { percent = 100; } }
var newval = Math.round( (percent / 100) * (max - min) ) + min; if ( percent < 0 ) {
if ( newval < min ) { newval = min; } percent = 0;
if ( newval > max ) { newval = max; } }
//flip the stack of the bg colors if ( percent > 100 ) {
percent = 100;
}
var newval = Math.round( ( percent / 100 ) * ( max - min ) ) + min;
if ( newval < min ) {
newval = min;
}
if ( newval > max ) {
newval = max;
}
// Flip the stack of the bg colors
if ( percent > 60 && cType === "select" ) { if ( percent > 60 && cType === "select" ) {
// TODO: Dead path?
} }
this.handle.css("left", percent + "%"); this.handle.css( "left", percent + "%" );
this.handle.attr({ this.handle.attr( {
"aria-valuenow": (cType === "input") ? newval : control.find("option").eq(newval).attr("value"), "aria-valuenow": cType === "input" ? newval : control.find( "option" ).eq( newval ).attr( "value" ),
"aria-valuetext": (cType === "input") ? newval : control.find("option").eq(newval).text(), "aria-valuetext": cType === "input" ? newval : control.find( "option" ).eq( newval ).text(),
title: newval title: newval
}); });
// add/remove classes for flip toggle switch // add/remove classes for flip toggle switch
if ( cType === "select" ) { if ( cType === "select" ) {
if ( newval === 0 ) { if ( newval === 0 ) {
this.slider.addClass("ui-slider-switch-a") this.slider.addClass( "ui-slider-switch-a" )
.removeClass("ui-slider-switch-b"); .removeClass( "ui-slider-switch-b" );
} else { } else {
this.slider.addClass("ui-slider-switch-b") this.slider.addClass( "ui-slider-switch-b" )
.removeClass("ui-slider-switch-a"); .removeClass( "ui-slider-switch-a" );
} }
} }
if(!preventInputUpdate){ if ( !preventInputUpdate ) {
// update control's value // update control"s value
if ( cType === "input" ) { if ( cType === "input" ) {
control.val(newval); control.val( newval );
} else { } else {
control[ 0 ].selectedIndex = newval; control[ 0 ].selectedIndex = newval;
} }
if (!isfromControl) { control.trigger("change"); } if ( !isfromControl ) {
control.trigger( "change" );
}
} }
}, },
enable: function(){ enable: function() {
this.element.attr("disabled", false); this.element.attr( "disabled", false );
this.slider.removeClass("ui-disabled").attr("aria-disabled", false); this.slider.removeClass( "ui-disabled" ).attr( "aria-disabled", false );
return this._setOption("disabled", false); return this._setOption( "disabled", false );
}, },
disable: function(){ disable: function() {
this.element.attr("disabled", true); this.element.attr( "disabled", true );
this.slider.addClass("ui-disabled").attr("aria-disabled", true); this.slider.addClass( "ui-disabled" ).attr( "aria-disabled", true );
return this._setOption("disabled", true); return this._setOption( "disabled", true );
} }
}); });