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 la propiedad documentType, por ejemplo:
const config = {
documentType: "pages",
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:
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.
Crea tu cuenta gratuita de ONLYOFFICE
Visualiza, edita y colabora en documentos, hojas, diapositivas, formularios y archivos PDF en línea.