ORIENT/modules/system/assets/ui/docs/input.trigger.md

Input Trigger API

The API allows to change elements' visibility or status (enabled/disabled) basing on other elements' statuses. Example: enable a button if any checkbox inside another element is checked.

Supported data attributes:

• data-trigger-action, values: show, hide, enable, disable, empty
• data-trigger: a CSS selector for elements that trigger the action (checkboxes)
• data-trigger-condition, values:
  • checked: determines the condition the elements specified in the data-trigger should satisfy in order the condition to be considered as "true".
  • value[somevalue]: determines if the value of data-trigger equals the specified value (somevalue) the condition is considered "true".
• data-trigger-closest-parent: optional, specifies a CSS selector for a closest common parent for the source and destination input elements.

Example code:

<input type="button" class="btn disabled"
    data-trigger-action="enable"
    data-trigger="#cblist input[type=checkbox]"
    data-trigger-condition="checked" ... >

Supported events:

• oc.triggerOn.update - triggers the update. Trigger this event on the element the plugin is bound to to force it to check the condition and update itself. This is useful when the page content is updated with AJAX.

JavaScript API:

$('#mybutton').triggerOn({
    triggerCondition: 'checked',
    trigger: '#cblist input[type=checkbox]',
    triggerAction: 'enable' 
})

Example

<input type="checkbox" id="triggerChk1" />
<button class="btn disabled"
    data-trigger-action="enable"
    data-trigger="#triggerChk1"
    data-trigger-condition="checked">
    Check the checkbox
</button>

<input type="text" id="triggerTxt1" value="" placeholder="Enter 'foo' or 'bar' here" />
<button class="btn disabled"
    data-trigger-action="enable"
    data-trigger="#triggerTxt1"
    data-trigger-condition="value[foo][bar]">
    Passphrase valid!
</button>