If you’re more interested in the why than the how, check the about page.

Options

hideSelect

  • default: true
  • show/hide original select-field

showCheckbox

  • default: true
  • show/hide checkboxes in the list (multiselect only)
  • demo

selectAll

  • default: true
  • not yet implemented

minItemFilter

  • default: 5
  • not yet implemented

maxItems

  • default: 3
  • max the number of selected items that will be displayed by option-title; -1 will display all selected items
  • demo

minWidth

  • default: 0
  • minimal width of ui-element (trigger and list)
  • 0 = auto

defaultDisplayTitle

  • default: ‘No value selected’
  • display title, when no item is selected
  • demo

displayTextSG

  • default: ‘1 of ## value selected’
  • display title for one selected item,
  • depends on maxItems
  • demo

displayTextPL

  • default: ‘@@ of ## values selected’
  • demo

Events

  • complete » widget initiation is finished
  • update » ui has been updated to fit latest changes
  • change » select-value has been changed
  • select » value has been selected
  • open » list is displayed
  • close » list is closed

An important thing to mention: the click event needs actually to be a mousedown, to be able to handle it before the blur of the display.