Giter Club home page Giter Club logo

knockout-validation's Introduction

knockout-validation NPM version Build Status Dependency Status Coverage percentage

Knockout validation and error handling module.

Usage

npm install --save knockout-validation

In your JavaScript code

As AMD

require(['knockout', 'knockout-validation'], function (ko, koValidation) {
  var ob = ko.observable().extend({
    validate: [
      // a list of validators
      koValidation.string(),
    ]
  });

  ob('foo'); // this will success
  ob(123); // this will fail
});

As CMD

var ko = require('knockout');
var koValidation = require('knockout-validation');

var ob = ko.observable().extend({
  validate: [
    // a list of validators
    koValidation.string(),
  ]
});

ob('foo'); // this will success
ob(123); // this will fail

API

koValidation.string()

Create a string validator verifies if the observable has a string value.

koValidation.string.size(length)

Create a string validator with limited length.

koValidation.string.xss()

Create a string validator with XSS (cross site scripting) check.

koValidation.number()

Create a number validator verifies if the observable has a number value.

koValidation.number.size(integerLength, decimalLength)

Create a number validator with limited integer part length and decimal part length.

koValidation.number.range(min, max)

Create a number validator with a range.

koValidation.enum(values, nullable)

Create an enum validator validates if the observable has a value in the given value set.

koValidation.array()

Create an array validator validates if the observable has an array value.

koValidation.array.size(min, max)

Create an array validator with size validation.

koValidation.array.item(validators)

Create an array validator with validators for every item.

  • validators, array of validators, every validator should be passed by every item.

koValidation.array.items(validators, additionalValidators)

Create an array validator with validators which should be all passed one by one by every item.

  • validators, array of validators array, every validators array should be passed by item with same index.
  • additionalValidators, boolean or array of validators. true means allow additional items for which there're no validation; false means no additional items are allowed; array of validators means every additional items should pass all these validators.

koValidation.array.unique()

Create an array validator with no duplicate item validation.

koValidation.required(allowSpace)

Create a validator verifies if the observable has a value. If allowSpace is false, space only strings are treated as invalid.

koValidation.passive()

Create a validator which sets observable's errors passively.

PassiveValidator.prototype.setError(message, value)

Set passive error to the observable. Error will be cleared when value changes.

  • message, the passive error message
  • value, associated value, if the observable is set to any other value, the error will be cleared

koValidation.custom(isValid, message, blockInput)

Create a validator using customized validation method.

  • isValid, the validation method in form of function (value) { return true; }
  • message, the error message for validation failure
  • blockInput, a boolean decides whether invalid value will be blocked. If it's true, setting the observable with an invalid value will turn into a noop. Otherwise, the observable will be updated with the message added to the its errors property

koValidation.run(value, validators)

Validate a value against an array of validators manually. Returns the error message of the first failed validator

Validator.prototype.set(options)

For each validator, you can call its set method to config the following options

  • blockInput, whether or not the invalid values are blocked from setting to the observable
  • message, the error message on validation failure

Validator.prototype.validate(value)

Validate a given value directly. Returns the error message if failed, otherwise returns undefined.

knockout-validation's People

Contributors

a7medkamel avatar ljqx avatar lyweiwei avatar microsoft-github-policy-service[bot] avatar msftgits avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

knockout-validation's Issues

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    ๐Ÿ–– Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. ๐Ÿ“Š๐Ÿ“ˆ๐ŸŽ‰

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google โค๏ธ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.