https://github.com/basklein/angular-full-width-to-half-width
Full-width to half-width character filter for AngularJS
https://github.com/basklein/angular-full-width-to-half-width
Last synced: 3 months ago
JSON representation
Full-width to half-width character filter for AngularJS
- Host: GitHub
- URL: https://github.com/basklein/angular-full-width-to-half-width
- Owner: basklein
- License: mit
- Created: 2020-05-28T14:30:18.000Z (almost 5 years ago)
- Default Branch: master
- Last Pushed: 2022-12-07T19:10:41.000Z (over 2 years ago)
- Last Synced: 2024-04-25T04:44:33.419Z (about 1 year ago)
- Language: JavaScript
- Size: 264 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
[](https://badge.fury.io/js/angular-full-width-to-half-width)
[](https://github.com/basklein/angular-full-width-to-half-width/issues)
[](https://github.com/basklein/angular-full-width-to-half-width/blob/master/LICENSE)
# angular-full-width-to-half-width
Full-width to half-width character service and filters for AngularJS
## Description
This is a service for AngularJS that converts full-width Unicode characters to their half-width counterparts. This service can be used as is, or through the filter `fullWidthToHalfWidth`.
At the moment the service only converts the characters in the Unicode range 0xFF00 - 0xFF5E. I am planning on adding the ability to convert the rest of the characters in the U+FF00 - U+FFEF block, but this will take time.
## Usage
1. Install via [npm](https://www.npmjs.com/) or downloaded files:
1. via npm: `npm install --save angular-full-width-to-half-width`
2. via [downloaded files](https://github.com/basklein/angular-full-width-to-half-width/master)
2. Add `angular-full-width-to-half-width` to your application's module dependencies.
3. Include dependencies and angular-full-width-to-half-width in your HTML.
- When using npm
```html
```
- When using downloaded files
```html
```
4. Use the angular filter `fullWidthToHalfWidth`, or use the angular service `fullWidthToHalfWidthService`.
## Documentation
### Services
#### convertToHalfWidthService
##### convertToHalfWidth
Converts the full-width characters in a string to half-width counterparts.
* `@param {string} value` The string containing characters to convert to half-width.
* `@return {string}` A string containing half-width characters converted from the original value.
### Filters
##### fullWidthToHalfWidth
Converts the full-width characters in a string to half-width counterparts.
* `@param {string} input` The string containing characters to convert to half-width.
* `@return {string}` A string containing half-width characters converted from the original value.
## Example
HTML
```html
{{"ｈえｌｌｏ ｗｏｒｌｄ！" | fullWidthToHalfWidth }} : ｈえｌｌｏ ｗｏｒｌｄ！
{{"Whａt， is this？" | fullWidthToHalfWidth}} : Whａt， is this？
```
Result:
```html
hえllo world! : ｈえｌｌｏ ｗｏｒｌｄ！
What, is this? : Whａt， is this？
```
Javascript:
```javascript
angular.module('app', ['angular-full-width-to-half-width']);
angular.module('app')
.controller('appController', function ($scope, $filter) {
$scope.javascriptTest = $filter('fullWidthToHalfWidth')("Hello world!");
$scope.javascriptExample = $filter('fullWidthToHalfWidth')("ｈえｌｌｏ ｗｏｒｌｄ！");
});
```
Result:
```html
Hello world! : $scope.javascriptTest Hello world!
hえllo world! : $scope.javascriptString ｈえｌｌｏ ｗｏｒｌｄ！
```
# LICENSE
MIT