Skip to main content

Helpers

Playground

Contabilidad
Tipos KPI
Subir Documentos
14 botones
<%= table_chip array_chip(token).compact  %>

Lista de parámetros

ParámetroTipoDetalle
group_chipBoleanIndica si los chips se deben agrupar o no
amount_chipNumberCantidad máxima de chips que se mostraran

Table Chip

Las tablas pueden llevar un chip de forma unitaria dentro de sus celdas, pero también existen casos estresados donde podemos ver hasta 14 chips en una celda, para estos casos puntuales, se utiliza lo siguiente:

alt-text

Cuando los chips son muchos, las celdas tienden a crecer innecesariamente, deformando los campos. Para evitar esto, se deben mostrar hasta 3 resultados y un link too que indique el número restante. Al pincharlo, aparecerá un popover que mostrará el detalle del total de los chips, agrupandolo de manera ordenada.

alt-text

Para esto, se utiliza un helper, el cual abrira un Popover con el detalle de los chips.

alt-text
Por ningún motivo puede ocurrir que los chips se apilen de manera que rompan la vista

Columna de Acciones (Table_Actions)

Una tabla puede llevar distintas acciones, esás acciones se muestran como btn-icons. Para ello se ha definido una regla de tres para el uso del helper:

  • Si hay 2 se muestran los 2
  • Si hay 3 se muestran los 3
  • Si hay 4 se muestran solo 2 y el resto dentro del icono del dropdown convirtiéndose en texto
alt-text

Cuando hay más de tres acciones aparece el kebab Vertical (More_Vert) En la libería de material. En estos casos se prorizaran acciones primarias, las acciones secundarias como editar y eliminar quedarán siempre dentro de un dropdown.

alt-text

Cuando hay tres o menos acciones, estas serán siempre visibles en la tabla, incluyendo las acciones secundarias de editar y eliminar.

alt-text

Se pueden dar casos en la tabla donde exista una acción única, esta dependera del contexto de cada tabla, pero es posile que esta acción sea destructiva como en el caso de eliminar documentos. En estos casos se mostrará el btn-icon destructive.

alt-text

El select list del dropdown se abre solo en los casos donde exista el botón kebab englobando más de 3 acciones.

alt-text

Ejemplo de uso en contexto:

alt-text

La acción “Eliminar” siempre debe ir al final de la lista y en color rojo. El token para esto es el watermelon 500

alt-textSe debe utilizar btn-icons con la clase Ghost
alt-textNo utilizar como filled ni outline

Acciones universales

Las acciones universales son aquellas de uso frecuente en tablas en Buk. Se pueden utilizar para distintos contextos según el caso de uso, si queremos añadir mas de una acción el orden siempre debe ser: Primaria, Primaria & Destructiva, Secundaria, Secundaria & Destructiva.

IconoNombre de acciónNombre de iconoCaso de usoTipo de acción
deleteEliminardeleteSe utiliza para eliminar elementos por lo gereal permanentementeSecundria & destructiva
editEditareditSe utiliza para hacer cambios en elementos que ya existenPrimaria
manage_searchVer más / Detallemanage_searchSe utiliza para mostrar información adicional en un recurso como popover o sidebarPrimaria
visibility visibility_off Mostrar /Ocultarvisibility / visibility_offSe utiliza para mostrar u ocultar informaciónPrimaria
sendEnviarsendSe utiliza en acciones que requieren enviar documentos, emails, mensajes, notificacionesPrimaria
notificationsNotificarnotificationsSe utiliza para avisar a otra persona sobre un proceso, por lo general gatilla correoPrimaria
previewPrevisualizarpreviewSe utiliza para previsulizar la creacion de un elemento que verán otros usuariosPrimaria
todayCalendariotodaySirve para identificar fechas y plazos (días, semanas, meses y años)Secundaria
saveGuardarsaveSe utiliza en acciones que requieren guardar elementos o cambiosSecundaria
file_downloadDescargarfile_downloadSe utiliza para descargar imágenes, documentos u otros elementosPrimaria
blockDesactivarblockEsta acción desactiva un proceso o elemento que esta activo en la plataformaSecundaria & Desctructiva
replyResponderreplySe utiliza para responder contenidos como formularios o encuestasPrimaria
check_circle unpublished Publicar / Despublicarcheck_circle / unpublishedSe utiliza para hacer público u ocultar un elementoPrimaria
content_copyCopiarcontent_copySe utiliza para replicar elementos o procesosSecundaria
restore_pageRestaurarrestore_pageSe utiliza para restaurar un elemento que fue eliminadoPrimaria
check close Aprobar / Rechazarcheck / closeSe utiliza para aprobar o rechazar un elementoPrimaria / Primaria & Destructiva
lock_openDesbloquear / Abrirlock_openSe utiliza para desbloquear / abrir un elemento específicoPrimaria
lockBloquear / CerrarlockSe utiliza para bloquear / cerrar un elemento en específicoPrimaria & Destructiva
shareCompartirshareSe utiliza para compartir contenidos a otros usuarios dentro de la plataformaSecundaria

Writing para las acciones

Para crear una acción nueva debemos tener en cuenta que el nombre no debe superar las dos palabras. Debemos ser lo más específicos posibles en lo que respecta a indicar qué hace esa acción.

Ejemplos:

"Crear documento de firma" reemplazarlo por "Crear documento". "Ver más detalles" reemplazarlo por "Detalles".


message

Hola 👋

Evalúa tu experiencia utilizando nuestro Design System

Déjanos un comentario