On This Page
REST API

Global

Type Definitions

callback(erropt, nullable, dataopt, nullable) > {void}
Microform uses the error-first callback pattern, as commonly used in Node.js.
If an error occurs, it is returned by the first 
err
 argument of the callback. If no error occurs, 
err
 has a null value and any return data is provided in the second argument.
Parameters
Name
Type
Attributes
Description
err
MicroformError. See Class: MicroformError.
<optional> <nullable>
An Object detailing occurred errors, otherwise null.
data
*
<optional> <nullable>
In success scenarios, this is whatever data has been returned by the asynchronous function call, if any.
Returns
Type: void
Example
The following example shows how to make use of this style of error handling in your code:
foo(function (err, data) {
    // check for and handle any errors
    if (err) throw err;

    // otherwise use the data returned
    console.log(data);
});
StylingOptions
Styling options are supplied as an object that resembles CSS but is limited to a subset of CSS properties that relate only to the text within the iframe.
Supported CSS selectors:
  • input
  • ::placeholder
  • :hover
  • :focus
  • :disabled
  • valid
  • invalid
Supported CSS properties:
  • color
  • cursor
  • font
  • font-family
  • font-kerning
  • font-size
  • font-size-adjust
  • font-stretch
  • font-style
  • font-variant
  • font-variant-alternates
  • font-variant-caps
  • font-variant-east-asian
  • font-variant-ligatures
  • font-variant-numeric
  • font-weight
  • line-height
  • opacity
  • text-shadow
  • text-rendering
  • transition
  • -moz-osx-font-smoothing
  • -moz-tap-highlight-color
  • -moz-transition
  • -o-transition
  • -webkit-font-smoothing
  • -webkit-tap-highlight-color
  • -webkit-transition
Any unsupported properties will not be applied and raise a 
console.warn()
.
Properties
Name
Type
Attributes
Description
input
object
<optional>
Main styling applied to the input field.
::placeholder
object
<optional>
Styles for the ::placeholder pseudo-element within the main input field. This also adds vendor prefixes for supported browsers.
:hover
object
<optional>
Styles to apply when the input field is hovered over.
:focus
object
<optional>
Styles to apply when the input field has focus.
:disabled
object
<optional>
Styles applied when the input field has been disabled.
valid
object
<optional>
Styles applied when Microform detects that the input card number is valid. Relies on card detection being enabled.
invalid
object
<optional>
Styles applied when Microform detects that the input card number is invalid. Relies on card detection being enabled.
Example
const styles = {
  'input': {
    'color': '#464646',
    'font-size': '16px',
    'font-family': 'monospace'
  },
  ':hover': {
    'font-style': 'italic'
  },
  'invalid': {
    'color': 'red'
  }
};