Esta página describe Calíope 1.5, la versión que estamos construyendo ahora mismo. La 1.4 está terminada y en revisión de App Store, y la tienda sirve hoy la 1.3 en el Mac y la 1.2 en iPad. El changelog dice en qué versión llegó cada función.

Añade un botón «Abrir en Calíope» a cada tema. Sólo funciona con la app instalada.

Gestos

Gestos táctiles en iPad

Los gestos que Calíope declara en iPad, dónde actúa cada uno, y los que otras apps tienen y aquí no.

Calíope para iPad declara pocos gestos, y los declara en sitios concretos. Ésta es la lista entera; al final está lo que no hay, que ahorra buscarlo.

Moverse por el espacio de trabajo
- Deslizar desde el borde izquierdo — muestra la barra lateral Herramientas, que es el lanzador. No es el árbol de esquema: ése vive dentro del Editor SQL y tiene su propio botón.
- Tocar una pestaña — la activa. Tocar la × — la cierra.

Editor SQL
- Mantener pulsada una palabra — abre el menú con Ir a la definición y Renombrar símbolo. El renombrado alcanza todo el script, no sólo la palabra que tocaste.
- La selección de texto —doble toque, triple toque, las asas de arrastre— es la de iPadOS; Calíope no la toca.

Gestor de conexiones
- Tocar dos veces un perfil — lo selecciona y conecta de una vez.
- Deslizar un perfil de izquierda a derecha — revela Mover a grupo.
- Deslizar un perfil de derecha a izquierda — revela Eliminar. No borra al soltar: revela el botón, y al pulsarlo Calíope pregunta antes, nombrando la conexión.
- Deslizar un grupo de derecha a izquierda, dentro de la hoja Gestionar grupos — revela Eliminar, con su propia pregunta: borrar un grupo se lleva las conexiones que tiene dentro.

Estos tres son todos los deslizamientos con acciones que hay en Calíope, y sólo existen en iPad.

Pellizcar con dos dedos, y qué mueve cada uno
- Sobre el texto del Editor SQL — el cuerpo de la fuente del editor, de 10 a 26 puntos. Se guarda: la próxima vez el editor abre donde lo dejaste.
- Sobre la cuadrícula de resultados — el cuerpo de la letra de las celdas, de 11 a 26 puntos. Es otra preferencia: mover una no mueve la otra.
- Sobre la imagen de una celda, en el editor avanzado — acerca y aleja la imagen, del 100 % al 800 %. El doble toque alterna entre ajustada y el 200 %, anclado donde tocaste.
- Sobre el lienzo del Diagrama ER o del árbol de Visual EXPLAIN — la escala del lienzo; tiene su propio tema, aquí abajo.

Los tres primeros tienen además botones en su barra, con el número al lado, así que el pellizco es un atajo y no la única forma.

Lo que tiene su propio tema
- Filas y celdas de resultados → Gestos en filas y celdas de resultados.
- Diagrama ER y Visual EXPLAIN → Pan y zoom en Diagrama ER y Visual EXPLAIN.
- Separadores entre paneles → Redimensionar paneles del workspace.

Lo que en Calíope no hay

Las pestañas no tienen menú contextual: no se duplican, ni se fijan, ni se cierran las demás desde ahí. No se desliza sobre una fila de resultados para editarla o borrarla —ese menú se abre manteniéndola pulsada—, ni se ordena la cuadrícula de resultados tocando su encabezado —el orden lo pone tu ORDER BY; la sección Datos del Editor SQLite sí ordena así, porque ahí la consulta la escribe Calíope—. Y la tira horizontal de herramientas sólo sale en tamaño compacto: con la ventana ancha el lanzador es la barra lateral Herramientas.

Palabras clave: gestos, ipad, táctil, swipe, deslizar, mantener pulsado, long press, pellizcar, pinch, tamaño de fuente, magic keyboard, barra lateral, herramientas, pestañas, renombrar símbolo, ir a la definición, mover a grupo

Gestos de ratón y trackpad en macOS

Los gestos que Calíope declara en el Mac: qué pellizca cada superficie, qué hace la rueda y qué se arrastra.

Calíope declara pocos gestos en el Mac, y casi todos amplían o reducen algo. Ésta es la lista entera.

Pellizcar con dos dedos en el trackpad, y qué mueve cada uno
- Sobre el texto del Editor SQL — el cuerpo de la fuente del editor, de 10 a 26 puntos.
- Sobre la cuadrícula de resultados — el cuerpo de la letra de las celdas, de 11 a 26 puntos. Es otra preferencia: mover una no mueve la otra.
- Sobre la imagen de una celda, en el editor avanzado — acerca y aleja la imagen, del 100 % al 800 %.
- Sobre el lienzo del Diagrama ER o del árbol de Visual EXPLAIN — la escala del lienzo.

La rueda del ratón
Amplía y reduce en los dos lienzos y en la imagen de una celda, con el puntero encima. Sobre el texto del editor y sobre la rejilla de resultados no hace zoom: desplaza, como en cualquier otra parte.

Arrastrar
- Sobre el fondo de un lienzo — lo desplaza. Sobre un nodo del Diagrama ER, mueve la tabla.
- Sobre una imagen ampliada — la desplaza dentro del marco, que no se despega del borde.
- Sobre el borde derecho del encabezado de una columna — cambia su ancho.
- Con ⌃ (Control) desde una tabla del Diagrama ER — crea una clave foránea; eso tiene su propio tema.

Doble clic
- Sobre la imagen de una celda — alterna entre ajustada y el 200 %, anclado donde hiciste clic.
- Sobre una celda de resultados — abre Generar UPDATE, que no es un gesto de zoom y tiene su propio tema.

Ninguno de éstos es la única forma
Las cuatro superficies que se pellizcan tienen botones en su barra, con el número o el porcentaje al lado; los dos lienzos y la imagen responden además a ⌘−, ⌘+ y ⌘0. Un gesto sin equivalente de teclado deja fuera a quien navega con él.

Lo que tiene su propio tema
- Filas y celdas de resultados → Gestos en filas y celdas de resultados.
- Diagrama ER y Visual EXPLAIN → Pan y zoom en Diagrama ER y Visual EXPLAIN.
- Separadores entre paneles → Redimensionar paneles del workspace.
- Clic derecho → Menús contextuales por vista (referencia).

Palabras clave: gestos, macos, trackpad, ratón, rueda, pellizcar, pinch, zoom, tamaño de fuente, doble clic, arrastrar, atajos de teclado, lienzo, imagen

Gestos en filas y celdas de resultados

Qué hace cada clic, toque y arrastre sobre la cuadrícula de resultados. El Mac y los aparatos táctiles no ofrecen lo mismo.

La cuadrícula responde a gestos sobre la celda, sobre el encabezado de una columna y sobre la rejilla entera. El juego del puntero y el del dedo se parecen, pero no coinciden.

macOS

Sobre una celda
- Un clic — selecciona la fila, que es lo que hace una tabla del sistema. Para ver el valor entero, deja el puntero encima: sale en el globo.
- Clic derecho — menú con Copiar, Copiar fila como INSERT, Ver valor completo, Generar UPDATE, Editar valor avanzado…, Exportar CSV, Perfilar columna y Eliminar fila. Las tres que trabajan sobre el valor —ver, generar UPDATE y editar— sólo salen sobre celdas no NULL.
- Las mismas acciones están disponibles con VoiceOver sobre la celda, sin usar el menú.

Sobre el encabezado de una columna
- Un clic — ordena por esa columna, y otro clic invierte el sentido.
- Arrastrar el borde — cambia el ancho, y el ancho se recuerda para esa consulta.
- El encabezado lo dibuja el sistema, así que ahí ya no hay menú propio: Perfilar columna vive en el menú de la celda.

Sobre las filas elegidas
- ⇧ o ⌘ al hacer clic — elige varias.
- ⌘C — las copia en TSV, con los nombres de las columnas delante.
- Arrastrarlas — las saca de la app.

iPad e iPhone

Sobre una celda
- Un toque — abre la hoja con el valor completo.
- Doble toque — abre Generar UPDATE.
- Mantener pulsada — menú con Ver valor completo, Editar valor avanzado…, Generar UPDATE, Copiar y Eliminar fila. Copiar fila como INSERT no está en el iPad ni en el iPhone.

Sobre el encabezado de una columna
- Arrastrar el tirador — cambia el ancho. Mide 16 puntos, más que los 6 del Mac, porque el dedo apunta peor que el puntero; se tiñe mientras dura el arrastre.
- El encabezado no tiene menú contextual en el iPad ni en el iPhone: el Perfilador de columna se abre desde el Mac.

En las tres, sobre la rejilla entera
- Pellizcar con dos dedos —en el trackpad, en macOS— cambia el cuerpo de la letra de las celdas y del encabezado, entre 11 y 26 puntos, y los anchos de columna se reajustan al nuevo tamaño. Es la misma preferencia que mueven los dos botones de tamaño de la barra de resultados, junto a la palabra tabla, y no es la del texto del editor: son dos números distintos y se guardan por separado.

Dos cosas que conviene saber

Los anchos que ajustas a mano se recuerdan mientras dure la sesión, con la pestaña y el juego de columnas como identidad: volver a la misma consulta te devuelve tus medidas, y una consulta con otras columnas arranca con su propio auto-ajuste. Y Eliminar fila no borra nada al pulsarlo: abre la previsualización de borrado, con la fila identificada y la sentencia que se va a ejecutar, para que la confirmes.

Lo que la cuadrícula no hace

No se ordena haciendo clic ni tocando el encabezado: el orden lo pone tu ORDER BY. No hay deslizamientos sobre las filas, ni selección múltiple con un gesto, ni columnas que se oculten o se fijen a la izquierda.

Palabras clave: gestos, filas, celdas, cuadrícula, resultados, clic derecho, doble clic, mantener pulsado, long press, ancho de columna, arrastrar, generar update, editor avanzado, previsualización de borrado, perfilador de columna, copiar como insert, ordenar

Pan y zoom en Diagrama ER y Visual EXPLAIN

Cómo desplazar y ampliar el lienzo del Diagrama ER y del árbol de Visual EXPLAIN, y qué gestos tiene cada plataforma.

El Diagrama ER y Visual EXPLAIN dibujan sus nodos sobre un lienzo virtual que casi siempre excede la ventana. El zoom se hace con el gesto o con los botones de la barra, que además dicen a qué escala estás.

Desplazar el lienzo
Arrastra sobre una zona vacía del lienzo, en las tres y en las dos vistas. Sobre un nodo, el arrastre significa otra cosa.

Ampliar y reducir
- macOS — la rueda del ratón, el desplazamiento vertical de dos dedos en el trackpad, o el pellizco de dos dedos, con el puntero sobre el lienzo. Cada paso de rueda multiplica o divide por 1,15.
- iPad — pellizcar con dos dedos.
- En las tres — los botones y + de la barra de la herramienta, con el porcentaje en medio, y los atajos ⌘− y ⌘+. Un botón se apaga cuando ya no queda recorrido.
- Los límites van del 18 % al 400 % en el Diagrama ER, y del 18 % al 350 % en Visual EXPLAIN.

Encuadre automático
Las dos vistas encuadran solas al abrirse y al cambiar el tamaño de la ventana; el Diagrama ER lo hace además después de Auto-organizar. Y si te has perdido, el botón Ajustar a la ventana de la barra —o ⌘0— vuelve a encuadrarlo todo sin tocar la ventana.

Sólo en el Diagrama ER
- Mover una tabla — arrástrala por su cuerpo. La posición no se conserva sola: se guarda con Guardar disposición, en la barra de herramientas.
- Crear una clave foránea, sólo en macOS — mantén pulsada ⌃ (Control) y arrastra desde una tabla hasta la de destino. Mientras dura el gesto se dibuja una línea elástica; al soltar se abre la hoja con el ALTER TABLE que se va a ejecutar. En iPad este gesto no existe: la clave foránea se crea desde Nueva clave foránea, en el menú contextual de la tabla.
- Menú del lienzo vacío, sólo en macOS — clic derecho sobre el fondo: Auto-organizar, Guardar disposición y la exportación a PNG o PDF en tres tamaños.

En Visual EXPLAIN
Los nodos no se mueven y el lienzo no tiene menú contextual: el árbol lo dispone la vista a partir del plan, y su forma es parte de lo que te está diciendo.

El lienzo y VoiceOver
El diagrama se dibuja con un Canvas, que VoiceOver no puede recorrer. Por eso el Diagrama ER expone aparte la lista de tablas y la de relaciones, y ahí no hace falta ningún gesto.

Palabras clave: pan, zoom, desplazar, diagrama er, erd, visual explain, pellizcar, pinch, rueda del ratón, trackpad, arrastrar nodo, clave foránea, foreign key, fk, control, guardar disposición, auto-organizar, exportar, voiceover

Redimensionar paneles del workspace

Los separadores arrastrables del espacio de trabajo: los dos ejes, el doble clic que restablece y qué pasa cuando la ventana se estrecha.

Casi todas las herramientas reparten su espacio con un separador arrastrable de 6 puntos, el mismo componente en macOS y en iPad. Hay dos, no sólo el horizontal.

Separador entre arriba y abajo
Es el del Editor SQL entre el texto y los resultados, y el de las herramientas que apilan detalle y panel auxiliar. Arrástralo hacia arriba o hacia abajo: el panel superior no baja del 20 % ni pasa del 85 % de la altura disponible.

Separador entre izquierda y derecha
Es el que separa el panel lateral de una herramienta —la lista, el árbol o el selector— de su detalle. Arrástralo a izquierda o derecha: el panel no se queda con menos de 140 puntos y al detalle siempre le quedan 260.

Los dos se comportan igual
- Doble clic o doble toque sobre el separador — restablece el reparto por omisión de esa herramienta. Es la salida rápida cuando un panel se ha quedado en nada.
- En macOS, al pasar el puntero el cursor cambia a ↕ o ↔ y la línea engorda y se tiñe del color de acento; mientras arrastras se mantiene teñida.
- En iPad no hay cursor, pero la banda sensible es exactamente la misma.
- El reparto se guarda, y el del panel lateral se guarda por separado para el Mac y para el iPad: la ventana ancha del escritorio y la pantalla del iPad no quieren el mismo reparto.

Cuando la ventana se estrecha
Hay dos comportamientos, y los distingue el tamaño de la pantalla y no el aparato.

En el iPhone, en Slide Over y en cualquier ventana de tamaño compacto no hay dos zonas: la lista es la pantalla, y al elegir algo se empuja el detalle con su flecha de volver, como en cualquier app de iOS. También hay un botón Ver el detalle en la barra de arriba, que es el camino que existe siempre.

En una ventana estrecha que todavía es de tamaño normal —una ventana pequeña del Mac— el panel se colapsa a una banda con un botón y se abre como un cajón superpuesto sobre el detalle. Al ensanchar vuelve a ser un panel permanente.

Dos separadores con reglas propias
- En el Constructor de consultas, el panel del SQL generado se arrastra por su asa con forma de cápsula, entre 60 y 500 puntos de alto.
- En la cuadrícula de resultados lo que se arrastra son los bordes de las columnas, no un separador de paneles; está en Gestos en filas y celdas de resultados.

Palabras clave: redimensionar, resize, separador, divisor, panel, arrastrar, altura, anchura, vertical, horizontal, doble clic, restablecer, cajón, slide over, editor sql, panel lateral, constructor de consultas

Menús contextuales por vista (referencia)

Qué ofrece el clic derecho en macOS —o el mantener pulsado en iPad— en cada vista que tiene menú.

En macOS el menú contextual se abre con clic derecho; en iPad, manteniendo pulsado el elemento. No todas las vistas tienen menú, y las que lo tienen no ofrecen lo mismo.

Gestor de conexiones
- Sobre un perfil: Conectar, Clonar, Mover a grupo (submenú con los grupos que haya, más «Sin grupo»), Eliminar.
- Sobre un grupo: Renombrar, Nuevo grupo, Eliminar grupo.

Árbol del esquema (dentro del Editor SQL)
- Sobre una base de datos: Usar como base activa, Refrescar tablas, Refrescar bases de datos, Copiar nombre.
- Sobre un objeto: Copiar nombre, Copiar nombre completo, Refrescar las tablas de su base y, desde el editor, Importar datos y Constructor de WHERE.

Catálogos
- Tablas: Diseñar tabla, Ver DDL, Poblar con datos ficticios, Eliminar tabla.
- Vistas: Ver DDL, Editar (formulario visual), Abrir en el editor de ítems.
- Índices: Editar (formulario visual), Eliminar índice.
- Rutinas: Ver DDL, Editar, Abrir en el editor de ítems, Eliminar.
- Triggers: Ver DDL, Editar, Abrir en el editor de ítems.
- Eventos: Ver DDL, Editar, Abrir en el editor de ítems, Eliminar evento.

Editor SQL, sobre el texto
- macOS: Ir a la definición y Renombrar símbolo sobre la palabra que hay bajo el puntero, más Expandir SELECT \* en la tabla si el cursor está dentro de uno. Debajo queda el menú de edición estándar de macOS.
- iPad: Ir a la definición y Renombrar símbolo.

Cuadrícula de resultados
Tiene su propio tema: Gestos en filas y celdas de resultados.

Registro SQL
- En el registro persistente: Ver detalle, Copiar consulta, Abrir en el editor, Copiar resultado. El doble clic sobre una fila abre el detalle directamente; en iPad, un toque.
- En el historial de la sesión: Ver detalle, Copiar consulta, Abrir en el editor.

Lista de procesos
- Sobre un proceso: Terminar la conexión y Terminar la consulta. Son dos cosas distintas: la primera echa al cliente, la segunda corta sólo lo que está ejecutando en ese momento.

Fragmentos
- Sobre un fragmento: Copiar contenido, Eliminar. El resto se edita en el panel de la derecha.

Diagrama ER
- Sobre una tabla: Editar estructura, Nueva clave foránea.
- Sobre el lienzo vacío, sólo en macOS: Auto-organizar, Guardar disposición, y la exportación a PNG y a PDF en tres tamaños.

Además tienen menú contextual
El Asistente IA y su historial, las Alertas SQL, el Constructor de tablas, las Sentencias SQL, el Comparador de esquemas, la Información del servidor, el Editor SQLite, el Registro de errores, el Historial de ejecuciones, los Reportes y la lista de conexiones de Preferencias.

Las pestañas del espacio de trabajo no tienen menú contextual. Se cierran con su ×, y en iPad además con ⌘⇧W. No hay duplicar, ni fijar, ni cerrar las demás.

Palabras clave: menú contextual, context menu, clic derecho, right click, mantener pulsado, long press, referencia, catálogos, árbol de esquema, registro sql, procesos, fragmentos, conexiones, diagrama er, editor sql, pestañas