Resumen de la API: las últimas actualizaciones para ONLYOFFICE Docs

Hemos implementado una serie de actualizaciones en la API de ONLYOFFICE Docs, orientadas a mejorar la compatibilidad, la personalización y la seguridad. Ya sea que estés creando flujos de trabajo personalizados, habilitando la colaboración segura en documentos o integrándote con las APIs  avanzadas, estas mejoras ofrecen posibilidades ilimitadas. Aquí tienes un resumen de las últimas incorporaciones y mejoras.

Compatibilidad ampliada con formatos de archivo

La API de Docs ahora admite formatos de archivo adicionales, ofreciendo una compatibilidad más amplia para garantizar una experiencia fluida para los usuarios que trabajan con distintos tipos de archivos. Entre los nuevos formatos compatibles se encuentran los de Apple iWork y los de Hancom Office:

• pages
• key
• numbers
• hwp
• hwpx

Estos formatos pueden especificarse mediante el parametro fileType, por ejemplo:

const config = {
  document: {
    fileType: "pages",
  },
};

const docEditor = new DocsAPI.DocEditor("placeholder", config);

Opciones de personalización mejoradas

Ahora los desarrolladores tienen más control sobre el comportamiento y la apariencia del editor. Las actualizaciones clave incluyen:

• Ocultación de consejos de funciones
  

El parámetro editorConfig.customization.features.featuresTips permite activar o desactivar los mensajes emergentes sobre nuevas funciones durante la primera carga del editor tras una actualización. El valor predeterminado es true.

• Visualización de barras de desplazamiento en hojas de cálculo

A partir de la versión 8.3, es posible definir si el desplazamiento horizontal/vertical se muestra o se oculta automáticamente al cargar el editor de hojas de cálculo. Consulta los parámetros editorConfig.customization.showHorizontalScroll y editorConfig.customization.showVerticalScroll para controlarlo.

• Fondo de presentación en modo diapositiva

Usa el parámetro editorConfig.customization.slidePlayerBackground para definir el color de fondo de la presentación en formato HEX, RGB o RGBA. Por ejemplo, #ff0000, rgb(255, 0, 0), rgba(255, 0, 0, 0.5).

showHorizontalScroll: true,
showVerticalScroll: true,
slidePlayerBackground: "#000000",

• Colores para los encabezados del documento

Personaliza los estilos de los encabezados en el editor de documentos con el parámetro editorConfig.customization.wordHeadingsColor que permite especificar colores en formato HEX.

• Botón de información en móviles 

Activa o desactiva la visualización del botón de Información del Documento en los editores móviles mediante editorConfig.customization.mobile.info. El valor predeterminado es false.

• Modo de puntero

Ajusta el modo del puntero (selección o mano) en el visor de presentaciones utilizando el parámetro editorConfig.customization.pointerMode. El valor predeterminado es select.

• Barra de herramientas compacta para el visor

El parámetro editorConfig.customization.compactToolbar ahora es compatible con el modo visor, permitiendo alternar entre barra de herramientas completa o compacta. El valor predeterminado en modo visor es true.

Mejoras en funciones de seguridad

La API de Docs ahora permite gestionar archivos protegidos con contraseña mediante el nuevo evento events.onUserActionRequired. Esta función se activa cuando se requiere una acción del usuario para abrir un documento, en los siguientes casos:

• cuando se necesita introducir una contraseña para abrir el documento protegido;
• cuando se debe seleccionar una codificación para un archivo TXT;
• cuando se debe elegir una codificación y un delimitador para un archivo CSV.

Aquí tienes un ejemplo de cómo funciona el evento:

function onUserActionRequired() {
  console.log("Enter a password")
};
const config = {
  events: {
    onUserActionRequired,
  },
};
const docEditor = new DocsAPI.DocEditor("placeholder", config);

Además, ahora puedes usar el comando drop para prohibir la edición de documentos a usuarios específicos:

{
  "c": "drop",
  "key": "Khirz6zTPdfd7",
  "users": ["6d5a81d0"]
}

El registro completo de cambios de la API de Docs está disponible aquí.

Obtén la última versión de ONLYOFFICE Docs Developer:

DESCARGAR AHORA

Nuevos métodos en la API de Office

La API de Office API recibe importantes actualizaciones para una mejor gestión de documentos, entre ellas:

• Marcadores
• Controles de contenido
• Secciones
• Autofiltros
• Selección
• Y más

Estas mejoras permiten interacciones más completas y experiencias de edición más avanzadas. Para un desglose detallado de los comandos, consulta el registro de cambios de la API de Office.

Actualizaciones en la API de plugins

Varios método y propriedades nuevos amplía las capacidades de los plugins:

• Recuperación de contenido

El método GetSelectedContent permite recuperar el contenido seleccionado en un formato especificado.

expression.GetSelectedContent(prop);

• Mensajes de error

El método ShowError permite a los plugins mostrar mensajes de error o advertencia.

expression.ShowError(error, level);

• Propiedades mejoradas para los controles de contenido 

Nuevas propiedades como Shd (sombreado de fondo) y Border mejoran el objeto ContentControlProperties para una mejor personalización visual.

• Activación del panel 

El parámetro isActivated permite especificar si un panel de plugin creado se carga expandido (true) o colapsado (false).

Consulta la lista completa de actualizaciones de la API de plugins.