@lynx-json/jsua-lynx NPM

jsua-lynx (PRELIMINARY DOCUMENTATION)

Extensions to the jsua package for the Lynx JSON media type.

building.build accepts content and then:

parses content.blob as Lynx JSON and assigns it to the content.document property
passes the content object to building.documentViewBuilder

builders.nodeViewBuilder accepts result and then:

finds (see building.register) the builder that matches the most specific hint
passes the result object to the builder

building.register registers a view builder (for a Lynx JSON node) function that accepts the following params:

hint - the hint to build views for
builder - the builder function with signature f(node) -> view || Promise
condition - a function that accepts a Lynx node param and returns true if the builder will build a view for the node or false if the builder will not

building.registrations returns the registrations added via building.register

building.setNodeViewBuilder sets the default nodeViewBuilder, accepting a function with signature f(node) -> view || Promise

View Attributes

A view representing a Lynx JSON document may have the following attributes:

data-content-url - the document's URL
data-content-type - the document's content type (application/lynx+json)
data-lynx-realm - the document's realm URI
data-lynx-context - the document's context URI
data-lynx-focus - the document's focus name
data-transfer-started-at - the start date/time of the transfer that the view represents (see ECMASCript Date.prototype.valueOf()).

A view representing a node of a Lynx JSON document may have the following attributes:

data-lynx-visibility - the node's visibility
data-lynx-hints - the node's hints
data-lynx-name - the node's name
data-lynx-labeled-by - the node's labeledBy property value
data-lynx-scope - the node's scope (container nodes)
href - the node's href property value (link nodes)
type - the node's type property value (link nodes)
data-lynx-input - the node's input name for form data submission
data-lynx-submitter - the node's submitter property value (form and input nodes)
formaction - the node's action property value (submit nodes)
data-lynx-submit-method - the node's method property value (submit nodes)
data-lynx-submit-enctype - the node's enctype property value (submit nodes)
data-lynx-send - the node's send property value (submit nodes)
data-lynx-embedded-view - the view for the node's src or data property value (content nodes)
alt - the node's alt property value (content nodes)
title - the node's alt property value (image nodes)
data-lynx-height - the node's height property value (image nodes)
data-lynx-width - the node's width property value (image nodes)
data-lynx-container-input-add - the control used to add a new value to a container input node
data-lynx-container-input-value - the view for the value of an item in the container input node
data-lynx-container-input-remove - the control used to remove a value from a container input node
data-lynx-container-input-item - contains the data-lynx-container-input-value view and its associated data-lynx-container-input-remove control
data-lynx-validation-state - the current validation state of the view
data-lynx-visibility-conceal - the control used to toggle a view's data-lynx-visibility between revealed and concealed
data-lynx-options-name - the node's options property value (input nodes)
data-lynx-options-connected - the input view is connected to its source of options (input nodes)
data-lynx-options-role=options - the view is a source of options for an input view
data-lynx-option-selected - the current option selected state of the view
data-lynx-var-* - lynx data (unspecified) properties are added with this namespace

View Functions

A view representing a node of a Lynx JSON document may have the following methods/functions:

lynxGetVisibility - gets the visibility of a view
lynxSetVisibility - sets the visibility of a view
lynxGetValue - gets the value of a view (text, content, text input, content input, container input, option, and option value views)
lynxSetValue - sets the value of an input view
lynxHasValue - tests an input view's value and returns a Promise for a boolean
lynxClearValue - clears an input view's value
lynxAddValue - adds a value to a container input view
lynxRemoveValue - removes a value from a container input view
lynxValidateValue - if the view can be validated, performs the validation
lynxGetValidationState - if the view can be validated, gets the validation state of the view
lynxGetValidationConstraintSetObject - gets the normalized validation constraint set of a view
lynxGetConcealView - gets the view that represents the conceal action of a view
lynxSetConcealView - sets the view that represents the conceal action of a view
lynxGetRevealView - gets the view that represents the reveal action of a view
lynxSetRevealView - sets the view that represents the reveal action of a view
lynxConnectOptions - connects an input view that has options with its source of options (if found)
lynxDisconnectOptions - disconnects an input view from its source of options (if connected)
lynxGetInputView - gets the input view for an options view
lynxGetOptionsView - gets the options view for an input view
lynxSetEmbeddedView - sets both the view and the value (Blob) for a content view
lynxGetFocusableView - optional function to get the element from a view that is an appropriate focus target (i.e., an input control)

View Events

A view representing a node of a Lynx JSON document may emit the following events:

change - emitted when an input view's value changes
lynx-visibility-change - emitted when the view's data-lynx-visibility value changes
lynx-validation-state-change - emitted when the view's data-lynx-validation-state value changes. The event object will have a validation property whose value is an object (conforming to Lynx JSON's "Validation Constraint Set Object" interface) with the following additional properties:
- state - the overall validation state for the view after considering the state of all constraints
- priorState - the overall validation state for the view prior to the change
- constraints - an array of the validation constraints (conforming Lynx JSON's "Validation Constraint Object" interface) for the view also with their own state and priorState properties
- changes - an array of references to the validation constraints that have changed state
lynx-options-connected - emitted when a view that provides options to an input view is connected to the input view
lynx-options-disconnected - emitted when a view that provides options to an input view is disconnected from the input view
lynx-option-attached - emitted when an option view has been added to an options view
lynx-option-selected - emitted when a view that provides a value to an input view is selected
lynx-option-deselected - emitted when a view that provides a value to an input view is deselected
lynx-marker-here - emitted when a marker view determines the current view contains the content it marks
lynx-marker-there - emitted when a marker view determines the current view does not contain the content it marks