Tablas

Las tablas de DeveloperHub constan de una fila de encabezado y filas de datos.

Para crear una tabla:

  • Escribe / en una línea nueva o haz clic en a la izquierda de cualquier línea.

  • Seleccione Tabla

Ejemplo de tabla

Parámetro

Tipo

Valor predeterminado

user_id

int

Generado automáticamente

user_name

string

John Doe

user_age

int

25

Opciones de tabla

Para ver las opciones de la tabla, haga clic con el botón derecho en una celda de la tabla. Podrá:

  • Insertar columna a la izquierda o Insertar columna a la derecha.

  • Insertar fila arriba o Insertar fila abajo.

  • Duplicar fila o Duplicar columna, lo que inserta una copia junto a la actual.

  • Combinar celdas o Dividir celda para separar de nuevo una celda combinada.

  • Establecer un Color para la celda desde las muestras, o Borrar color.

  • Alinear el contenido de la celda a la izquierda, al centro o a la derecha.

  • Activar o desactivar Alternar fila de encabezado.

  • Fijar fila de encabezado al desplazarse, para que el encabezado permanezca en su sitio mientras se lee una tabla larga. Seleccione Desfijar fila de encabezado para deshacerlo.

  • Hacer columna con búsqueda, en una celda de la fila de encabezado, para que los lectores puedan buscar en la tabla por esa columna. Seleccione Hacer columna sin búsqueda para deshacerlo.

  • Cambiar la tabla entre diseño automático y diseño fijo.

  • Eliminar fila o Eliminar columna.

Para eliminar una tabla completa, pase el cursor sobre ella y abra el menú del bloque desde el controlador de arrastre situado a su izquierda; luego elimine el bloque.

Fijar la fila de encabezado

Una tabla puede mantener su fila de encabezado a la vista mientras el resto se desplaza. Esto resulta especialmente útil en una tabla muy larga, como una referencia de parámetros o campos, donde un lector que ya ha avanzado por las filas hace tiempo que perdió de vista lo que significa cada columna.

Para fijarla, haga clic con el botón derecho en una celda y seleccione Fijar fila de encabezado al desplazarse.

Una tabla lo bastante corta para caber en pantalla no tiene nada que desplazar, por lo que al fijarla se ve exactamente igual.

Buscar en una columna

Los lectores pueden reducir una tabla larga a las filas que necesitan buscando en una columna. Para activarlo, haga clic con el botón derecho en una celda de la fila de encabezado y seleccione Hacer columna con búsqueda. Repita el proceso con cualquier otra columna en la que los lectores deban poder buscar.

En la página publicada, el encabezado de esa columna muestra un botón de búsqueda. Al escribir en él, solo se muestran las filas cuya celda en esa columna coincide. En el editor, el encabezado solo muestra un icono de búsqueda tenue para señalarlo.

Reordenar filas y columnas

Pase el cursor sobre la tabla para mostrar un pequeño controlador de agarre sobre cada columna y a la izquierda de cada fila. Sujete un controlador y arrástrelo para mover esa columna o fila a una nueva posición. Una línea guía muestra dónde se colocará mientras arrastra.

Cambiar el tamaño de las columnas

Para cambiar el tamaño de una columna, pase el cursor justo antes de donde termina la columna. Aparecerá un controlador vertical que será:

  • Gris: indica que no se ha especificado un ancho. La columna se ajusta automáticamente.

  • Rojo: indica que se ha especificado un ancho. La columna tiene un tamaño fijo.

Luego puede cambiar el tamaño de la columna arrastrando el controlador.

Para quitar el tamaño fijo, haga doble clic en el controlador.

Compruebe otras pantallas

Si establece un tamaño fijo para una columna, es mejor asegurarse de que funcione en otros tamaños de pantalla.

Si una tabla tiene una columna de tamaño fijo, al exportar la documentación no estará en formato markdown, ya que markdown no admite la notación de anchos de columna fijos.

Copiar y pegar

Para copiar una tabla completa, seleccione la tabla por completo. Para asegurarse de hacerlo bien, seleccione la línea situada encima y debajo de ella y luego copie. Después puede pegarla donde la necesite y eliminar las líneas adicionales.

Para copiar campos de una tabla a otra, seleccione los campos en la tabla de origen, copie y pegue en la tabla de destino. Asegúrese de que la tabla de destino tenga tamaño suficiente para pegar los campos de origen. También puede copiar desde fuentes externas y pegar en DeveloperHub.

blocks
  Última actualización