U Man Genius docs

Ninext documentation

HTML helping functions

Jacques TUR

Acess Ninox functions directly from HTML/JavaScript

callNinoxFunction

The callNinoxFunction function allows you to call a Ninox script from JavaScript code. This integration provides great flexibility for interacting with Ninox, particularly for:

• Sending the value of an input field,

• Executing actions during events such as onclick, onfocus, onblur, ontimer, etc.

⁠

Format and Parameters

callNinoxFunction(functionName, htmlElement, ...args)

functionName : Name of the Ninox function to call.

htmlElement :

Can be the ID of the HTML element (e.g. "myId"),

or the element itself (e.g. this or document.queryById("myId")).

...args : Additional parameters to pass to the Ninox function.

Return value : The function returns the value returned by the called Ninox function.

⁠

Description and Functionality

The main idea is to execute Ninox scripts within the context of an HTML page. Here’s how it works:

Defining the Ninox Function In your Ninox formula, define a function (e.g., myOnblur) that will handle the parameters passed from JavaScript. This function remains isolated from the rest of the script and executes within the context of the current record (equivalent to this in Ninox).

Creating the HTML Interface Embed an HTML component (e.g., an input field) within the formula. In the event attribute (such as onblur), use callNinoxFunction to call the corresponding Ninox function, passing the necessary parameters.

Triggering the Event When the HTML element loses focus, callNinoxFunction calls the specified Ninox function (myOnblur in this example), isolates it, and executes it with the given context and parameters (e.g., the input field’s value).

This mechanism simulates the behavior of a native trigger while allowing one or more custom parameters to be passed to the Ninox function execution.

⁠

Example

1. Defining the Ninox Function

In your Ninox formula, add the following function:

function myOnblur(inputValue : text) do

alert(---

Input of record { this.Id } is { inputValue }

---)

end;

This function displays an alert showing the current record’s ID and the passed value.

2. Integrating the HTML Input Field

Next, insert the following HTML code to display an input field and define the onblur event:

function myOnblur(inputValue : text) do

alert(---

Input of record { this.Id } is { inputValue }

---)

end;

html(---

<input

class="nx-input nx-input--editing"

style="width: 100%; height: 100%;"

onblur="ninext.callNinoxFunction('myOnblur', this, this.value )"

---)

How It Works:

When a user leaves the input field (onblur event),

The function ninext.callNinoxFunction is called with the following parameters:

'myOnblur' : the name of the Ninox function to execute,

this : the HTML element itself,

this.value : the current value of the input field.

This ensures that the Ninox script myOnblur runs in the context of the current record, as if it were triggered natively by Ninox, while also receiving the input field’s value as a parameter.

⁠

Key Points

Contextualization: The Ninox function executes with this representing the current record, ensuring consistency in the execution context.

Flexibility: You can add as many parameters as needed using ...args, allowing the Ninox function’s behavior to be adapted to your application’s specific needs.

Multiple Uses: This mechanism is particularly useful for integrating complex interactions between the HTML/JavaScript user interface and the business logic defined in Ninox.

Want to print your doc?
This is not the way.

Try clicking the ⋯ next to your doc name or using a keyboard shortcut (

CtrlP

) instead.