[ Index ]

PHP Cross Reference of WordPress

title

Body

[close]

/wp-includes/js/dist/ -> keyboard-shortcuts.js (summary)

External dependencies

File Size: 791 lines (23 kb)
Included or required:0 times
Referenced: 0 times
Includes or requires: 0 files

Defines 24 functions

  reducer()
  registerShortcut()
  unregisterShortcut()
  arrayOf()
  isObjectLike()
  createCache()
  isShallowEqual()
  rememo()
  getRootCache()
  getWeakMapCache()
  clear()
  callSelector()
  getKeyCombinationRepresentation()
  getShortcutKeyCombination()
  getShortcutRepresentation()
  getShortcutDescription()
  getShortcutAliases()
  useShortcutEventMatch()
  isMatch()
  useShortcut()
  _callback()
  _extends()
  ShortcutProvider()
  onKeyDown()

Functions
Functions that are not part of a class:

reducer()   X-Ref
Reducer returning the registered shortcuts

param: {Object} state  Current state.
param: {Object} action Dispatched action.
return: {Object} Updated state.

registerShortcut(_ref)   X-Ref
Returns an action object used to register a new keyboard shortcut.

param: {WPShortcutConfig} config Shortcut config.
return: {Object} action.

unregisterShortcut(name)   X-Ref
Returns an action object used to unregister a keyboard shortcut.

param: {string} name Shortcut name.
return: {Object} action.

arrayOf( value )   X-Ref
Returns the first argument as the sole entry in an array.

param: {*} value Value to return.
return: {Array} Value returned as entry in array.

isObjectLike( value )   X-Ref
Returns true if the value passed is object-like, or false otherwise. A value
is object-like if it can support property assignment, e.g. object or array.

param: {*} value Value to test.
return: {boolean} Whether value is object-like.

createCache()   X-Ref
Creates and returns a new cache object.

return: {Object} Cache object.

isShallowEqual( a, b, fromIndex )   X-Ref
Returns true if entries within the two arrays are strictly equal by
reference from a starting index.

param: {Array}  a         First array.
param: {Array}  b         Second array.
param: {number} fromIndex Index from which to start comparison.
return: {boolean} Whether arrays are shallowly equal.

rememo(selector, getDependants )   X-Ref
Returns a memoized selector function. The getDependants function argument is
called before the memoized selector and is expected to return an immutable
reference or array of references on which the selector depends for computing
its own return value. The memoize cache is preserved only as long as those
dependant references remain the same. If getDependants returns a different
reference(s), the cache is cleared and the selector value regenerated.

param: {Function} selector      Selector function.
param: {Function} getDependants Dependant getter returning an immutable
return: {Function} Memoized selector.

getRootCache()   X-Ref
Returns the root cache. If WeakMap is supported, this is assigned to the
root WeakMap cache set, otherwise it is a shared instance of the default
cache object.

return: {(WeakMap|Object)} Root cache object.

getWeakMapCache( dependants )   X-Ref
Returns the cache for a given dependants array. When possible, a WeakMap
will be used to create a unique cache for each set of dependants. This
is feasible due to the nature of WeakMap in allowing garbage collection
to occur on entries where the key object is no longer referenced. Since
WeakMap requires the key to be an object, this is only possible when the
dependant is object-like. The root cache is created as a hierarchy where
each top-level key is the first entry in a dependants set, the value a
WeakMap where each key is the next dependant, and so on. This continues
so long as the dependants are object-like. If no dependants are object-
like, then the cache is shared across all invocations.

param: {Array} dependants Selector dependants.
return: {Object} Cache object.

clear()   X-Ref
Resets root memoization cache.


callSelector( )   X-Ref
The augmented selector call, considering first whether dependants have
changed before passing it to underlying memoize function.

param: {Object} source    Source object for derivation.
param: {...*}   extraArgs Additional arguments to pass to selector.
return: {*} Selector result.

getKeyCombinationRepresentation(shortcut, representation)   X-Ref
Returns a string representing the key combination.

param: {?WPShortcutKeyCombination} shortcut       Key combination.
param: {keyof FORMATTING_METHODS}  representation Type of representation
return: {string?} Shortcut representation.

getShortcutKeyCombination(state, name)   X-Ref
Returns the main key combination for a given shortcut name.

param: {Object} state Global state.
param: {string} name  Shortcut name.
return: {WPShortcutKeyCombination?} Key combination.

getShortcutRepresentation(state, name)   X-Ref
Returns a string representing the main key combination for a given shortcut name.

param: {Object}                   state          Global state.
param: {string}                   name           Shortcut name.
param: {keyof FORMATTING_METHODS} representation Type of representation
return: {string?} Shortcut representation.

getShortcutDescription(state, name)   X-Ref
Returns the shortcut description given its name.

param: {Object} state Global state.
param: {string} name  Shortcut name.
return: {string?} Shortcut description.

getShortcutAliases(state, name)   X-Ref
Returns the aliases for a given shortcut name.

param: {Object} state Global state.
param: {string} name  Shortcut name.
return: {WPShortcutKeyCombination[]} Key combinations.

useShortcutEventMatch()   X-Ref
Returns a function to check if a keyboard event matches a shortcut name.

return: {Function} A function to to check if a keyboard event matches a

isMatch(name, event)   X-Ref
A function to check if a keyboard event matches a predefined shortcut
combination.

param: {string}        name  Shortcut name.
param: {KeyboardEvent} event Event to check.
return: {boolean} True if the event matches any shortcuts, false if not.

useShortcut(name, callback)   X-Ref
Attach a keyboard shortcut handler.

param: {string}   name               Shortcut name.
param: {Function} callback           Shortcut callback.
param: {Object}   options            Shortcut options.
param: {boolean}  options.isDisabled Whether to disable to shortut.

_callback(event)   X-Ref
No description

_extends()   X-Ref
No description

ShortcutProvider(props)   X-Ref
Handles callbacks added to context by `useShortcut`.

param: {Object} props Props to pass to `div`.
return: {import('@wordpress/element').WPElement} Component.

onKeyDown(event)   X-Ref
No description



Generated: Thu Dec 12 01:00:03 2024 Cross-referenced by PHPXref 0.7.1