iron-validator-behavior.html

<!--
@license
Copyright (c) 2015 The Polymer Project Authors. All rights reserved.
This code may only be used under the BSD style license found at http://polymer.github.io/LICENSE.txt
The complete set of authors may be found at http://polymer.github.io/AUTHORS.txt
The complete set of contributors may be found at http://polymer.github.io/CONTRIBUTORS.txt
Code distributed by Google as part of the polymer project is also
subject to an additional IP rights grant found at http://polymer.github.io/PATENTS.txt
-->

<link rel="import" href="../polymer/polymer.html">
<link rel="import" href="../iron-meta/iron-meta.html">

<script>

    /**
     * Use `Polymer.IronValidatorBehavior` to implement a custom input/form validator. Element
     * instances implementing this behavior will be registered for use in elements that implement
     * `Polymer.IronValidatableBehavior`.
     *
     * @demo demo/index.html
     * @polymerBehavior
     */
    Polymer.IronValidatorBehavior = {

        properties: {

            /**
             * Namespace for this validator.
             */
            validatorType: {
                type: String,
                value: 'validator'
            },

            /**
             * Name for this validator, used by `Polymer.IronValidatableBehavior` to lookup this element.
             */
            validatorName: {
                type: String,
                value: function () {
                    return this.is;
                }
            },

            /**
             * Default error message for the validator implementing the IronValidatorBehavior
             */
            message: {
                type: String,
                value: ''
            },

            /**
             * Used to connect the custom validator instance to the desired validatable via the property `validatableId`.
             */
            'for': {
                type: String,
                value: ''
            }

        },

        ready: function () {
            var suffix = this.for ? ('--' + this.for) : '';
            new Polymer.IronMeta({type: this.validatorType, key: this.validatorName + suffix, value: this});
        },

        /**
         * Implement custom validation logic in this function.
         * @param {Object} values The value to validate. May be any type depending on the validation logic.
         * @param {HTMLElement} The element validation is being applied to. When a native validation API is present
         * (like for instance on the HTMLinputElement), native validation can be used inside the validate function of the validator.
         * @return {Boolean} true if `values` is valid.
         */
        validate: function (values, input) {
        }
    };

</script>