docs($filter): clarify what is a valid filter name

Also updates the CHANGELOG to add info about this breaking some
previous invalid uses of $filter

Closes #10054
Closes #10131
This commit is contained in:
Pawel Kozlowski
2014-11-19 19:35:57 +01:00
committed by Peter Bacon Darwin
parent 95e03bce7e
commit d3fb8dd776
2 changed files with 10 additions and 0 deletions

View File

@@ -91,6 +91,11 @@ The filter function should be a [pure function](http://en.wikipedia.org/wiki/Pur
means that it should be stateless and idempotent. Angular relies on these properties and executes
the filter only when the inputs to the function change.
<div class="alert alert-warning">
**Note:** filter names must be valid angular expression identifiers, such as `uppercase` or `orderBy`.
Names with special characters, such as hyphens and dots, are not allowed.
</div>
The following sample filter reverses a text string. In addition, it conditionally makes the
text upper-case.