Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/gustavohenke/brazilfields
Conjunto de utilidades Angular.js para documentos brasileiros.
https://github.com/gustavohenke/brazilfields
Last synced: 9 days ago
JSON representation
Conjunto de utilidades Angular.js para documentos brasileiros.
- Host: GitHub
- URL: https://github.com/gustavohenke/brazilfields
- Owner: gustavohenke
- License: mit
- Created: 2014-06-10T13:56:07.000Z (over 10 years ago)
- Default Branch: master
- Last Pushed: 2017-01-17T19:46:26.000Z (almost 8 years ago)
- Last Synced: 2024-05-01T23:58:43.546Z (8 months ago)
- Language: JavaScript
- Homepage:
- Size: 47.9 KB
- Stars: 1
- Watchers: 2
- Forks: 1
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# BrazilFields [](https://travis-ci.org/gustavohenke/BrazilFields)
Conjunto de utilidades Angular.js para documentos brasileiros.
## Instalação
* __Via Git:__
```shell
git clone [email protected]:gustavohenke/BrazilFields.git
```
* __Via Bower:__
```shell
bower install brazilfields --save
```
* __Via NPM:__
```shell
npm install brazilfields --save
```
* __Via download:__
Download: [https://github.com/gustavohenke/BrazilFields/archive/master.zip](https://github.com/gustavohenke/BrazilFields/archive/master.zip).
Depois, basta incluir o script `dist/brazilfields.js` em sua página.
## Utilização
Primeiramente, injete o módulo `brazilfields` no seu app Angular:
```javascript
var app = angular.module( "app", [ "brazilfields" ] );
```
### Validações
É possível realizar validações de CPFs, CNPJs e estados brasileiros usando o service `brValidate`:
```javascript
app.controller( "MeuController", [ "$scope", "brValidate", function( $scope, brValidate ) {
brValidate.cpf( "20620614803" );
// => true
brValidate.cpf( "206.206.148-03" );
// => true, pontuações . e - são permitidas
brValidate.cpf( " 206206.148-03 " );
// => true, esquecer-se da pontuação padrão ou espaços ao redor são permitidos
brValidate.cpf( "206.206.148-13" );
// => false, dígito verificador inválido!
// -----
brValidate.cnpj( "06439677000107" );
// => true
brValidate.cnpj( "06.439.677/0001-07" );
// => true, pontuações ., / e - são permitidas
brValidate.cnpj( " 06.4396770001-07 " );
// => true, esquecer-se da pontuação padrão ou espaços ao redor são permitidos
brValidate.cnpj( "06.439.677/0001-08" );
// => false, dígito verificador inválido!
// -----
brValidate.state( "RS" ); // => true
brValidate.state( "sp" ); // => true, case insensitive
brValidate.state( "XX" ); // => false, estado não existe
brValidate.state( "Sao Paulo" ); // => true, busca por nome do estado sem considerar acentuação
brValidate.state( "Foobar" ); // => false, estado inexistente
}]);
```
### Diretivas
#### br-cpf
Valida um campo de CPF com `ng-model` e define a chave de validação `cpf` quando o mesmo estiver inválido.
Exemplo:
```html
Digite um CPF válido!
```
#### br-cnpj
Valida um campo de CNPJ com `ng-model` e define a chave de validação `cnpj` quando o mesmo estiver inválido.
Exemplo:
```html
Digite um CNPJ válido!
```
## Licença
MIT © Gustavo Henke