npm package: @mcsoft/selector-imagen
Description: Componente de React que permite seleccionar una imagen del disco duro y cortarla para después guardarla.
Author: Jaime Brambila
Latest version: 1.0.0

# Selector de Imagen
Componente de React que permite seleccionar una imagen del disco duro y cortarla para después guardarla.

[![Software Type](https://img.shields.io/badge/McSoft-React%20Library-blue)](#)
[![Language](https://img.shields.io/badge/Language-Spanish-yellow)](#)
[![Software License](https://img.shields.io/badge/License-MIT-brightgreen.svg)](LICENSE)
[![Version](https://img.shields.io/npm/v/@mcsoft/selector-imagen.svg)](https://www.npmjs.com/package/@mcsoft/selector-imagen)
[![Downloads](https://img.shields.io/npm/dt/@mcsoft/selector-imagen.svg)](https://www.npmjs.com/package/@mcsoft/selector-imagen)

## Instalación

```bash
npm install --save @mcsoft/selector-imagen
```

## Uso

```jsx
import McSelectorImagen from '@mcsoft/selector-imagen';

class Ejemplo extends Component {
  render () {
    return (
	  <McSelectorImagen
	  	eventoObtenerArchivoImagen={(archivoObjeto) => eventoObtenerArchivoImagen(archivoObjeto)}
	  />
    )
  }

  eventoObtenerArchivoImagen(archivoObjeto) {
	console.log('Archivo seleccionado: ', archivoObjeto);
  }

}
```

## Props (Obligatorios)
| Propiedad                  | Tipo     | Descripción                                              |
|----------------------------|----------|----------------------------------------------------------|
| eventoObtenerArchivoImagen | Function | Evento que se ejecuta cuando el archivo es seleccionado.<br> **eventoObtenerArchivoImagen(archivoObjeto: *objeto*)** <br><br> - **archivoObjeto**: ***objeto*** Objeto con la información del archivo seleccionado. <br> - **archivoObjeto.base64**: ***string*** Archivo de imagen en formato base64. <br> - **archivoObjeto.dataUrl**: ***string*** Archivo de imagen en formato DataURL. <br> - **archivoObjeto.extension**: ***string*** Extensión del archivo. <br> - **archivoObjeto.nombre**: ***string*** Nombre del archivo. <br> - **archivoObjeto.tamano**: ***number*** Tamaño del archivo en bytes. <br> - **archivoObjeto.tipo**: ***string*** Tipo de archivo (MIME TYPE). |

## Props (Opcionales)
| Propiedad                 | Tipo   | Predeterminado           | Descripción                                                                                             |
|---------------------------|--------|--------------------------|---------------------------------------------------------------------------------------------------------|
| iconoImagenNoSeleccionada | string | 'far fa-image'           | Icono (*FontAwesome*) que se mostrará en la vista previa mientras no se haya seleccionado una imagen.   |
| relacionAspecto           | number | 1/1                      | Relación de aspecto que tendra la sección del selector para recortar la imagen.                         |
| texto                     | object |                          | Objeto con los textos personalizados del componente.                                                    |
| texto.seleccionaUnaImagen | string | 'Selecciona una imagen.' | Mensaje que se mostrará en la vista previa mientras no se haya seleccionado una imagen.                 |
| urlImagenVistaPrevia      | string |                          | URL de la imagen que se mostrará como vista previa. Utilizado para mostrar la vista previa de una imagen que actualmente ya ha existe (Por ejemplo: Una foto de perfil). |