Helpers
Playground
- Ruby
- Html
<%= table_chip array_chip(token).compact %>
<td width="12%">
<div class="chip badge badge-info mb-2" data-toggle="tooltip" data-title="Lectura" style="" data-original-title="" title="">
Contabilidad
</div>
<div class="chip badge badge-info mb-2" data-toggle="tooltip" data-title="Lectura" style="" data-original-title="" title="">
Empleados
</div>
<div class="chip badge badge-warning mb-2" data-toggle="tooltip" data-title="Lectura y Modificación" style="" data-original-title="" title="">
Asistencia
</div>
<a data-toggle="popover" data-html="true" data-placement="right" data-content=
"<p class="mb-1"> Lectura </p>
<div class="chip badge badge-info mb-2"
Contabilidad
</div>
<div class="chip badge badge-info mb-2">
Empleados
</div>
<div class="chip badge badge-info mb-2">
Subir Documentos
</div>
<div class="chip badge badge-info ">
Usuarios y perfiles
</div>
<p class="mb-1 mt-2"> Lectura y Modificación </p> <div class="chip badge badge-warning mb-2">Asistencia</div>
<div class="chip badge badge-warning mb-2">
Items
</div>
<div class="chip badge badge-warning mb-2">
Vacaciones
</div>
" title="Detalle" href="javascript:void(0)" aria-expanded="false">4 Más...
</a>
</td>
Lista de parámetros
Parámetro | Tipo | Detalle |
group_chip | Bolean | Indica si los chips se deben agrupar o no |
amount_chip | Number | Cantidad 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:
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.
Para esto, se utiliza un helper, el cual abrira un Popover con el detalle de los chips.
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
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.
Cuando hay tres o menos acciones, estas serán siempre visibles en la tabla, incluyendo las acciones secundarias de editar y eliminar.
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.
Dropdown
El select list del dropdown se abre solo en los casos donde exista el botón kebab englobando más de 3 acciones.
Ejemplo de uso en contexto:
La acción “Eliminar” siempre debe ir al final de la lista y en color rojo. El token para esto es el watermelon 500
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.
Acciones universales
Icono | Nombre de acción | Nombre de icono | Caso de uso | Tipo de acción |
---|---|---|---|---|
Eliminar | delete | Se utiliza para eliminar elementos por lo gereal permanentemente | Secundria & destructiva | |
Editar | edit | Se utiliza para hacer cambios en elementos que ya existen | Primaria | |
Ver más / Detalle | manage_search | Se utiliza para mostrar información adicional en un recurso como popover o sidebar | Primaria | |
Mostrar /Ocultar | visibility / visibility_off | Se utiliza para mostrar u ocultar información | Primaria | |
Enviar | send | Se utiliza en acciones que requieren enviar documentos, emails, mensajes, notificaciones | Primaria | |
Notificar | notifications | Se utiliza para avisar a otra persona sobre un proceso, por lo general gatilla correo | Primaria | |
Previsualizar | preview | Se utiliza para previsulizar la creacion de un elemento que verán otros usuarios | Primaria | |
Calendario | today | Sirve para identificar fechas y plazos (días, semanas, meses y años) | Secundaria | |
Guardar | save | Se utiliza en acciones que requieren guardar elementos o cambios | Secundaria | |
Descargar | file_download | Se utiliza para descargar imágenes, documentos u otros elementos | Primaria | |
Desactivar | block | Esta acción desactiva un proceso o elemento que esta activo en la plataforma | Secundaria & Desctructiva | |
Responder | reply | Se utiliza para responder contenidos como formularios o encuestas | Primaria | |
Publicar / Despublicar | check_circle / unpublished | Se utiliza para hacer público u ocultar un elemento | Primaria | |
Copiar | content_copy | Se utiliza para replicar elementos o procesos | Secundaria | |
Restaurar | restore_page | Se utiliza para restaurar un elemento que fue eliminado | Primaria | |
Aprobar / Rechazar | check / close | Se utiliza para aprobar o rechazar un elemento | Primaria / Primaria & Destructiva | |
Desbloquear / Abrir | lock_open | Se utiliza para desbloquear / abrir un elemento específico | Primaria | |
Bloquear / Cerrar | lock | Se utiliza para bloquear / cerrar un elemento en específico | Primaria & Destructiva | |
Compartir | share | Se utiliza para compartir contenidos a otros usuarios dentro de la plataforma | Secundaria |
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".