La version 9.0 de la suite bureautique en ligne ONLYOFFICE Docs apporte des améliorations pour les développeurs, notamment les mises à jour de l’API ainsi que de nouvelles options de personnalisation
ONLYOFFICE Docs 9.0 apporte des améliorations pour les développeurs et intégrateurs : nouvelles options de personnalisation, formats de fichiers supplémentaires, optimisations de performance et extension des API pour les plugins, macros et documents. Voici un tour d'horizon des changements les plus pertinents pour la communauté technique.
OnlyOffice est une suite bureautique en ligne et un écosystème d'applications collaboratives. Elle propose des éditeurs en ligne pour les documents texte, les feuilles de calcul, les présentations, les formulaires et les PDF, ainsi qu'une plateforme de collaboration en salles. La version 9.0 d'ONLYOFFICE Docs est disponible et introduit plus de 30 fonctionnalités inédites et environ 500 correctifs, avec une attention particulière portée à l’interface utilisateur, à la compatibilité des formats, à l’intégration de l’intelligence artificielle, et à l'amélioration des flux de travail collaboratifs.
En outre, ONLYOFFICE Docs 9.0 introduit de nombreuses améliorations conçues pour les développeurs et intégrateurs : nouvelles options de personnalisation, formats de fichiers supplémentaires, optimisations de performance et extension des API pour les plugins, macros et documents. Voici un tour d'horizon des changements les plus pertinents pour la communauté technique.
Visionneuse de diagrammes
La nouvelle visionneuse de diagrammes est disponible pour le web, le bureau et le web mobile. Il permet d’ouvrir des fichiers de diagramme sans avoir recours à des applications tierces.
Où trouver dans l’API : le type de document du diagramme est ajouté au paramètre documentType.
Prise en charge de nouveaux formats de fichiers
ONLYOFFICE continue d’étendre ses possibilités d’utilisation en prenant en charge de nouveaux formats de fichiers. Dans la version 9.0, il est possible d’ouvrir les fichiers Markdown et OpenDocument Graphic pour les visualiser.
Où trouver dans l’API : ajout de l’ouverture des formats odg et md.
De plus, avec le lancement de la visionneuse de diagrammes, nous avons ajouté la conversion des formats vsdm, vsdx, vssm, vssx, vstm et vstx. Vérifier l’API
Options de personnalisation étendues
La personnalisation a atteint de nouveaux sommets dans la version 9.0, permettant à vos utilisateurs finaux d’adapter leur expérience ONLYOFFICE exactement comme ils le souhaitent.
Nouveaux thèmes d’interface utilisateur
Deux nouveaux thèmes, Clair moderne et Sombre moderne, sont présentés pour optimiser la recherche de chaque éditeur.
Où trouver dans l’API : Les identifiants des thèmes theme-white et theme-night sont ajoutés au paramètre editorConfig.customization.uiTheme.
1 2 3 4 5 6 7 8 9 10 11 12 13 14
| 1
2
3
4
5
6 |
const config = {
editorConfig: {
customization: {
...
uiTheme: "theme-white",
... |
|
Sélection de la taille des polices pour l’interface utilisateur en chinois simplifié
Ce nouveau paramètre garantit une taille de police précise dans les mises en page en chinois simplifié, offrant ainsi la possibilité d’utiliser des styles occidentaux ou traditionnels.
Où trouver dans l’API : paramètre editorConfig.customization.forceWesternFontSize, la valeur par défaut est false.
1 2 3 4 5
| const config = {
editorConfig: {
customization: {
.... forceWesternFontSize: false,
... |
Masquage des avatars des utilisateurs
Ce nouveau paramètre vous permet de masquer les avatars des utilisateurs dans l’en-tête de l’éditeur, ce qui contribue à créer une interface propre et sans distraction.
Où trouver dans l’API : paramètre editorConfig.customization.layout.header.user, la valeur par défaut est true.
1 2 3 4 5 6 7 8 9 10
| const config = {
editorConfig: {
customization: {
... layout: {
header: {
editMode: true,
save: true,
user: true,
users: true,
}, |
Amélioration des performances grâce au préchargement
À partir de la version 9.0, vous pouvez précharger les ressources statiques (HTML, CSS, JS, polices) dans le cache du navigateur avant d’ouvrir un fichier afin d’accélérer le chargement initial de l’éditeur de documents. Vérifier l’API
Deux options sont disponibles :
1) Utilisation du paramètre ?preload=placeholder
1 2 3
| <div id="placeholder"></div>
<script type="text/javascript" src="https://documentserver/web-apps/apps/api/documents/api.js?preload=placeholder"></script> |
2) Insertion manuelle d’une iframe de préchargement
<iframe src="https://documentserver/web-apps/apps/api/documents/preload.html" style="display:none;"></iframe>
Obtenez la dernière version de ONLYOFFICE Docs Developer : Télécharger
Amélioration de l’API pour les plugins et les macros
Boutons personnalisés pour les contrôles de contenu. Utilisez la classe Asc.ButtonContentControl pour créer des boutons uniques pour vos plugins. Définissez des actions à l’aide de la méthode attachOnClick et ajoutez vos propres icônes pour améliorer les fonctionnalités. Vérifier l’API
1 2 3 4 5 6 7 8 9 10 11 12
| (function(window){
window.Asc.plugin.init = function()
{
let button = new Asc.ButtonContentControl();
button.icons = '/resources/check%scale%(default).png';
button.attachOnClick(function(contentControlId){
Asc.plugin.executeMethod("RemoveContentControl", [contentControlId]);
}); button = new Asc.ButtonContentControl();
button.icons = '/resources/close%scale%(default).png';
button.attachOnClick(function(contentControlId){
Asc.plugin.executeMethod("RemoveContentControls", [[{"InternalId": contentControlId}]]);
}); } })(window); |
Définition de la diapositive active en fonction de son index. Accédez facilement à n’importe quelle diapositive dans les présentations grâce à la nouvelle méthode GoToSlide.
expression.GoToSlide(slideNumber);
Élément de liste de contrôle de contenu. L’introduction de l’énumération ContentControlListElement simplifie encore la gestion des contrôles de contenu dans les documents.
Calculs asynchrones. Gérez toute requête dans le corps d’une fonction personnalisée créée à l’aide de macros.
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28
| (function () {
/**
* World Bank indicator value for a specific year.
* @customfunction
* @param {string} country ISO-3 code, e.g. "TUR"
* @param {string} indicator Indicator code, e.g. "SP.POP.TOTL"
* @param {number} year Four-digit year, e.g. 2024
* @returns {any} Numeric value or #N/A
*
* @example =WB("TUR","SP.POP.TOTL",2024)
*/
async function WB(country, indicator, year) {
// Build URL (World Bank allows CORS)
const url =
`https://api.worldbank.org/v2/country/${country}/indicator/${indicator}` +
`?format=json&per_page=20000`;
try {
const r = await fetch(url);
const [meta, data] = await r.json();
// Find the row for the requested year
const row = data.find((v) => v.date === year.toString());
if (!row || row.value == null) return "#N/A";
return row.value; // resolves the Promise
} catch (e) {
return "#ERROR";
} } // Register the function so it becomes a sheet formula
Api.AddCustomFunction(WB); })(); |
Nouveaux exemples
Avec la dernière mise à jour de la documentation de l’API, nous avons inclus encore plus d’exemples prêts à l’emploi pour Document Builder et les macros, ce qui rend votre processus de développement plus fluide et plus efficace.
Framework de construction
Macros
De nouveaux exemples de macros sont disponibles pour tous les types d’éditeurs, par exemple :
Voir tous les exemples de macro
API Office
Pour l’API Office JavaScript, OnlyOffice a ajouté de nouvelles méthodes pour la version 9.0, y compris celles pour :
- Contrôles de contenu
- XML personnalisé
- Formulaires
- Propriétés personnalisées
- Core
- Plage
- Dessin
- Présentation
- Page de notes
Voir la liste complète des nouvelles méthodes
Obtenez la dernière version de ONLYOFFICE Docs Developer : Télécharger
Partager