Cómo personalizar la interfaz de usuario de CODE y ocultar barras de herramientas específicas

Respuesta breve: En CODE, cambie el estilo general de la barra de herramientas con la configuración de vista Compacta o con pestañas. Para ocultar una pestaña del cuaderno o un comando, la opción compatible es la API PostMessage del host WOPI; los menús normales del visor no eliminan permanentemente los comandos individuales para todos los usuarios. Los administradores pueden configurar el modo de interfaz predeterminado para un servidor, mientras que los hosts que integran CODE pueden enviar mensajes para ocultar o mostrar comandos a nivel de sesión.

Seleccione el método que mejor se ajuste a su acceso. Si solo necesita más espacio para el documento, contraiga la barra de herramientas o cambie a la vista compacta. Si su integración con WOPI debe omitir la pestaña Ayuda o un comando de formato, envíe el PostMessage correspondiente una vez que el editor esté listo. Si su objetivo es impedir una acción como imprimir, descargar o editar, utilice también la capacidad o el permiso de WOPI pertinente; ocultar un botón modifica la presentación, no la autorización.

Elige la personalización adecuada

Lo que quieres cambiarUtilice este métodoA qué afecta
Utilice el menú compacto o la barra de bloc de notas con pestañas de forma predeterminada.Configurado user_interface.modeen la configuración del servidorModo de interfaz predeterminado para esa implementación de CODE.
Haga más espacio para el documento temporalmente.Colapsar la barra del cuaderno desde la interfaz de usuario o enviarCollapse_NotebookbarOculta los botones de pestaña; el usuario puede volver a expandirlos.
Ocultar una pestaña de la barra de tareas, como Ayuda.EnviarHide_NotebookTabUna pestaña en una sesión de editor integrada en WOPI
Ocultar un comando en la interfaz de usuario del editorEnviarHide_CommandMenú, barra de herramientas y entradas del menú contextual de ese comando
Ocultar solo un botón específico de la barra de herramientasEnviar Hide_Buttoncon su ID de botónUn botón en la barra de herramientas; el ID puede variar según la interfaz de usuario y la versión.

El manual del SDK correspondiente indica Hide_NotebookTabque está disponible a partir de la versión 24.04.11.1 y Hide_Commanda partir de la versión 24.04.11.2. Los paquetes de lanzamiento de CODE y las compilaciones del integrador pueden diferir, así que compruebe la versión del servidor que utiliza antes de confiar en un mensaje de la API.

Cambiar la vista predeterminada entre vista compacta y vista con pestañas.

La vista compacta utiliza un menú y una barra de herramientas más pequeña. La vista con pestañas agrupa los controles en las pestañas de la barra de herramientas. La configuración del servidor es user_interface.mode, con valores admitidos compacty tabbed. Las etiquetas antiguas como classicy notebookbarestán obsoletas en favor de estos nombres.

Un editor de documentos basado en navegador muestra una fila de menú compacta y una estrecha barra de herramientas de formato encima de una página de ejemplo.
Vista compacta ilustrativa: el editor utiliza una fila de menú y una estrecha barra de herramientas de formato situada encima del documento.

Para una configuración predeterminada controlada por el administrador, edite la <mode>entrada existente dentro de la <user_interface>sección de coolwsd.xml:

<user_interface>
  <mode type="string" desc="Controls the user interface style. The 'default' means: Take the value from ui_defaults, or decide for one of compact or tabbed (default|compact|tabbed)" default="default">tabbed</mode>
</user_interface>

Utilice compacten lugar de tabbedpara el menú compacto. En un archivo de configuración real, modifique la entrada de modo existente en lugar de agregar una segunda. La ruta de configuración exacta y el procedimiento de reinicio dependen de si CODE está instalado como paquete, contenedor o a través de otra plataforma. Siga el método de configuración de esa implementación, reinicie o recargue el servicio según sea necesario y abra una nueva sesión de documento para confirmar la configuración predeterminada.

Esto establece un modo de interfaz predeterminado; no oculta un comando específico. Un usuario o integrador puede tener preferencias de interfaz guardadas que prevalecen, según la configuración del estado de la interfaz de usuario guardada del servidor. Si un navegador se vuelve a abrir repetidamente con una vista diferente, pruebe con una nueva sesión y verifique el comportamiento de las preferencias del usuario del integrador antes de modificar más configuraciones del servidor.

Contraer la barra de herramientas sin eliminar los comandos

Cuando el objetivo es simplemente aumentar el espacio del documento, suele ser suficiente con minimizar la barra de pestañas. El Collapse_Notebookbarmensaje del SDK oculta los botones de la barra de pestañas; los nombres de las pestañas permanecen visibles para que los usuarios puedan volver a expandir los controles. El mismo mensaje también oculta la tira de botones en la vista compacta. Este cambio de visualización es reversible, no una forma de deshabilitar las funciones de edición.

Un editor de documentos muestra la barra de bloc de notas con pestañas: Inicio, Insertar, Diseño, Revisar, Vista y Ayuda, situadas encima de los controles de formato agrupados.
Vista ilustrativa con pestañas, donde se muestran las pestañas de la barra de notas y los controles de formato agrupados.

En una interfaz compatible, el usuario también puede contraer o expandir la barra de notas interactuando con su tira de pestañas. El comportamiento exacto al hacer clic o doble clic puede variar según la vista y la forma de soltar el botón. Si los usuarios necesitan restaurar una barra contraída, mantengan visibles los nombres de las pestañas y prueben la acción en la misma versión de CODE que utilizan.

Ocultar una pestaña o comando en una integración WOPI

La ocultación por sesión requiere una aplicación anfitriona que incruste CODE en un iframe y pueda enviarle mensajes. No es una configuración de propósito general que se pueda pegar en coolwsd.xml. La API PostMessage utiliza mensajes con un MessageId, una marca de tiempo y opcionalmente Values. El host WOPI debe completar el intercambio de disponibilidad antes de enviar comandos del editor. Configure WOPI PostMessageOriginpara la página anfitriona y utilice el origen exacto del iframe de CODE como destino del mensaje del navegador; no utilice un origen de destino comodín.

Después de que el host haya recibido el App_LoadingStatusevento de disponibilidad apropiado y lo haya enviado Host_PostmessageReady, puede enviar un mensaje para ocultarlo. Por ejemplo, las siguientes llamadas ocultan la pestaña Ayuda y el comando de subrayado para la sesión del editor abierta:

const frame = document.getElementById("collaboraFrame");
const collaboraOrigin = "https://office.example.com";

function sendToCollabora(MessageId, Values = {}) {
  frame.contentWindow.postMessage({
    MessageId,
    SendTime: Date.now(),
    Values
  }, collaboraOrigin);
}

// Call after the WOPI PostMessage readiness exchange.
sendToCollabora("Hide_NotebookTab", { id: "Help" });
sendToCollabora("Hide_Command", { id: ".uno:Underline" });
El editor con pestañas muestra Inicio, Insertar, Diseño, Revisar y Vista, con la pestaña Ayuda oculta.
Vista ilustrativa con pestañas, donde la pestaña Ayuda está oculta y las demás pestañas de la barra de tareas siguen visibles.
La barra de herramientas del editor omite el control de subrayado, mientras que otros controles de formato permanecen; el panel de código anfitrión muestra un mensaje Hide_Command para .uno:Underline.
Ejemplo ilustrativo de personalización del host WOPI: el comando de subrayado se oculta mientras que el resto de la barra de herramientas permanece visible.

Reemplaza office.example.comcon el origen de tu propio iframe de CODE. El ejemplo ilustra la estructura del mensaje; intégralo en el ciclo de vida real del iframe del host y valida el origen de los mensajes entrantes antes de responder. La documentación de CODE indica que los mensajes del host enviados con anterioridad Host_PostmessageReadypueden ser ignorados.

¿Qué mensaje deberías usar?

  • Hide_NotebookTab: Úselo para una pestaña completa en la vista de pestañas. Es idel ID de la pestaña, como por ejemplo Help. Show_NotebookTabrevierte el cambio. La pestaña permanece oculta durante la sesión hasta que llega un mensaje para mostrarla.
  • Hide_Command: Úselo cuando el comando deba desaparecer del menú, la barra de herramientas y los menús contextuales. Un ejemplo de ID es .uno:Underline. Show_Commandlo invierte. Úselo solo cuando el resultado deseado sea eliminar ese comando de todas esas superficies.
  • Hide_ButtonÚselo cuando desee ocultar un solo botón en lugar de todas las entradas de la interfaz de usuario para el comando. Su ID es el ID de un botón de la barra de herramientas, no necesariamente el nombre del comando UNO. Collabora documenta que estos ID suelen ser estables, pero no se garantiza su estabilidad; confírmelos en el código fuente para su compilación y formato de dispositivo específicos.
  • Hide_MenubarEsto oculta la barra de menús por completo. No es un control por comando y no debe confundirse con ocultar una pestaña de la barra de notas.

La API postMessage está diseñada para un host de integración. Si utiliza Nextcloud, ownCloud u otra plataforma, compruebe si su conector ofrece una configuración compatible antes de crear código personalizado para el host. Evite inyectar CSS en la página del editor: es inestable entre versiones y solo oculta los controles visualmente.

Comprueba que el cambio se ajusta a tu caso de uso.

Abra un documento de prueba con el mismo navegador, tipo de documento, permisos y versión de CODE que sus usuarios. Confirme el modo seleccionado, compruebe que solo se oculte la pestaña o el comando deseado y pruebe el mensaje o la acción de expansión de la barra de herramientas correspondiente. Repita el proceso para Writer, Calc e Impress si su integración abarca las tres aplicaciones; los comandos disponibles y los identificadores de la barra de herramientas no son necesariamente idénticos entre los módulos.

Si el control oculto sigue apareciendo, compruebe que el host envió el comando Host_PostmessageReady, que su origen WOPI PostMessageOriginy de destino del iframe son correctos y que el mensaje utilizó el ID y la ortografía esperados. Compruebe también la versión del servidor con respecto a la línea base de características documentada. Una ocultación visual exitosa no elimina el comando del motor de documentos subyacente ni establece una restricción de seguridad. Utilice los permisos WOPI y la política de backend para el control de acceso.

Referencias oficiales

Dejar un comentario

Cómo mover una imagen en Microsoft Word

Cómo mover una imagen en Microsoft Word

Aprende a arrastrar una imagen en Word, a elegir el ajuste de texto, a mantenerla dentro de un párrafo o a fijarla en la página, y a solucionar problemas con imágenes que no se mueven.

Cómo insertar una casilla de verificación en Excel: dos métodos sencillos

Cómo insertar una casilla de verificación en Excel: dos métodos sencillos

Aprende a insertar una casilla de verificación en Excel con la herramienta "En celda", a contar los elementos seleccionados con fórmulas o a agregar un control de formulario vinculado en versiones de escritorio anteriores.

Cómo autocompletar letras en Excel: de la A a la Z y más allá

Cómo autocompletar letras en Excel: de la A a la Z y más allá

Genere letras de la A a la Z, letras minúsculas o etiquetas más allá de la Z en Excel con una fórmula de controlador de relleno, una SECUENCIA o una lista personalizada reutilizable.

Cómo tachar texto en Excel: Atajos y métodos paso a paso

Cómo tachar texto en Excel: Atajos y métodos paso a paso

Aprende a tachar texto en Excel para Windows, Mac y la web, a dar formato a parte de una celda y a eliminar la línea sin borrar su valor.

¿Qué es Microsoft Access? ¿Cómo funcionan sus herramientas de base de datos?

¿Qué es Microsoft Access? ¿Cómo funcionan sus herramientas de base de datos?

Microsoft Access es una aplicación de base de datos para Windows que permite almacenar registros relacionados, crear consultas, generar formularios de entrada de datos y crear informes. Descubra cómo funciona y cuándo es la opción más adecuada.

Importación y exportación de Office Outlook 2010: Transferencia de datos con un archivo PST

Importación y exportación de Office Outlook 2010: Transferencia de datos con un archivo PST

Aprende a importar un archivo PST a Outlook 2010 o a exportar correo electrónico, contactos, calendario y tareas. Sigue los menús correctos y evita carpetas faltantes o duplicadas.

Cambiar la altura y el ancho de las líneas de cuadrícula en Word 2010

Cambiar la altura y el ancho de las líneas de cuadrícula en Word 2010

Aprenda a ajustar la altura y el ancho de las líneas de cuadrícula en Word 2010, cambiar la frecuencia de las líneas visibles y establecer el espaciado horizontal y vertical subyacente de la cuadrícula de dibujo.

Recuperar una contraseña de Outlook PST con Nucleus Kernel

Recuperar una contraseña de Outlook PST con Nucleus Kernel

Recupere una contraseña olvidada de un archivo PST de Outlook siguiendo los pasos actuales de Kernel, que incluyen cómo identificar el archivo correcto, realizar una copia de seguridad y comprobar los límites de la herramienta.

Cómo insertar una página web en vivo en una diapositiva de PowerPoint

Cómo insertar una página web en vivo en una diapositiva de PowerPoint

Utilice el complemento LiveWeb para insertar un sitio web en una diapositiva de PowerPoint, configurar su tamaño y comportamiento de actualización, y comprobar la compatibilidad antes de la presentación.

Agrega los días festivos nacionales a tu calendario de Outlook.

Agrega los días festivos nacionales a tu calendario de Outlook.

Agregue días festivos específicos de cada país en la nueva versión de Outlook, Outlook en la web o la versión clásica de Outlook. Aprenda cómo evitar eventos duplicados y compruebe si faltan fechas de 2026-2027.