applyBackground() function

Applies a particular background with a particular delay to an element depending on validity.

Syntax

applyBackground()
applyBackground(stateValues)
applyBackground(effectID, stateValues)
applyBackground(htmlElement, effectID, stateValues)
applyBackground(effectID, htmlElement, stateValues)
applyBackground(effectID, stateValues, htmlElement)
applyBackground(htmlElement, stateValues, effectID)
applyBackground(stateValues, htmlElement, effectID)
applyBackground(stateValues, effectID, htmlElement)

Parameters

htmlElement ^optional
An object that implements the HTMLElement interface.
Default: undefined.
effectID ^optional
A string identifier of the effect.
Default: A unique string value for each function call.
stateValues ^optional
An object that specifies values for validity states. The available properties are:
- true ^optional
  An object with properties for the validity state equal to true. The available properties are:
  - delay ^optional
    A number in milliseconds for the effect to be deferred for this validity state.
    Default: 0.
  - value ^optional
    The value of the background CSS property to be applied for this validity state.
    Default: string 'honeydew'.
- false ^optional
  An object with properties for the validity state equal to false. The available properties are:
  - delay ^optional
    A number in milliseconds for the effect to be deferred for this validity state.
    Default: 0.
  - value ^optional
    The value of the background CSS property to be applied for this validity state.
    Default: string 'lavenderblush'.

Return value

An Array with two functions:

A function for cancellation the effect if it is deffered.
A function for setting the effect.

Both functions accept the following arguments:

validationResult
A ValidationResult object.

Exceptions

See exceptions of the function returned by the createApplyEffect() function.

Description

This function was created with using createApplyEffect().

See the description of applyEffect(), cancelEffect(), setEffect() on the createApplyEffect() function page.

Implementation: apply-background.js.