Members
-
dispatcher :NexusHoratio.base.Dispatcher
-
Details
-
item :external:Element
-
Details
-
itemUid :string
-
Details
-
logger :NexusHoratio.base.Logger
-
Details
-
name :string
-
Details
Methods
-
defaultUid( element ) → {string}
-
Description
Return normalized text for an element.
Like
HTMLElement.innerText, but cleaner and mostly deduped.Parameters
Name Type Description elementexternal:Element Element to examine.
Returns
Details
-
next()
-
Description
Move to the next item in the collection.
Details
-
prev()
-
Description
Move to the previous item in the collection.
Details
-
first()
-
Description
Move to the first item in the collection.
Details
-
last()
-
Description
Move to last item in the collection.
Details
-
goto( item )
-
Description
Move to a specific item if possible.
Parameters
Name Type Description itemexternal:Element Item to go to.
Details
-
gotoUid( uid ) → {boolean}
-
Description
Move to a specific item if possible, by uid.
Parameters
Name Type Description uidstring The uid of a specific item.
Returns
Details
-
shine()
-
Description
Adds the registered CSS classes to the current element.
Details
-
dull()
-
Description
Removes the registered CSS classes from the current element.
Details
-
show()
-
Description
Bring current item into view.
Details
-
focus()
-
Description
Move browser focus to current item.
Fires
Details
-
<async> activate()
-
Description
Activate the scroller.
Fires
Details
-
deactivate()
-
Description
Deactivate the scroller (but do not destroy it).
Fires
Details
-
destroy()
-
Description
Mark instance as inactive and do any internal cleanup.
Details
Type Definitions
-
EventData
-
Description
Data sent along with events fired.
Different events will populate different properties.
Properties
Name Type Attributes Description scrollerNexusHoratio.nav.Scroller Instance firing the event.
itemexternal:Element <optional> Current item.
deltanumber <optional> Number of attempted steps that triggered an
out-of-rangeevent.Details
-
uidCallback( scroller, element ) → {string}
-
Description
Function that generates a, preferably, reproducible unique identifier for an Element.
The method
defaultUidexists to both provide an example and fallback implementation. However, it may not always be reproducible (consider items that consist of counts for reads and likes). It may also not be unique within a particular instance.It is a good practice to verify the stability and uniqueness of callbacks across page reloads. Built in logging will identify duplicates.
Parameters
Name Type Description scrollerNexusHoratio.nav.Scroller The calling
Scrollerinstance.elementexternal:Element Element to examine.
Returns
Details
-
ContainerItemsSelector
-
Description
Contains CSS selectors to first find a base element, then items that it contains.
Properties
Name Type Description containerstring CSS selector to find the container element.
itemsstring CSS selector to find the items inside the container.
Details
-
ElementFinder( element ) → {external:Element}
-
Description
Function that finds a DOM element based upon another one.
Useful for cases where CSS selectors are not sufficient.
Parameters
Name Type Description elementexternal:Element Starting point.
Returns
Details
-
What
-
Description
There are two ways to describe what elements go into a
Scroller:- An explicit container (via
base) element and selectors stemming from it. - An array of
ContainerItemsSelectors that can allow for multiple containers with items. This approach will also allow theScrollerto automatically wait for all container elements to exist during activation.
Properties
Name Type Description namestring Name for this
Scroller, used for logging.baseexternal:Element The container to use as a base for selecting elements.
selectorsArray.<string> Array of CSS selectors to find elements to collect, calling
base.querySelectorAll().containerItemsArray.<NexusHoratio.nav.Scroller~ContainerItemsSelector> Array of
ContainerItemsSelectors.Details
- An explicit container (via
-
How
-
Properties
Name Type Attributes Default Description uidCallbackNexusHoratio.nav.Scroller~uidCallback Callback to generate a uid.
maxUidLengthnumber <optional> 20 Max length for default uid text.
classesArray.<string> <optional> [] Array of CSS classes to add/remove from an element as it becomes current.
watchForClicksboolean <optional> true Whether the Scroller should watch for clicks and if one is inside an item, select it.
autoActivateboolean <optional> false Whether to call the activate method at the end of construction.
observeAttributesboolean <optional> false Whether the built in
MutationObservershould also observer node attributes (useful if the uid depends on attributes).snapToTopboolean <optional> false Whether items should snap to the top of the window when coming into view. should happen when
snapToTopis false.waitForItemTimeoutnumber <optional> 3000 Time to wait, in milliseconds, for existing item to reappear upon reactivation.
containerTimeoutnumber <optional> 0 Time to wait, in milliseconds, for a
ContainerItemsSelector.containerto show up. Some pages may not always provide all identified containers. The default of0disables timing out. NB: Any containers that timeout will not handle further activate() processing, such aswatchForClicks.Details
Events
-
activate
-
Description
This instance is being activated.
Details
-
activated
-
Description
This instance has been activated.
Details
-
change
-
Description
The value of item is changing.
Details
-
changed
-
Description
The value of item has changed.
Details
-
changed
-
Description
A clicked item is about to be processed.
Details
-
changed
-
Description
A clicked item has been processed.
Details
-
deactivate
-
Description
This instance is being deactivated.
Details
-
deactivated
-
Description
This instance has been deactivated.
Details
-
focus
-
Description
Focus is changing to a different item.
Details
-
focused
-
Description
Focus has changed to a different item.
Details
-
out-of-range
-
Description
Scrolling went past one end of the collection. This is NOT an error condition, but rather a design feature.
Details