From 3191432c402f0675e5d9075e70cd4064c28b98c7 Mon Sep 17 00:00:00 2001 From: friendica Date: Thu, 18 Sep 2014 16:46:17 -0700 Subject: [PATCH] add stylish_select library to provide a way to clean up and theme all the ugly select boxes --- library/stylish_select/index.html | 314 +++++++++++ .../stylish_select/jquery.stylish-select.js | 492 ++++++++++++++++++ library/stylish_select/select-bg.png | Bin 0 -> 2438 bytes library/stylish_select/stylish-select.css | 121 +++++ 4 files changed, 927 insertions(+) create mode 100644 library/stylish_select/index.html create mode 100644 library/stylish_select/jquery.stylish-select.js create mode 100755 library/stylish_select/select-bg.png create mode 100755 library/stylish_select/stylish-select.css diff --git a/library/stylish_select/index.html b/library/stylish_select/index.html new file mode 100644 index 000000000..b711c09f6 --- /dev/null +++ b/library/stylish_select/index.html @@ -0,0 +1,314 @@ + + + + jQuery Stylish Select 0.4.9 plugin examples + + + + + + + + + + + + +
+

Stylish Select 0.4.9

+

A cross-browser, accessible alternative to the standard form element which can be fully customised with CSS

+

Stylish Select attempts to replicate the functionality of the browser default select box as closely as possible with support for keyboard navigation, and intelligent positioning.

+

Stylish Select aims to have a minimal code footprint and weighs in at just over 3KB when minified.

+ Get latest source code from GitHub +

Usage

+

First, include the stylesheet, jQuery and the stylish select .js file in your html head tag.

+

The plugin can be used to replace any select with the following:

+ 
+$(document).ready(function(){
+$('#my-dropdown').sSelect();
+});
+
+
+

Simplest example, option selected by default

+

You can use the alphabetical and arrow keys to navigate the list as you would a browser default select.

+ +
+
+

Change event

+

Stylish Select alters the original select on the page, so you can access it's change event:

+ 
+//change event
+$('#my-dropdownChange').sSelect().change(function(){alert('changed')});
+
+ +
+
+

Grouped options

+

Stylish Select supports optgroups and also optgroups and options together.

+ +
+
+

Getting/setting the value

+ 
+//set value
+$('#setVal').click(function(){
+$('#my-dropdown5').getSetSSValue(4);
+});
+
+//get value
+$('#getVal').click(function(){
+alert('The value is: '+$('#my-dropdown5').getSetSSValue());
+});
+
+

Set value to 4

+

Get value

+ +
+
+

Add new options to Stylish Select

+ 
+//add options to select and update
+$('#addOptions').click(function(){
+$('#my-dropdown6').append('<option value="newOpt">New Option</option>').resetSS();
+});
+
+

If you add or remove options from the initial select element on the page, be sure to call the .resetSS() method on the select to update the Stylish Select replacement.

+ +

Add new options to select and update

+ +
+
+

Max-height for large lists

+ 
+$('#my-dropdown').sSelect({ddMaxHeight: '300px'});
+
+ +
+
+

Intelligent positioning

+

Stylish Select will always remain visible on the page.

+ +
+
+

Disabled Select

+ +
+
+

Disabled Options

+ +
+
+

Disabled Grouped options

+ +
+
+ + \ No newline at end of file diff --git a/library/stylish_select/jquery.stylish-select.js b/library/stylish_select/jquery.stylish-select.js new file mode 100644 index 000000000..61a38ca8d --- /dev/null +++ b/library/stylish_select/jquery.stylish-select.js @@ -0,0 +1,492 @@ +/** +* Stylish Select 0.4.9 - jQuery plugin to replace a select drop down box with a stylable unordered list +* http://github.com/scottdarby/Stylish-Select +* +* Requires: jQuery 1.3 or newer +* +* Contributions from Justin Beasley: http://www.harvest.org/ +* Anatoly Ressin: http://www.artazor.lv/ Wilfred Hughes: https://github.com/Wilfred +* Grigory Zarubin: https://github.com/Craigy- +* +* Dual licensed under the MIT and GPL licenses. +*/ +(function($){ + //add class to html tag + $('html').addClass('stylish-select'); + + //Cross-browser implementation of indexOf from MDN: https://developer.mozilla.org/en/JavaScript/Reference/Global_Objects/Array/indexOf + if (!Array.prototype.indexOf){ + Array.prototype.indexOf = function(searchElement /*, fromIndex */){ + if (this === void 0 || this === null) + throw new TypeError(); + + var t = Object(this); + var len = t.length >>> 0; + if (len === 0) + return -1; + + var n = 0; + if (arguments.length > 0){ + n = Number(arguments[1]); + if (n !== n) // shortcut for verifying if it's NaN + n = 0; + else if (n !== 0 && n !== (1 / 0) && n !== -(1 / 0)) + n = (n > 0 || -1) * Math.floor(Math.abs(n)); + } + + if (n >= len) + return -1; + + var k = n >= 0 + ? n + : Math.max(len - Math.abs(n), 0); + + for (; k < len; k++){ + if (k in t && t[k] === searchElement) + return k; + } + return -1; + }; + } + + //utility methods + $.fn.extend({ + getSetSSValue: function(value){ + if (value){ + //set value and trigger change event + $(this).val(value).change(); + return this; + } else { + return $(this).find(':selected').val(); + } + }, + //added by Justin Beasley + resetSS: function(){ + var oldOpts = $(this).data('ssOpts'); + $this = $(this); + $this.next().remove(); + //unbind all events and redraw + $this.unbind('.sSelect').sSelect(oldOpts); + } + }); + + $.fn.sSelect = function(options){ + return this.each(function(){ + var defaults = { + defaultText: 'Please select', + animationSpeed: 0, //set speed of dropdown + ddMaxHeight: '', //set css max-height value of dropdown + containerClass: '' //additional classes for container div + }; + + //initial variables + var opts = $.extend(defaults, options), + $input = $(this), + $containerDivText = $('
'), + $containerDiv = $('
'), + $containerDivWrapper = $(''), + $newUl = $(''), + currentIndex = -1, + prevIndex = -1, + keys = [], + prevKey = false, + prevented = false, + $newLi; + + //added by Justin Beasley + $(this).data('ssOpts',options); + + if( $(this).next('.newListSelected').length ) { + return; + } + + //build new list + $containerDiv.insertAfter($input); + $containerDiv.attr("tabindex", $input.attr("tabindex") || "0"); + $containerDivText.prependTo($containerDiv); + $newUl.appendTo($containerDiv); + $newUl.wrap($containerDivWrapper); + $containerDivWrapper = $newUl.parent(); + $input.hide(); + + if($input.is(':disabled')){ + return; + } + + //added by Justin Beasley (used for lists initialized while hidden) + $containerDivText.data('ssReRender',!$containerDivText.is(':visible')); + + //add one item to list + function addItem(item, container) { + var option = $(item).text(), + key = $(item).val(), + isDisabled = $(item).is(':disabled'); + + if (!isDisabled && !$(item).parents().is(':disabled')) { + //add first letter of each word to array + keys.push(option.charAt(0).toLowerCase()); + } + container.append($('
  • '+option+'
    • ').data({ + 'key' : key, + 'selected' : $(item).is(':selected') + })); + } + + $input.children().each(function(){ + if ($(this).is('option')){ + addItem(this, $newUl); + } else { + var optionTitle = $(this).attr('label'), + $optGroup = $('
  • '+optionTitle+'
    • '), + $optGroupList = $(''); + + $optGroup.appendTo($newUl); + $optGroupList.appendTo($optGroup); + + $(this).children().each(function(){ + addItem(this, $optGroupList); + }); + } + }); + + //cache list items object + $newLi = $newUl.find('li a:not(.newListItemDisabled)').not(function(){ + return $(this).parents().hasClass('newListOptionDisabled'); + }); + + //get selected item from new list (because it doesn't contain disabled options) + $newLi.each(function(i){ + if ($(this).parent().data('selected')){ + opts.defaultText = $(this).html(); + currentIndex = prevIndex = i; + } + }); + + //get heights of new elements for use later + var newUlHeight = $newUl.height(), + containerHeight = $containerDiv.height(), + newLiLength = $newLi.length; + + //check if a value is selected + if (currentIndex != -1){ + navigateList(currentIndex); + } else { + //set placeholder text + $containerDivText.text(opts.defaultText); + } + + //decide if to place the new list above or below the drop-down + function newUlPos(){ + var containerPosY = $containerDiv.offset().top, + docHeight = $(window).height(), + scrollTop = $(window).scrollTop(); + + //if height of list is greater then max height, set list height to max height value + if (newUlHeight > parseInt(opts.ddMaxHeight)){ + newUlHeight = parseInt(opts.ddMaxHeight); + } + + containerPosY = containerPosY-scrollTop; + if (containerPosY+newUlHeight >= docHeight){ + $newUl.css({ + height: newUlHeight + }); + $containerDivWrapper.css({ + top: '-'+newUlHeight+'px', + height: newUlHeight + }); + $input.onTop = true; + } else { + $newUl.css({ + height: newUlHeight + }); + $containerDivWrapper.css({ + top: containerHeight+'px', + height: newUlHeight + }); + $input.onTop = false; + } + } + + //run function on page load + newUlPos(); + + //run function on browser window resize + $(window).bind('resize.sSelect scroll.sSelect', newUlPos); + + //positioning + function positionFix(){ + $containerDiv.css('position','relative'); + } + + function positionHideFix(){ + $containerDiv.css( + { + position: 'static' + }); + } + + $containerDivText.bind('click.sSelect',function(event){ + event.stopPropagation(); + + //added by Justin Beasley + if($(this).data('ssReRender')){ + newUlHeight = $newUl.height('').height(); + $containerDivWrapper.height(''); + containerHeight = $containerDiv.height(); + $(this).data('ssReRender',false); + newUlPos(); + } + + //hide all menus apart from this one + $('.SSContainerDivWrapper') + .not($(this).next()) + .hide() + .parent() + .css('position', 'static') + .removeClass('newListSelFocus'); + + //show/hide this menu + $containerDivWrapper.toggle(); + positionFix(); + + //scroll list to selected item + if(currentIndex == -1) currentIndex = 0; + try { + $newLi.eq(currentIndex).focus(); + } catch(ex) {} + }); + + function closeDropDown(fireChange, resetText){ + if(fireChange == true){ + prevIndex = currentIndex; + $input.change(); + } + + if(resetText == true){ + currentIndex = prevIndex; + navigateList(currentIndex); + } + + $containerDivWrapper.hide(); + positionHideFix(); + } + + $newLi.bind('click.sSelect',function(e){ + var $clickedLi = $(e.target); + + //update counter + currentIndex = $newLi.index($clickedLi); + + //remove all hilites, then add hilite to selected item + prevented = true; + navigateList(currentIndex, true); + closeDropDown(); + }); + + $newLi.bind('mouseenter.sSelect', + function(e){ + var $hoveredLi = $(e.target); + $hoveredLi.addClass('newListHover'); + }).bind('mouseleave.sSelect', + function(e){ + var $hoveredLi = $(e.target); + $hoveredLi.removeClass('newListHover'); + }); + + function navigateList(currentIndex, fireChange){ + if(currentIndex == -1){ + $containerDivText.text(opts.defaultText); + $newLi.removeClass('hiLite'); + } else { + $newLi.removeClass('hiLite') + .eq(currentIndex) + .addClass('hiLite'); + + var text = $newLi.eq(currentIndex).text(), + val = $newLi.eq(currentIndex).parent().data('key'); + + try { + $input.val(val); + } catch(ex) { + // handle ie6 exception + $input[0].selectedIndex = currentIndex; + } + + $containerDivText.text(text); + + //only fire change event if specified + if(fireChange == true){ + prevIndex = currentIndex; + $input.change(); + } + + if ($containerDivWrapper.is(':visible')){ + try { + $newLi.eq(currentIndex).focus(); + } catch(ex) {} + } + } + } + + $input.bind('change.sSelect',function(event){ + var $targetInput = $(event.target); + //stop change function from firing + if (prevented == true){ + prevented = false; + return false; + } + var $currentOpt = $targetInput.find(':selected'); + currentIndex = $targetInput.find('option').index($currentOpt); + navigateList(currentIndex); + }); + + //handle up and down keys + function keyPress(element){ + //when keys are pressed + $(element).unbind('keydown.sSelect').bind('keydown.sSelect',function(e){ + var keycode = e.which; + + //prevent change function from firing + prevented = true; + + switch(keycode){ + case 40: //down + case 39: //right + incrementList(); + return false; + break; + case 38: //up + case 37: //left + decrementList(); + return false; + break; + case 33: //page up + case 36: //home + gotoFirst(); + return false; + break; + case 34: //page down + case 35: //end + gotoLast(); + return false; + break; + case 13: //enter + case 27: //esc + closeDropDown(true); + return false; + break; + case 9: //tab + closeDropDown(true); + nextFormElement(); + return false; + break; + } + + //check for keyboard shortcuts + keyPressed = String.fromCharCode(keycode).toLowerCase(); + + var currentKeyIndex = keys.indexOf(keyPressed); + + if (typeof currentKeyIndex != 'undefined'){ //if key code found in array + ++currentIndex; + currentIndex = keys.indexOf(keyPressed, currentIndex); //search array from current index + + if (currentIndex == -1 || currentIndex == null || prevKey != keyPressed){ + // if no entry was found or new key pressed search from start of array + currentIndex = keys.indexOf(keyPressed); + } + + navigateList(currentIndex); + //store last key pressed + prevKey = keyPressed; + return false; + } + }); + } + + function incrementList(){ + if (currentIndex < (newLiLength-1)){ + ++currentIndex; + navigateList(currentIndex); + } + } + + function decrementList(){ + if (currentIndex > 0){ + --currentIndex; + navigateList(currentIndex); + } + } + + function gotoFirst(){ + currentIndex = 0; + navigateList(currentIndex); + } + + function gotoLast(){ + currentIndex = newLiLength-1; + navigateList(currentIndex); + } + + $containerDiv.bind('click.sSelect',function(e){ + e.stopPropagation(); + keyPress(this); + }); + + $containerDiv.bind('focus.sSelect',function(){ + $(this).addClass('newListSelFocus'); + keyPress(this); + }); + + $containerDiv.bind('blur.sSelect',function(){ + $(this).removeClass('newListSelFocus'); + }); + + //hide list on blur + $(document).bind('click.sSelect',function(){ + $containerDiv.removeClass('newListSelFocus'); + if ($containerDivWrapper.is(':visible')){ + closeDropDown(false, true); + } else { + closeDropDown(false); + } + }); + + //select next form element in document + function nextFormElement() { + var fields = $('body').find('button,input,textarea,select'), + index = fields.index($input); + if (index > -1 && (index + 1) < fields.length) { + fields.eq(index + 1).focus(); + } + return false; + } + // handle focus on original select element + $input.focus(function(){ + $input.next().focus(); + }); + + //add classes on hover + $containerDivText.bind('mouseenter.sSelect', + function(e){ + var $hoveredTxt = $(e.target); + $hoveredTxt.parent().addClass('newListSelHover'); + }).bind('mouseleave.sSelect', + function(e){ + var $hoveredTxt = $(e.target); + $hoveredTxt.parent().removeClass('newListSelHover'); + }); + + //reset left property and hide + $containerDivWrapper.css({ + left: '0', + display: 'none', + visibility: 'visible' + }); + + }); + + }; + +})(jQuery); \ No newline at end of file diff --git a/library/stylish_select/select-bg.png b/library/stylish_select/select-bg.png new file mode 100755 index 0000000000000000000000000000000000000000..151eda726894b8cc21f051b7371e8fe209748969 GIT binary patch literal 2438 zcmV;133>L3P)vcmx_KVYS|=8yC9klt({PS z0wJP-K~gSa)x?U_f>3Gs&_Yo|G*}o5w4=}#GL>=3g(L*q@!iMX^Pbqw%}(r$Z~p(J zM?S}XUw^RVzn{!v1Q8^eSUuaZ)`T(Dn(H$jYi{KgTYWJNfPOFIsyRX z7N_5TpB`PkN*4bA%N)`aV`K42y}u?RLt`%OhEqNw3#yLIg1aAouv&n{U#rFP!tQ;J%AAVR~S5Sr}O)s|ZQJMh&GDYg^ zqm^7mEqm>?X~+KSgAeF3XGV#VEm4+wCd>DwKp@Z+3zWXU4sE>%<9qc=c*(A&N(YMvjWajK<5-@bK_i4)Xi`njj%N0szc}Z|dtQ8X8&k z346WTTG4bu6lNic$TEc`>910Kef>{ELqq4?Za4XSK24C29RUEc#eeS}T|06_yT07i zM4^F!v|~j!Bu?`CIphTkx?0bixvOoT_4oI09N>wM9zB8}0RU#qrN%}Yym5p6eeht~ ztVnAq!r^0$@rffLPUp+wGfj-@>gqbXySw-I_4U!<;2?Q9#R_q{B}z7k5&$4mRF8*F zR##Ij6q+PLV_S&~v$nW7lXxu?DTg~Yt17;WCXS>3vI>kF!?9^|a(RZ*^q^J)n} z5@*)Xau$HxC8(;}g0skMB%+M^8BG)-QJM{lb)sd1aGIllMYxozp@7`(l`sZ%nKM-8#?1h}@- zi^XhN?uR=F0J%$;bwHF`k@$T^?jUBf8VZL=CmyN}g~Ai{Mky&76{A#Nbl}L5+9eAY z?#OpIDr`0z<(bW+?jVFkYyfhR0!7h!7bVIxT_$Ck&!<;?K1-;-f4LfqEw6v}**{Tf z>4v6HKAGAbWc%*j`m#B5_AFemV0~dh0nHLZG{{Oq&T?jS;l=9QP9EH5psEh#Q0hv@t${L+LFu?S&nAAsEE zvABcKNJBN(_3PF3&p-cN>y;~$-9hG*lr(TwR9iZGHfdQ=Vq2ffGq{5Q0J0^WJBXD- za|gL~Yxx^1SB`fF*?;KJ3eJW$6%`ha`lXF=kOcsM$01A!cM#ExUvmff@yAzwS5-CY z4)P19a~p@=5pT*bqbWZCU>c%|LMm5JnW7&aCMgg|x`T+Fxj-bMQ$3y$caY|mmXf7Q zmekC$+eh3%kPQIy3S*?2W*zJ3W z5ddHsr2c;TC09`ut5;7u_R7J7bcHjcM9G#Y%Vd!;`TaV*s=gz!2(2)gOjsiV0A$Uj z=4J}ITvLwm_Vv-#0|zFH8BOI50wDqbWP!@rPUnXoPC4en&YcvS&K)Egg*ylU;Q!;s z#~+jX&YhH>^>%jBoiD$fa(-%e5HwN)0Ax!fLhTI=sk5TS#%80JA)l}-;tUDd5da`t0^Qwo{n#<>`bujn zg&#glU)hay2bnjo>u_7!h&#x@;NZqVp6GJBNBq+uNC1EtaC!fJdU*3DT|0U-ZB~?U z2k~?G#FN+#$EZ8V8*A5g_Vo7df6(7g4_TB%|Lah^WP>OH05T;yJWQuvW^I|q9VF3| zUw-n*&kwY!`;!7RQHZpr{CussgDhNlv!$bB zvOCBhH*QpSHaCyBgM`DciuEIVyvw8J4k8|kM9WzKa+ah!NW7%V+8socW(jwYrAs?@ zeeuOOcaU+N9ye{+AjYpb^wCFW-EMb7zQeIdQIw=0=^;h{