-
Notifications
You must be signed in to change notification settings - Fork 0
Util
Aquí hay algunas funciones que pueden ser útiles en muchos aspectos.
Important
Importa jtEssentials directamente en tu proyecto.
Para los ejemplos usaremos la importación directa jtEssentials
import jtEssentials from '@javiert.dev/essentials';Esta función permite aplicar una máscara a un texto, es decir, ordene el texto con una estructura específica. Por ejemplo, si deseas que un texto tenga un formato específico, como un número de teléfono o una fecha, un correo electrónico, etc.
Máscaras:
ALetra0NúmeroXCarácter secreto*Cualquier caracter
| Parámetro | Tipo | Requerido | Valor por defecto | Descripción |
|---|---|---|---|---|
| text | String |
Obligatorio | Texto que deseas aplicar la máscara | |
| mask | String |
Obligatorio | Máscara que deseas aplicar al texto | |
| invert | Boolean |
Opcional | false |
Si es true, invierte el orden de aplicación de la máscara |
jtEssentials.util.mask(text: string, mask: string, invert: boolean = false): {public: string, private: string}jtEssentials.util.mask('56912345678', '+00 0 0000 0000');
// {public: '+56 9 1234 5678', private: '+56 9 1234 5678'}
jtEssentials.util.mask('AFY12345678', 'AAA-0000XXXX');
// {public: 'AFY-1234****', private: 'AFY-12345678'}
jtEssentials.util.mask('123456789', '(000) 000-0000');
// {public: '(123) 456-7890', private: '(123) 456-7890'}
jtEssentials.util.mask('code:123', 'AAAA*000');
// {public: 'code:123', private: 'code:123'}
// Invertir la máscara es útil cuando se requiere el formateado de derecha a izquierda.
jtEssentials.util.mask('12345678', '0.000.000.000', true);
// {public: '12.345.678', private: '12.345.678'}Esta función permite convertir un texto a un blob, es decir, a un objeto binario que puede ser utilizado para almacenar datos en formato binario. Por ejemplo, si deseas almacenar una imagen o un archivo de audio, puedes utilizar esta función para convertir el texto a un blob.
| Parámetro | Tipo | Requerido | Valor por defecto | Descripción |
|---|---|---|---|---|
| content | String |
Obligatorio | Texto que deseas convertir a un blob | |
| mime | String |
Opcional | text/plain |
Tipo de contenido que deseas aplicar al blob. Puedes usar los siguientes tipos: text/plain, image/png, image/jpeg, application/pdf, etc. |
jtEssentials.util.blob(content: string, mime: string = 'text/plain'): stringlet result = jtEssentials.util.blob('Hola mundo');
console.log(result);
//Resultado: "blob:https://localhost/708a5714-4c07-485b-8330-9dbfc661d6a8"let result = jtEssentials.util.blob(
'...', // Contenido de la imagen
'image/png',
);
console.log(result);
//Resultado: "blob:https://localhost/d89d5d7c-a3a6-4f0e-aaa9-d70af74d256c"Esta función permite gatillar una descarga de una URL.
Tip
Puedes combinar esta función con la función blob para descargar el blob generado.
| Parámetro | Tipo | Requerido | Valor por defecto | Descripción |
|---|---|---|---|---|
| filename | String |
Obligatorio | Nombre del archivo que deseas descargar | |
| url | String |
Obligatorio | URL que deseas descargar |
jtEssentials.util.download(filename: string, url: string): voidjtEssentials.util.download('ejemplo.txt', 'https://example.com/ejemplo.txt');
jtEssentials.util.download('ejemplo.png', 'https://example.com/ejemplo.png');
jtEssentials.util.download('ejemplo.pdf', 'https://example.com/ejemplo.pdf');
jtEssentials.util.download('ejemplo.docx', 'https://example.com/ejemplo.docx');
jtEssentials.util.download('holaMundo.txt', jtEssentials.util.blob('Hola mundo'));
jtEssentials.util.download('ejemplo.png', jtEssentials.util.blob('...', 'image/png'));Esta función permite detectar si el dispositivo es móvil o no.
No requiere parámetros.
jtEssentials.util.isMobile(): booleanlet result = jtEssentials.util.isMobile();
console.log(result);
//Resultado: true | falseEsta función permite obtener el idioma configurado en el HTML <html lang="{value}">.
No requiere parámetros.
jtEssentials.util.lang.get(): string | nulllet result = jtEssentials.util.lang.get();
console.log(result);
//Resultado: "es-ES" | "en-US" | nullEsta función permite establecer el idioma en el HTML <html lang="{value}">.
| Parámetro | Tipo | Requerido | Valor por defecto | Descripción |
|---|---|---|---|---|
| lang | String |
Obligatorio | Idioma que deseas establecer |
jtEssentials.util.lang.set(lang: string): voidjtEssentials.util.lang.set('es-ES');Esta función permite obtener el idioma configurado en el navegador.
No requiere parámetros.
jtEssentials.util.lang.browser(): stringlet result = jtEssentials.util.lang.browser();
console.log(result);
//Resultado: "es-ES" | "en-US" | etc.Esta función permite obtener el tema configurado en el HTML <html theme="{value}">.
No requiere parámetros.
jtEssentials.util.theme.get(): string | nulllet result = jtEssentials.util.theme.get();
console.log(result);
//Resultado: "light" | "dark" | nullEsta función permite establecer el tema en el HTML <html theme="{value}">.
| Parámetro | Tipo | Requerido | Valor por defecto | Descripción |
|---|---|---|---|---|
| theme | String |
Obligatorio | Tema que deseas establecer |
jtEssentials.util.theme.set(theme: string): voidjtEssentials.util.theme.set('dark');Esta función permite obtener el tema configurado en el navegador.
No requiere parámetros.
jtEssentials.util.theme.browser(): 'dark' | 'light'let result = jtEssentials.util.theme.browser();
console.log(result);
//Resultado: "dark" | "light"