1.0.0 • Published 5 years ago

ms-commons-react v1.0.0

Weekly downloads
5
License
MIT
Repository
-
Last release
5 years ago

Prerequisitos

Se deben instalar las siguientes dependencias como prerrequisito:

ms-commons-react

Proyecto con los componentes básicos para el desarrollo de una aplicación con React para los proyectos web desarrollados por Modusoftware.

Guía

Instalación

npm install ms-commons-react --save

Componentes

<Modal />

import { Modal } from 'ms-commons-react';

Componente utilizado para mostrar modales, recibe las siguientes propiedades para personalizar la información y estilo:

PropiedadDescripciónTipo de DatoObligatoria
sizeDetermina el tamaño para el modalenum [sm, lg, xl]NO
centeredIndica si el modal se mostrará centrado en la páginabooleanNO
animationIndica si el modal se mostrará y ocultara con animaciónbooleanNO
jsowIndica si el modal se encuentra abiertobooleanSI
scrollableIndica si el modal tendrá scroll interno para visualizar el contenidobooleanNO
closeButtonIndica si el modal tendrá botón para cerrarlo en la parte superior derecha del modalbooleanNO
backdropIndica si el modal se podrá cerrar dando click por fuera del modalbooleanSI
keyboardIndica si el modal se podrá cerrar presionando la tecla ESCbooleanSI
onHideFunción que se ejecutará al momento de dar click en botón de cerrar modal ubicado en la parte superior derechafunctionNO
titleContenido que será mostrado en la cabecera del modalstringNO
bodyContenido que será mostrado en el cuerpo del modalHTML, string, array, functionSI
buttonsContenido que será mostrado en la parte inferior del modalarray of buttonSI

La propiedad buttons debe tener la siguiente estructura:

buttons: [
  {
    label: string - required,
    className: string - optional,
    onClick: function - required
  }
]

<ConfirmModal />

import { ConfirmModal } from 'ms-commons-react';

Componente utilizado para mostrar modales para confirmación de procesos, se utiliza el componente Modal para crear su visualización, recibe las siguientes propiedades para personalizar la información y estilo:

PropiedadDescripciónTipo de DatoObligatoria
animationIndica si el modal se mostrará y ocultara con animaciónbooleanNO
onCancelFunción que se ejecutará al momento de dar click en botón de cerrar modal ubicado en la parte superior derecha y en el botón de cancelación ubicado en la parte inferior del modalfunctionSI
onAcceptFunción que se ejecutará al momento de dar click en botón de aceptación ubicado en la parte inferior del modalfunctionSI
titleContenido que será mostrado en la cabecera del modalstringSI
bodyContenido que será mostrado en el cuerpo del modalHTML, string, array, functionSI
acceptButtonPropiedades para el botón de aceptaciónbuttonNO
cancelButtonPropiedades para el botón de cancelaciónbuttonNO

Las propiedades acceptButton y cancelButton deben tener la siguiente estructura:

buttons: [
  {
    label: string - optional,
    className: string - optional
  }
]

Se encuentrá disponible la función confirmModal para ejecutar el componente <ConfirmModal /> por medio de una función:

import { confirmModal } from 'ms-commons-react';
...
handleOpenModal = () => {
  confirmModal({
    onCancel: () => console.log("Cancel click"),
    onAccept: () => console.log("Accept click"),
    title: "Example",
    body: () => <p>Example body</p>,
    acceptButton: {
      label: 'Accept',
        className: 'btn btn-primary'
    }
  });
}
...

Internacionalización

import { i18n } from 'ms-commons-react';

var properties = {
  ...
};
i18n(properties);

Función encargada de configurar la internacionalización a partir de archivos ubicados en la carpeta public/locales/[ns]/translation.json en la raíz del proyecto:

my-app
└── public
   └── locales
       ├── en
       │   └── translation.json
       ├── es
       │   └── translation.json
       └── fr
           └── translation.json

La función recibe los propiedades de configuración las cuales pueden ser consultadas aquí

License

Create React App is open source software licensed as MIT.