fx-control is no concrete control displayed in the browser but
instead wraps such a control and binds it to a data node in the model with the help of a ref attribute.
| Name | Description | Default |
|---|---|---|
| as | ’text’ or ’node’. When using ’node’ a whole dom tree can be passed to a widget | text |
| context | XPath reference pointing to parent context | incopeContext |
| credentials | sets credentials policy - one of ‘omit’, ‘same-origin’ or ‘include’ | same-origin |
| create | if present on control or anchestor will create non-existing attribute nodes in the data | - |
| debounce | optional numeric value in milliseconds to delay input events | - |
| initial | XPath binding expression referring to data that get passed to Fore control as default instance. Only effective when url is specified. | - |
| label | optional label | - |
| listen-on | a CSS selector to attach the update event listener to | element with ‘widget’ class |
| ref | XPath reference pointing to the bound node | - |
| shadow | marker attribute to attach Fore control to shadowDOM instead of lightDOM | - |
| update-event | optional event name when to trigger updating of bound node. | blur |
| ’enter’ can be used to catch enter key | ||
| url | URL pointing to HTML page containing fx-fore element that gets imported as widget | - |
| value-prop | optional property name used to set the value of the widget (default:‘value’) | value |
A widget is an element contained within a <fx-control> and must be marked
with a class="widget".
Some attributes might occur on a widget to further control its behavior.
| Name | Description |
|---|---|
| selection | applies to <select> elements. If selection="open" is given an additional empty <option> will be added to allow the empty value. |
| Name | Description |
|---|---|
| init | dispatched once when a control is initialized. Can be used for customization of wrapped widgets. |
| value-changed | dispatched during refresh after the value of the control has changed |
| optional | dispatched during refresh when node has become optional |
| required | dispatched during refresh when node has become required |
| readonly | dispatched during refresh when node has become readonly |
| readwrite | dispatched during refresh when node has become readwrite |
| valid | dispatched during refresh when node has become valid |
| invalid | dispatched during refresh when node has become invalid |
| relevant | dispatched during refresh when node has become relevant |
| nonrelevant | dispatched during refresh when node has become non-relevant |
With the ´as´ attribute the referenced node will be directly passed to the widget. This can be useful with control that manipulate nodes like e.g. text editors.
Sometimes values can and should be empty initially. With selection="open" on
the select element it will create such en empty option.
By setting a url attribute you can use another ForeBody as the widget of given control. The url is resolved
and will fetch the first fx-fore element it finds within that page and embeds it as widget of the control. You can pass in an fx-instance
for the loaded widget with initial and get the return value with the return action.