aboutsummaryrefslogtreecommitdiffstats
path: root/docs/content/guide/dev_guide.templates.validators.creating_validators.ngdoc
diff options
context:
space:
mode:
Diffstat (limited to 'docs/content/guide/dev_guide.templates.validators.creating_validators.ngdoc')
-rw-r--r--docs/content/guide/dev_guide.templates.validators.creating_validators.ngdoc18
1 files changed, 0 insertions, 18 deletions
diff --git a/docs/content/guide/dev_guide.templates.validators.creating_validators.ngdoc b/docs/content/guide/dev_guide.templates.validators.creating_validators.ngdoc
index 661ce744..835b0b51 100644
--- a/docs/content/guide/dev_guide.templates.validators.creating_validators.ngdoc
+++ b/docs/content/guide/dev_guide.templates.validators.creating_validators.ngdoc
@@ -4,17 +4,13 @@
@description
-
-
To create a custom validator, you simply add your validator code as a method onto the
`angular.validator` object and provide input(s) for the validator function. Each input provided is
treated as an argument to the validator function. Any additional inputs should be separated by
commas.
-
The following bit of pseudo-code shows how to set up a custom validator:
-
<pre>
angular.validator('your_validator', function(input [,additional params]) {
[your validation code];
@@ -26,22 +22,17 @@ angular.validator('your_validator', function(input [,additional params]) {
}
</pre>
-
Note that this validator returns "true" when the user's input is incorrect, as in "Yes, it's true,
there was a problem with that input". If you prefer to provide more information when a validator
detects a problem with input, you can specify an error message in the validator that angular will
display when the user hovers over the input widget.
-
To specify an error message, replace "`return true;`" with an error string, for example:
-
return "Must be a value between 1 and 5!";
-
Following is a sample UPS Tracking Number validator:
-
<doc:example>
<doc:source>
<script>
@@ -60,7 +51,6 @@ expect(element('input[name=trackNo]').attr('class')).
not().toMatch(/ng-validation-error/);
});
-
it('should not validate in correct UPS tracking number', function() {
input('trackNo').enter('foo');
expect(element('input[name=trackNo]').attr('class')).
@@ -69,32 +59,24 @@ expect(element('input[name=trackNo]').attr('class')).
</doc:scenario>
</doc:example>
-
In this sample validator, we specify a regular expression against which to test the user's input.
Note that when the user's input matches `regexp`, the function returns "false" (""); otherwise it
returns the specified error message ("true").
-
Note: you can also access the current angular scope and DOM element objects in your validator
functions as follows:
-
* `this` === The current angular scope.
* `this.$element` === The DOM element that contains the binding. This allows the filter to
manipulate the DOM in addition to transforming the input.
-
-
## Related Topics
-
* {@link dev_guide.templates Angular Templates}
* {@link dev_guide.templates.filters Angular Filters}
* {@link dev_guide.templates.formatters Angular Formatters}
-
## Related API
-
* {@link api/angular.validator API Validator Reference}