# j-Emoji

> j-Emoji: Uso de emoji UTF; Historia personal con emoticones de uso frecuente.

Framework: jcomponent20
Product: jComponent 20 (jcomponent@20)
Language: es
Content-SHA256: 2df43c31b8654f53fc6dd4d857325afa9905ba83d3342839f0d4d007610bb7ca
Snapshot: c0700e321579725c5cf4f5ace1ad7d2866d1b4f93c24a63c0b41b6b7998e976c
Sources: components@910ed1a86f6e72b4f031d3ad0dc7844f9fc5cb8e
Review: not-recorded

- Usando emojis UTF
- Historia personal con emoticones de uso frecuente.
- Gran herramienta de búsqueda
- Tonos de piel cambiables.

__Configuración__:

- `categories {String}` cambia emoticones en categorías. Utilice Unicode sin caracteres especiales (predeterminado: `128342,128578,128161,127944,128008,128690,128172,127828,127937`)
- `height {Number}` establece la altura del componente (predeterminado: `295`)
- `history {Number}` límite histórico para emoticonos usados frecuentemente (predeterminado: `49`)
- `empty {String}` un mensaje cuando no se encuentran emoticonos (predeterminado: `No emoji match your search`)
- `emptyemoji {Number}` cambia el emoticón cuando no se encuentran emoticones. Utilice Unicode sin caracteres especiales (predeterminado: `128557`)
- Velocidad de desplazamiento `speed {Number}` en ms (predeterminado: `500`)
- Mensaje de pie de página `footer {String}` (predeterminado: `Choose skin tone`)
- `toneemoji {String}` Emoticono de tonos de piel. Utilice Unicode sin caracteres especiales (predeterminado: `9995`)
- `search {String}` un marcador de posición para el campo de búsqueda (predeterminado: `Search`)

__Es bueno saberlo__:

- Este componente implementa la función `FUNC.parseASCI(string)`. La función analizará cadenas y transformará texto como `:D` o `:joy:` en emoticones UTF.

```javascript
var message = 'This one was good. :joy: See you soon :P';
console.log(FUNC.parseASCI(message)); // This one was good. &#128514; See you soon &#128539;
```

## Uso

```javascript
var opt = {};

// opt.offsetX {Number}    : adds X offset (default: 0)
// opt.offsetY {Number}    : adds Y offset (default: 0)
// opt.align {String}      : align `left` (default), `center` or `right`
// opt.position {String}   : position `top` (default) or `bottom`

opt.element = YOUR_ELEMENT;
// or if you want to use a fixed position:
// opt.x {Number}          : `x` position
// opt.y {Number}          : `y` position

opt.callback = function(emoji) {
	console.log(emoji); // callback parameter has String.fromCodePoint() value
};

SETTER('emoji/show', opt);
```

Úselo con `<ui-component name="emoji">`. Cuando el componente aún no está cargado, jComponent lo descarga en el primer uso desde la dirección en `DEF.fallback` (el CDN Componentator de forma predeterminada). Autor: Denis Granec. Fuente: repositorio de componentes Componentator, licencia MIT.

```html example.html
<ui-component name="emoji"></ui-component>

<div class="container">
	<div class="row">
		<div class="col-xs-4 col-xs-offset-4" style="text-align:center">
			<a href="javascript:void(0)" style="color:black;font-size:30px"><i class="ti ti-smile"></i></a>
		</div>
	</div>
</div>

<script>
$(document).on('click', 'a', function() {
	var opt = {};
	opt.align = 'center';
	opt.position = 'top';
	opt.element = this;
	opt.callback = function(selected) {
		console.log(selected);
	};
	SETTER('emoji/show', opt);
	console.log(FUNC.parseASCII('This one was good. :joy: See you soon :P'));
});
</script>
```
