Class: SC.SelectView


Extends SC.ButtonView.

SelectView has a functionality similar to that of SelectField

Clicking the SelectView button displays a menu pane with a list of items. The selected item will be displayed on the button. User has the option of enabling checkbox for the selected menu item.

Defined in: select.js

Field Summary

Fields borrowed from SC.ButtonView:
action, ariaRole, autoResizePadding, buttonBehavior, contentIconKey, contentTitleKey, isCancel, isDefault, keyEquivalent, renderDelegateName, target, themeName, toggleOffValue, toggleOnValue
Fields borrowed from SC.View:
ariaHidden, attributeBindings, autoMixins, backgroundColor, childViewLayout, childViewLayoutOptions, childViews, childViewsNeedLayout, classNameBindings, concatenatedProperties, createdByParent, designMode, enabledState, firstKeyView, hasLayout, hasTouch, hasVisibility, isBuildingIn, isBuildingOut, isChildViewLayoutLive, isEnabled, isFixedHeight, isFixedPosition, isFixedSize, isFixedWidth, isKeyResponder, isTextSelectable, isView, isVisible, lastKeyView, layerLocationNeedsUpdate, layerNeedsUpdate, layout, modeAdjust, nextKeyView, page, pane, parentView, previousKeyView, shouldInheritCursor, shouldInheritEnabled, tagName, toolTip, touchBoundary, transitionAdjust, transitionAdjustOptions, transitionHide, transitionHideOptions, transitionIn, transitionInOptions, transitionOut, transitionOutOptions, transitionShow, transitionShowOptions, useStaticLayout
Fields borrowed from SC.Responder:
hasFirstResponder, isFirstResponder, responderContext
Fields borrowed from SC.Object:
isDestroyed, isObject, nextProperty, object, property, toInvalidate
Fields borrowed from SC.Observable:
isObservable
Fields borrowed from SC.Control:
controlSize, errorLabel, fieldKey, fieldLabel, isActive, isControl, isSelected

Instance Methods

Field Detail

acceptsFirstResponder Boolean
Default value:
YES
acceptsMultitouch Boolean

Whether to receive touch events for each distinct touch (rather than only the first touch start and last touch end).


Defined in: gesture.js.
Default value:
false
See:
SC.View#acceptsMultitouch
checkboxEnabled Boolean

if this property is set to 'YES', a checkbox is shown next to the selected menu item.

Default value:
YES
children
Array of child tree items. Extracted from the item automatically on init.
Defined in: tree_item_observer.js.
classNames Array
Default value:
['sc-select-button']
See:
SC.View#classNames
CUSTOM_MENU_ITEM_HEIGHT Number

Property to set the menu item height. This in turn is used for the calculation of prefMatrix.

Default value:
20
customViewMenuOffsetWidth Number
customView menu offset width
Default value:
0
delegate

The controller delegate. If the item does not implement the TreeItemContent method, delegate properties will be used to determine how to access the content. Set automatically when a tree item is created.

If you are creating an observer manually, you must set this to a non-null value.


Defined in: tree_item_observer.js.
disableSort Boolean

if true, it means that no sorting will occur, items will appear in the same order as in the array

Default value:
YES
disclosureState Number

Disclosure state of this item. Must be SC.BRANCH_OPEN or SC.BRANCH_CLOSED If this is the root of a item tree, the observer will have children but no parent or parent item. IN this case the disclosure state is always SC.BRANCH_OPEN.


Defined in: tree_item_observer.js.
displayProperties SC.Array
Default value:
['icon', 'value','controlSize']
See:
SC.View#displayProperties
emptyName String
Set this to non-null to place an empty option at the top of the menu.
Default value:
null
escapeHTML Boolean
If true, titles will be escaped to avoid scripting attacks.
Default value:
YES
exampleView SC.View
Example view used for menu items.
Default value:
null
format
The standard format you want the validator to convert dates to.
Defined in: date_time.js.
SC.SelectView.HUGE_OFFSET_X Number
Default value:
0
SC.SelectView.HUGE_OFFSET_Y Number
Default value:
0
SC.SelectView.HUGE_POPUP_MENU_WIDTH_OFFSET Number
Default value:
0
index

Index location in parent's children array. If this is the root item in the tree, should be null.


Defined in: tree_item_observer.js.
interval
The duration between idle runs.
Defined in: task_queue.js.
isContextMenuEnabled Boolean
Default value:
NO
isDefaultPosition Boolean

If this property is set to 'YES', the menu pane will be positioned below the anchor.

Default value:
NO
isRunning
If running, YES.
Defined in: task_queue.js.
item

The node in the tree this observer will manage. Set when creating the object. If you are creating an observer manually, you must set this to a non-null value.


Defined in: tree_item_observer.js.
itemIconKey String
Key used to extract icons from the items array
Default value:
null
itemIsEnabledKey String
Key used to indicate if the item is to be enabled.
Default value:
"isEnabled"
items Array
An array of items that will be form the menu you want to show.
Default value:
[]
itemsBindingDefault
Binding default for an array of items
Defined in: select.js.
Default value:
SC.Binding.multiple()
itemSeparatorKey String
Key to use to identify separators.
Default value:
"isSeparator"
itemSortKey String

If you set this to a non-null value, then the value of this key will be used to sort the items. If this is not set, then itemTitleKey will be used.

Default value:
null
itemTitleKey String

If you set this to a non-null value, then the name shown for each menu item will be pulled from the object using the named property. if this is null, the collection items themselves will be used.

Default value:
null
itemValueKey String

Set this to a non-null value to use a key from the passed set of items as the value for the options popup. If you don't set this, then the items themselves will be used as the value.

Default value:
null
SC.SelectView.LARGE_OFFSET_X Number
Default value:
-17
SC.SelectView.LARGE_OFFSET_Y Number
Default value:
6
SC.SelectView.LARGE_POPUP_MENU_WIDTH_OFFSET Number
Default value:
3
length
Get the current length of the tree item including any of its children.
Defined in: tree_item_observer.js.
localize Boolean
Default value:
YES
menu SC.View
Menu attached to the SelectView.
Default value:
SC.MenuView
SC.SelectView.MENU_WIDTH_OFFSET Number
Default value:
-2
menuItemPadding Number

The amount of space to add to the calculated width of the menu item strings to determine the width of the menu pane.

Default value:
35
menuLeftOffset Number

The amount by which to offset the menu's left position when displaying it. This can be used to make sure the selected menu item is directly on top of the label in the SelectView.

By default, this comes from the render delegate's menuLeftOffset property. If you are writing a theme, you should set the value there.


Defined in: select.js.
Default value:
'menuLeftOffset' from render delegate if present, or 0.
menuMinimumWidthOffset Number

An amount to add to the menu's minimum width. For instance, this could be set to a negative value to let arrows on the side of the SelectView be visible.

By default, this comes from the render delegate's menuMinimumWidthOffset property. If you are writing a theme, you should set the value there.


Defined in: select.js.
Default value:
'menuWidthOffset' from render delegate if present, or 0.
menuPaneHeightPadding Number

This property allows you at add extra padding to the height of the menu pane.

Default value:
0
menuTopOffset Number

The amount by which to offset the menu's top position when displaying it. This is added to any amount calculated based on the 'top' of a menu item.

This can be used to make sure the selected menu item's label is directly on top of the SelectView's label.

By default, this comes from the render delegate's menuTopOffset property. If you are writing a theme, you should set the value there.


Defined in: select.js.
Default value:
'menuTopOffset' from render delegate if present, or 0.
minimumIdleDuration

The minimum elapsed time since the last event. As a rule of thumb, perhaps something equivalent to the expected duration of a task.


Defined in: task_queue.js.
name String

The gesture's name. When calling events on the owning SC.View, this name will be prefixed to the methods. For instance, if the method to be called is 'Start', and the gesture's name is 'swipe', SC.Gesture will call 'swipeStart'.


Defined in: gesture.js.
Default value:
"gesture"
needsEllipsis Boolean
This is a property for enabling/disabling ellipsis
Default value:
YES
parentObserver
The parent TreeItemObserver for this observer. Must be set on create.
Defined in: tree_item_observer.js.
preferMatrix Array

Prefer matrix to position the select button menu such that the selected item for the menu item will appear aligned to the the button. The value at the second index(0) changes based on the position(index) of the menu item in the menu pane.

Default value:
null
SC.SelectView.REGULAR_OFFSET_X Number
Default value:
-17
SC.SelectView.REGULAR_OFFSET_Y Number
Default value:
1
SC.SelectView.REGULAR_POPUP_MENU_WIDTH_OFFSET Number
Default value:
4
runLimit

A limit which, if exceeded, the task queue will wait until a later run to continue.


Defined in: task_queue.js.
runWhenIdle
If YES, the queue will automatically run in the background when the browser idles.
Defined in: task_queue.js.
showCheckbox Boolean

if this property is set to 'YES', a checkbox is shown next to the selected menu item.

Default value:
YES
sizes

A list of size names to look for when automatically determining control size. By default, this has all of the SproutCore control sizes.


Defined in: sizing.js.
SC.SelectView.SMALL_OFFSET_X Number
Default value:
-18
SC.SelectView.SMALL_OFFSET_Y Number
Default value:
3
SC.SelectView.SMALL_POPUP_MENU_WIDTH_OFFSET Number
Default value:
7
supportFocusRing Boolean

This is a property to enable/disable focus rings in buttons. For select_button, we are making it a default.

Default value:
YES
See:
SC.ButtonView#supportFocusRing
supportsFocusRing

This is a property to enable/disable focus rings in buttons. For SelectView, it is a default.


Defined in: select.js.
Default value:
YES
theme String
The button theme will be popup
Default value:
'popup'
SC.SelectView.TINY_OFFSET_X Number
Default value:
0
SC.SelectView.TINY_OFFSET_Y Number
Default value:
0
SC.SelectView.TINY_POPUP_MENU_WIDTH_OFFSET Number
Default value:
0
treeItemChildrenKey String

The key used to retrieve children from the observed item. If a delegate exists, the key will be the value of the treeItemChildrenKey property of the delegate. Otherwise, the key will be treeItemChildren.


Defined in: tree_item_observer.js.
Default value:
'treeItemChildren'
treeItemIsExpandedKey String

The key used to identify the expanded state of the observed item. If a delegate exists, the key will be the value of the treeItemIsExpandedKey property of the delegate. Otherwise, the key will be treeItemIsExpanded.


Defined in: tree_item_observer.js.
Default value:
'treeItemIsExpanded'
value Object
Current Value of the SelectView
Default value:
null

Instance Method Detail

addSizeClassName(dataSource, context)

Determines the proper size for the dataSource, and then renders the class name corresponding to that size.


Defined in: sizing.js.
Parameters:
dataSource
context
branchIndexes()

IndexSet of children with branches. This will ask the delegate to name these indexes. The default implementation will iterate over the children of the item but a more optimized version could avoid touching each item.


Defined in: tree_item_observer.js.
branchObserverAt(index)

Returns the branch item for the specified index. If none exists yet, it will be created.


Defined in: tree_item_observer.js.
Parameters:
index
cancel()

Cancels the gesture, if it is active, and notifies the view that the gesture has been cancelled.

Gestures are cancelled when they have ended, but any action that would normally be appropriate due to their ending should not be performed.

The gesture, along with any arguments to cancel(), will be passed to the appropriate method on the SC.View.


Defined in: gesture.js.
capitalizeEach()

Defined in: string.js.
See:
SC.String.capitalizeEach
change()

If the gesture is active, notifies the view that the gesture has changed.

The gesture, along with any arguments to change(), will be passed to the appropriate method on the SC.View.


Defined in: gesture.js.
classify(str)

Defined in: string.js.
Parameters:
str
See:
SC.String.classify
contentGroupIndexes(view, content)

SC.CollectionContent Called by the collection view to return any group indexes. The default implementation will compute the indexes one time based on the delegate treeItemIsGrouped


Defined in: tree_item_observer.js.
Parameters:
view
content
contentIndexCollapse(view, content, idx)

Called to collapse a content index item if it is currently in an open disclosure state. The default implementation does nothing.


Defined in: tree_item_observer.js.
Parameters:
view SC.CollectionView
the collection view
content SC.Array
the content object
idx Number
the content index
Returns:
void
contentIndexDisclosureState(view, content, index)
Returns the disclosure state for the specified index.
Defined in: tree_item_observer.js.
Parameters:
view
content
index
contentIndexExpand(view, content, idx)

Expands the specified content index. This will search down until it finds the branchObserver responsible for this item and then calls _collapse on it.


Defined in: tree_item_observer.js.
Parameters:
view
content
idx
contentIndexIsGroup(view, content, idx)
SC.CollectionContent
Defined in: tree_item_observer.js.
Parameters:
view
content
idx
contentIndexOutlineLevel(view, content, index)
Returns the outline level for the specified index.
Defined in: tree_item_observer.js.
Parameters:
view
content
index
destroy()

SC.Object.prototype.destroy Called just before a branch observer is removed. Should stop any observing and invalidate any child observers.


Defined in: tree_item_observer.js.
displayItems()

Returns an array of normalized display items.

Adds the empty name to the items if applicable.

displayItems should never be set directly; instead, set items and displayItems will update automatically.


Defined in: select.js.
Returns:
Array
array of display items.
doExit(immediately, newContent)

Defined in: container.js.
Parameters:
immediately
newContent
end()

Ends the gesture, if it is active (marking it as not active), and notifies the view.

You may pass any number of arguments to end(). They, along with your gesture instance itself, will be passed to the appropriate gesture event on the SC.View.


Defined in: gesture.js.
entered()

Defined in: container.js.
escapeForRegExp(str)

Defined in: string.js.
Parameters:
str
See:
SC.String.escapeForRegExp
exited()

Defined in: container.js.
expandChildIndex(index)
Accepts a child index and expands it to reflect any nested groups.
Defined in: tree_item_observer.js.
Parameters:
index
fieldValueForObject(object, form, field)
if we have a number, then convert to a date object.
Defined in: date_time.js.
Parameters:
object
form
field
getPropertyFor(dataSource, propertyName)

Retrieves the given property for the specified data source. This property may be static, or may be computed specifically for this data source. This version fo getPropertyFor will check in your size hashes to see if any properties have been overridden.


Defined in: sizing.js.
Parameters:
dataSource DataSource
The data source to get the property for. Some properties may differ based on the data source; for instance, some may have different values depending on size.
propertyName String
The name of the property to retrieve.
gotoEnteringState()

Defined in: container.js.
gotoExitedState()

Defined in: container.js.
gotoExitingState(immediately)

Defined in: container.js.
Parameters:
immediately
gotoReadyState()

Defined in: container.js.
hasTasks()
Returns YES if there are tasks in the queue.
Defined in: task_queue.js.
htmlForTitleAndIcon(dataSource)

Generates the HTML for the title and icon of the label. Render delegates can override this to change how that HTML renders without affecting the rest of the rendering of the label.


Defined in: label.js.
Parameters:
dataSource
The data source that provides the title and icon properties.
Returns:
the html to use
humanize(str)

Defined in: string.js.
Parameters:
str
See:
SC.String.humanize
icon()
The icon of the button, derived from the selected item.
Defined in: select.js.
imageStyles(dataSource)

Defined in: image.js.
Parameters:
dataSource
init()
SC.Object.prototype.init
Defined in: tree_item_observer.js.
invalidateBranchObserversAt(index)
Invalidates any branch observers on or after the specified index range.
Defined in: tree_item_observer.js.
Parameters:
index
isHeaderVisible()

Returns YES if the item itself should be shown, NO if only its children should be shown. Normally returns YES unless the parentObject is null.


Defined in: tree_item_observer.js.
isValueEqualTo(object)
Check is the passed item is equal to the current value.
Defined in: select.js.
Parameters:
object Object
to check
Returns:
Boolean
minimumMenuWidth()

The minimum width for the child menu. For instance, this property can make the menu always cover the entire SelectView--or, alternatively, cover all but the arrows on the side.

By default, it is calculated by adding the menuMinimumWidthOffset to the view's width. If you are writing a theme and want to change the width so the menu covers a specific part of the select view, change your render delegate's menuMinimumWidthOffset property.


Defined in: select.js.
next()
Removes and returns the first task in the queue.
Defined in: task_queue.js.
objectAt(index, omitMaterializing)

Get the object at the specified index. This will talk the tree info to determine the proper place. The offset should be relative to the start of this tree item. Calls recursively down the tree.

This should only be called with an index you know is in the range of item or its children based on looking at the length.


Defined in: tree_item_observer.js.
Parameters:
index Number
omitMaterializing Boolean
Returns:
Object
objectForFieldValue(value, form, field)

Try to pass value as a date. convert into a number, or return null if it could not be parsed.


Defined in: date_time.js.
Parameters:
value
form
field
observerContentDidChange(start, amt, delta)

Called whenever the content for the passed observer has changed. Default version notifies the parent if it exists and updates the length.

The start, amt and delta params should reflect changes to the children array, not to the expanded range for the wrapper.


Defined in: tree_item_observer.js.
Parameters:
start
amt
delta
parentItem()

The parent item for the observer item. Computed automatically from the parent. If the value of this is null, then this is the root of the tree.


Defined in: tree_item_observer.js.
pluralize(str)

Defined in: string.js.
Parameters:
str
See:
SC.String.pluralize
push(task)
Adds the task to the end of the queue.
Defined in: task_queue.js.
Parameters:
task
rangeDidChange(array, objects, key, indexes)

Defined in: outline_case.js.
Parameters:
array
objects
key
indexes
removeDiacritics(str)

Defined in: string.js.
Parameters:
str
See:
SC.String.removeDiacritics
render(dataSource, context)

Defined in: label.js.
Parameters:
dataSource
context
replace(start, amt, objects, operation)

Implements SC.Array.replace() primitive. For this method to succeed, the range you replace must lie entirely within the same parent item, otherwise this will raise an exception.

The Operation Parameter

Note that this replace method accepts an additional parameter "operation" which is used when you try to insert an item on a boundary between branches whether it should be inserted at the end of the previous group after the group. If you don't pass operation, the default is SC.DROP_BEFORE, which is the expected behavior.

Even if the operation is SC.DROP_AFTER, you should still pass the actual index where you expect the item to be inserted. For example, if you want to insert AFTER the last index of an 3-item array, you would still call:

observer.replace(3, 0, [object1 .. objectN], SC.DROP_AFTER)

The operation is simply used to disambiguate whether the insertion is intended to be AFTER the previous item or BEFORE the items you are replacing.


Defined in: tree_item_observer.js.
Parameters:
start Number
the starting index
amt Number
the number of items to replace
objects SC.Array
array of objects to insert
operation Number
either SC.DROP_BEFORE or SC.DROP_AFTER
Returns:
SC.TreeItemObserver
receiver
resume()
Resumes cycling of the queue.
Defined in: task_queue.js.
run(limit)
Runs tasks until limit (TaskQueue.runLimit by default) is reached.
Defined in: task_queue.js.
Parameters:
limit
setup()

Defined in: nextValidKeyView.js.
singularize(str)

Defined in: string.js.
Parameters:
str
See:
SC.String.singularize
sizeFor(dataSource)

Determines the correct size for the given data source, and returns the hash, if any, representing it.

The hashes to choose from are properties on the render delegate. You define them with the same name as you would use for styling. For example, SC.REGULAR_CONTROL_SIZE uses a property name 'sc-regular-size':

SC.RenderDelegate.create({
  'sc-regular-size': {
    // my properties here
  }

If no matching size is found, the hash (if any) for SC.REGULAR_CONTROL_SIZE will be returned.


Defined in: sizing.js.
Parameters:
dataSource DataSource
The data source in which to find `controlSize` or `frame` and to determine the size for.
Returns:
Hash undefined
sortObjects(objects)

override this method to implement your own sorting of the menu. By default, menu items are sorted using the value shown or the sortKey

Parameters:
objects SC.Array
the unsorted array of objects to display.
Returns:
SC.Array
sorted array of objects
start()

Starts the gesture (marking it as "active"), and notifies the view.

You can pass any number of arguments to start. They will, along with the gesture instance itself, will be passed to the appropriate gesture event on the SC.View.


Defined in: gesture.js.
suspend()

Suspends cycling of the queue. Only affects task queues that run when idle, such as the backgroundTaskQueue.


Defined in: task_queue.js.
taskCount()
Returns the number of tasks in the queue.
Defined in: task_queue.js.
teardown()

Defined in: nextValidKeyView.js.
title()
The title of the button, derived from the selected item.
Defined in: select.js.
titleize(str)

Defined in: string.js.
Parameters:
str
See:
SC.String.titleize
toString()

Defined in: outline_case.js.
touchAddedToSession(touch, touchesInSession)

Defined in: gesture.js.
Parameters:
touch SC.Touch
The touch to be added to the session.
touchesInSession Array
The touches already in the session.
Returns:
Boolean
True if the gesture is still interested in the touch session; false to stop getting notified for any further touch changes in the touch session.
touchCancelledInSession(touch, touchesInSession)

Defined in: gesture.js.
Parameters:
touch SC.Touch
The touch to be removed from the session.
touchesInSession Array
The touches still remaining in the session.
Returns:
Boolean
True if the gesture is still interested in the touch session; false to stop getting notified for any further touch changes in the touch session.
touchEndedInSession(touch, touchesInSession)

Defined in: gesture.js.
Parameters:
touch SC.Touch
The touch to be removed from the session.
touchesInSession Array
The touches still remaining in the session.
Returns:
Boolean
True if the gesture is still interested in the touch session; false to stop getting notified for any further touch changes in the touch session.
touchesMovedInSession(touchesInSession)

Defined in: gesture.js.
Parameters:
touchesInSession Array
The touches in the session.
Returns:
Boolean
True if the gesture is still interested in the touch session; false to stop getting notified for any further touch changes in the touch session.
touchIsInGesture(touch, status)

Return YES to take exclusive control over the touch. In addition to the SC.Touch object you may take control of, you are also provided a "status" hash, which is unique for both the gesture instance and the touch instance, which you may use for your own purposes.


Defined in: gesture.js.
Parameters:
touch SC.Touch
The touch.
status Object
A unique status hash for the given touch.
Returns:
Boolean
true if the gesture should claim the touch; false to leave it unclaimed.
touchSessionCancelled()

Called by the view when the touch session was cancelled.

This will occur because this gesture returned false in any of touchAddedToSession, touchesMovedInSession, touchEndedInSession, touchCancelledInSession to indicate that the gesture is no longer interested in the session or because another gesture claimed the touch session for itself, forcing all other gestures out (rare).

You should override this method in your custom SC.Gesturable subclasses to clean up any state variables used in the touch session.


Defined in: gesture.js.
Returns:
void
touchSessionEnded()

Called by the view when the touch session has ended.

This will occur because all touches in the session have finished.

You should override this method in your custom SC.Gesturable subclasses to clean up any state variables used in the touch session.


Defined in: gesture.js.
Returns:
void
touchSessionStarted(touch)

Called by the view when a touch session has begun.

You should override this method in your custom SC.Gesturable subclasses to set up any touch session state. For example, you may want to track the initial touch start time in order to decide how to react when or if additional touches start later.


Defined in: gesture.js.
Parameters:
touch SC.Touch
The touch that started the session.
Returns:
void
touchStart(touch)

After you return YES from touchIsInGesture (or otherwise 'take' a touch, perhaps using the 'take' method), touchStart will be called.

This is where you do any logic needed now that the touch is part of the gesture. For instance, you could inform the view that the gesture has started by calling this.start().

NOTE: SC.Gesture is just like SC.View in that it has an acceptsMultitouch property. If NO (the default), the gesture will only receive touchStart for the first touch assigned to it, and only receive touchEnd for the last touch that ends.


Defined in: gesture.js.
Parameters:
touch SC.Touch
The touch that started.
Returns:
Boolean
true if the gesture should respond to the touch; false otherwise (this should always return true)
See:
SC.ResponderProtocol#touchStart
transitionClippingFrame(clippingFrame)

Defined in: container.js.
Parameters:
clippingFrame
trigger()

Triggers the gesture, notifying the view that the gesture has happened.

You should trigger a gesture where it would be natural to say it has "happened"; for instance, if a touch moves a couple of pixels, you probably wouldn't say a swipe has occurred—though you might say it has "begun." And you wouldn't necessarily wait until the touch has ended either. Once the touch has moved a certain amount, there has definitely been a swipe. By calling trigger() at this point, you will tell the view that it has occurred.

For SC.SwipeGesture, this allows a view to implement only swipe(), and then be automatically notified whenever any swipe has occurred.


Defined in: gesture.js.
trim(str)

Defined in: string.js.
Parameters:
str
See:
SC.String.trim
trimLeft(str)

Defined in: string.js.
Parameters:
str
See:
SC.String.trimLeft
trimRight(str)

Defined in: string.js.
Parameters:
str
See:
SC.String.trimRight
update(dataSource, jquery)

Defined in: label.js.
Parameters:
dataSource
jquery
updateSizeClassName(dataSource, jquery)

Determines the proper size for the dataSource, and then updates the DOM to include that size's class name.


Defined in: sizing.js.
Parameters:
dataSource
jquery
Documentation generated by JsDoc Toolkit 2.4.0 on Wed Apr 08 2015 10:02:21 GMT-0600 (CST)