![Oracle Drags Its Feet in the JavaScript Trademark Dispute](https://cdn.sanity.io/images/cgdhsj6q/production/919c3b22c24f93884c548d60cbb338e819ff2435-1024x1024.webp?w=400&fit=max&auto=format)
Security News
Oracle Drags Its Feet in the JavaScript Trademark Dispute
Oracle seeks to dismiss fraud claims in the JavaScript trademark dispute, delaying the case and avoiding questions about its right to the name.
aurelia-binding-functions
Advanced tools
An Aurelia plugin that makes it possible create BindingFunctions.
An Aurelia plugin that allows you to create bi-directional BindingFunctions in a similar way to ValueConverters or BindingBehaviors.
jspm
with following commandjspm install npm:aurelia-binding-functions
configure
function in the main.js
file of your src
folder export function configure(aurelia) {
aurelia.use
.standardConfiguration()
.developmentLogging();
+ aurelia.use.plugin('aurelia-binding-functions');
aurelia.start().then(a => a.setRoot());
}
aurelia-binding-functions
should be visible automatically.You may create a BindingFunction the same way as you would BindingBehaviors or ValueConverters.
The simplest implementation for a one-way binding might look as follows:
// async-binding-function.ts //
export class AsyncBindingFunction implements BindingFunction {
connect(callScope: CallScope, binding: Binding, scope: Scope) {
// get the value of the first argument passed to our CallScope,
// e.g. the property from async(property)
const promise = callScope.args[0].evaluate(scope, binding.lookupFunctions, true) as Promise<any> & {promiseResult:any}
// make sure the binding is updated
// once the property "promiseResult" changes on the "promise"
binding.observeProperty(promise, 'promiseResult')
// set the "promiseResult" property once the Promise resolves
if (promise.promiseResult === undefined && typeof promise.then === 'function') {
promise.then(value => {
promise.promiseResult = value
})
}
}
evaluate(callScope: CallScope, scope: Scope, lookupFunctions, mustEvaluate: boolean) {
const promise = callScope.args[0].evaluate(scope, lookupFunctions, true) as Promise<any> & {promiseResult:any}
// return the value of "promiseResult" property
// or undefined if the value of the argument is not set
return promise ? promise.promiseResult : undefined
}
}
Now the BindingFunction can be used inside bindings prefixed by @
, i.e. @async()
:
<require from="./async-binding-function"></require>
<h2>${ @async(somePromise) }</h2>
A BindingFunction can implement the following methods:
export interface BindingFunction {
/**
* invoked by Aurelia to either:
* - retrieve the current value of the binding
* - trigger a call (e.g. by click.delegate)
*/
evaluate(bindingFunctionScope: BindingFunctionScope, scope: Scope, lookupFunctions, mustEvaluate: boolean): any
/**
* invoked if the binding is used as a source of values
* (as opposed to being used to trigger changes, like in click.delegate)
* this is invoked by Aurelia after bind() and every time the binding is recomputed
*/
connect?(bindingFunctionScope: BindingFunctionScope, binding: Binding, scope: Scope): void
/**
* when the binding is two-way, invoked every time new values are fed into the binding by Aurelia
*/
assign?(bindingFunctionScope: BindingFunctionScope, scope: Scope, value: any, lookupFunctions: any): void
/**
* invoked when the binding is bound
*/
bind?(bindingFunctionScope: BindingFunctionScope, binding: Binding, scope: Scope, lookupFunctions: any): void
/**
* invoked when the binding is unbound
*/
unbind?(bindingFunctionScope: BindingFunctionScope, binding: Binding, scope: Scope): void
}
For a one-time binding you only need to implement the evaluate()
method.
A one-way binding will require you to also implement connect()
, while a two-way binding requires you to also implement assign()
.
If you want to create lower-level, global, arbitraitly named Expressions, you may also use ScopeFunctions:
import {ParserImplementation} from 'aurelia-binding';
export function configure(aurelia) {
let parser = aurelia.container.get(ParserImplementation);
parser.registerScopeFunction('@custom', CustomExpression);
}
Where CustomExpression
is a class that implements Expression
.
For references see ast.js.
This library isn't used by Aurelia. It is an optional plugin.
This library can be used in the browser as well as on the server.
To build the code, follow these steps.
npm install
npm install -g gulp
gulp build
You will find the compiled code in the dist
folder, available in three module formats: AMD, CommonJS and ES6.
See gulpfile.js
for other tasks related to generating the docs and linting.
To run the unit tests, first ensure that you have followed the steps above in order to install all dependencies and successfully build the library. Once you have done that, proceed with these additional steps:
npm install -g karma-cli
npm install -g jspm
jspm install
karma start
FAQs
An Aurelia plugin that makes it possible create BindingFunctions.
The npm package aurelia-binding-functions receives a total of 2 weekly downloads. As such, aurelia-binding-functions popularity was classified as not popular.
We found that aurelia-binding-functions demonstrated a not healthy version release cadence and project activity because the last version was released a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Oracle seeks to dismiss fraud claims in the JavaScript trademark dispute, delaying the case and avoiding questions about its right to the name.
Security News
The Linux Foundation is warning open source developers that compliance with global sanctions is mandatory, highlighting legal risks and restrictions on contributions.
Security News
Maven Central now validates Sigstore signatures, making it easier for developers to verify the provenance of Java packages.