ent-validator-builder v1.1.0

Validator Builder

Componente responsável pela configuração do FormValidator. Este componente é organizado através de duas Classes ValidatorBuilder e Validation.

Forma de Utilização

    Y.use('ent-portlet', 'ent-validator-builder', 'lib/custom-form-validator', function (Y) {
        const _portlet = new Y.Portlet('.search-benefits-portlet')
        
        const _config = new Y.ValidatorBuilder(_portlet.getFieldId(_query.form.id))
            .append(new Y.Validation(_query.fields.email.name).required().email().maxLength(75))
            .append(new Y.Validation(_query.fields.password.name).required().minLength(6).maxLength(18))
            .append(new Y.Validation(_query.fields.captcha.field.name).required().maxLength(4))
            .build()
    
        const validator = new Y.FormValidator(_config)
        
        validator.validate()
        if(validator.hasErrors()) {
            ...
        }
    })

Métodos: ValidatorBuilder

append(validation)

Incrementa a configuração das validações com base em uma instancia de Validation.

Exemplo:

    const _config = new Y.ValidatorBuilder(_query.form.id)
        .append(new Y.Validation(_query.fields.email.name).required().email().maxLength(75))
        .append(new Y.Validation(_query.fields.password.name).required().maxLength(75))
        .append(new Y.Validation(_query.fields.captcha.field.name).required().maxLength(4))
        .build()

    const validator = new Y.FormValidator(_config)

build()

Retorna a configuração da validação.

concat(rules, validation)

Adiciona a uma configuração de validação já pronta validações baseadas em uma instância de Validation.

Métodos: Validation

Método construtor

Pode receber como parâmetro o name do campo a ser validado.

Exemplo:

    new Y.Validation(_query.fields.email.name).required().email().maxLength(75)

required(boolean)

Determina se um campo é obrigatório.

Exemplo:

    const validation = new Y.Validation(_query.fields.email.name).required()

equalTo(fieldNameOrValue)

Determina se um campo contem o mesmo valor que o especificado.

Exemplo:

    new Y.ValidatorBuilder(_query.form.id)
    .append(new Y.Validation(_query.fields.password.name).required().maxLength(75))
    .append(new Y.Validation(_query.fields.confirmPassword.name).required().maxLength(75).equalTo(_query.fields.password.id))

max(value)

Determina um valor máximo para um campo numérico.

Exemplo:

    new Y.Validation(_query.fields.age.name).required().max(18)

min(value)

Determina um valor mínimo para um campo numérico.

Exemplo:

    new Y.Validation(_query.fields.age.name).required().min(18)

range(min, max)

Determina um intervalo de valores para um campo numéroco.

Exemplo:

    new Y.Validation(_query.fields.age.name).required().range(18, 60)

maxLength(value)

Determina uma quantidade máxima de caracteres para um determinado campo.

Exemplo:

    new Y.Validation(_query.fields.password.name).maxLength(75)

minLength(value)

Determina uma quantidade mínima de caracteres para um determinado campo.

Exemplo:

    new Y.Validation(_query.fields.password.name).minLength(6)

rangeLength(min, max)

Determina um intervalo de caracteres para um determinado campo.

Exemplo:

    new Y.Validation(_query.fields.password.name).rangeLength(6, 18)

number(boolean)

Determina se um vampo é numérico.

Exemplo:

    new Y.Validation(_query.fields.age.name).required().range(18, 60).number()

email(boolean)

Determina se um campo é do tipo email.

Exemplo:

    new Y.Validation(_query.fields.email.name).required().maxLength(75).email()

url(boolean)

Determina se um campo é do tipo url.

Exemplo:

    new Y.Validation(_query.fields.url.name).required().url()

acceptFiles(values)

Determina um array de arquivos permitidos para um campo do tipo upload.

Exemplo:

    new Y.Validation(_query.fields.image.name).required().acceptFiles(['jpg', 'gif', 'png'])

custom(validatorName, value)

Adiciona um validador customizado.

Exemplo:

    new Y.Validation(_query.fields.datePicker.name).required().custom('datepicker', true)
    new Y.Validation(_query.fields.birthDate.name).required().custom('birthDate')

from(fieldNames)

Adiciona as mesmas regras de validação a campos distintos.

Exemplo:

    new Y.Validation().required().maxLength(75).from([_query.fields.name.name, _query.fields.lastName.name, _query.fields.address.name])

build()

Constroi o objeto de configuração com base nas validalões adicionadas.