@ivanvanderbyl/ember-material-components-form v0.77.1-alpha.2

@ivanvanderbyl/ember-material-components-form

ember-cli addon that is a polyfill for <form> elements

Installation

ember install @ivanvanderbyl/ember-material-components-form

Components

This package contains the following top-level components.

• mdc-form

mdc-form

Description

A component version of the HTML <form> element. The {{mdc-form}} component allows its parent to react to changes to the form, such as disabling the submit button when an input is invalid.

The {{mdc-form}} element will gather all child input elements and listen to changes in its validity state. When the validity state of an input changes, the {{mdc-form}} component will call the invalid action. The invalid action can then mutate a variable that enables/disables the submit button. The {{mdc-form}} does not automatically enable/disable the submit button, if present, because the parent may have other criteria outside of the {{mdc-form}} knowledge that determines if the submit button should be enabled/disabled.

Usage

{{#mdc-form submit=(action "submit")
            validity=(action (mut valid))}}
  {{!-- add input components here --}}

  {{#mdc-button type="submit"}}Submit{{/mdc-button}}
{{/mdc-form}}

Attributes

• submit - The action f() called when a button with type=submit is clicked and all inputs are valid.
• validity - The action f(state) when the form's validity changes.

Form Validity

The {{mdc-form}} element will yield the form's state ({isValid, isInvalid}). The yielded values can then be used to modify elements inside the form. For example, it can be use to enable/disable a button.

{{#mdc-form submit=(action "submit")
            validity=(action (mut valid)) as |form|}}
  {{!-- add input components here --}}

  {{#mdc-button type="submit" disabled=form.isInvalid}}Submit{{/mdc-button}}
{{/mdc-form}}