Download the PHP package webmodules/sightglass without Composer
On this page you can find all versions of the php package webmodules/sightglass. It is possible to download/install these versions without Composer. Possible dependencies are resolved automatically.
Download webmodules/sightglass
More information about webmodules/sightglass
Files in webmodules/sightglass
Informations about the package sightglass
sightglass
Observable keypath engine. Facilitaties building your own composable keypaths by way of defining adapters. This module was originally extracted from the Rivets.js data binding + templating library.
Installation
Install with npm, component(1) or bower (recommended).
API
sightglass.adapters
Before being able to observe an object with sightglass, you need to define at least one adapter to compose your keypaths with. Adapters are just objects that respond to observe
, unobserve
and get
. Keys on the sightglass.adapters
object are the separators you will use when composing your keypaths.
sightglass.root
Sightglass also needs to know about a default root adapter. This is only required for keypaths that aren't prepended with an adapter key. For example, if your default root adapter is set to .
, then the keypath hello:world
will get parsed as .hello:world
.
sightglass(obj, keypath, callback, [options])
Observes the full keypath on the provided object. The callback is called whenever the end value of the keypath changes (this could happen from any intermediary objects in the keypath changing, in addition to the property at the end of the keypath changing).
You can optionally pass in a fourth argument to extend the default options. Adapters defined here will only be available locally to the observer. All globally defined adapters will also be available to the observer, unless overridden by using an existing separator key.
Returns an Observer
instance that you can hold on to for later (see Observer API below).
Observer API
observer.value()
Reads the current end value of the observed keypath. Returns undefined
if the full keypath is unreachable.
observer.setValue()
Sets the value on the tail property of the observed object (the last segment in the keypath). Calling setValue
when the full keypath is unreachable is a no-op.
observer.update()
Recomputes the entire keypath, attaching observers for every key or correcting old observers on objects in the keypath that have since changed.
If your adapter's subscribe
function is implemented properly, this function will get called automatically when any intermediary key in the keypath changes, so you shouldn't need to call this function. However, if your keypath makes use of an adapter that does not subscribe for changes, then you will need to call this function manually after making changes to that segment in your keypath.
observer.unobserve()
Unobserves the entire keypath.
Contributing
Bug Reporting
- Ensure the bug can be reproduced on the latest master.
- Open an issue on GitHub and include an isolated JSFiddle demonstration of the bug. The more information you provide, the easier it will be to validate and fix.
Pull Requests
- Fork the repository and create a topic branch.
- Be sure to associate commits to their corresponding issue using
[#1]
or[Closes #1]
if the commit resolves the issue. - Push to your fork and submit a pull-request with an explanation and reference to the original issue (if there is one).