Limitations

À lire avant d'adopter la bibliothèque

pptx-viewer couvre une large part de la spécification OpenXML, mais certains éléments sont approximés, en lecture seule ou limités par la plateforme du navigateur. Cette page recense les limitations connues ; elle ne constitue pas une garantie exhaustive de compatibilité avec chaque fonctionnalité d'Office ou extension tierce. Vérifiez data.warnings après avoir chargé une présentation et consultez Conformité OpenXML pour le manifeste de couverture formel.

Moteur principal (pptx-viewer-core)

Fonctionnalité	Statut	Remarques
Disposition SmartArt	Approximative sans dessin en cache	Les présentations enregistrées sans le dsp:drawing en cache sont mises en page par un moteur DiagramML par point (143 dispositions) ou par l'ancien interpréteur par famille. Sur 229 fixtures de galerie créées via COM, 228 produisent le même ensemble de formes que PowerPoint, 143 reproduisent sa géométrie à 1 % près (181 à 5 % près) et 129 respectent chaque taille de police. Name and Title Organization Chart, les hiérarchies étiquetées et en tableau, les organigrammes horizontaux avec assistants et trois dispositions (Arrow Ribbon, Balance, Varying Width List) restent inexacts. Voir Conformité OpenXML pour les mesures.

Création d'animations

Un effet créé dans le volet d'animation est intégré à l'arbre p:timing existant de la diapositive ; les effets propres à la présentation restent identiques octet pour octet. Lacunes connues :

• Les directions couvrent seulement les variantes de bord et de coin. Chaque effet d'entrée et de sortie est enregistré avec l'arbre de comportement propre à PowerPoint pour son préréglage et sa direction ; changer le préréglage ou la direction d'un effet existant reconstruit cet arbre, et une nouvelle durée recale ses temps (rouvert dans PowerPoint via COM, son propre rendu correspond image par image aux effets créés dans PowerPoint). Le sélecteur de direction propose exactement les variantes que connaît PowerPoint : les huit pour Balayer et Ramper, les quatre bords pour Essuyer, Coup d'œil et Étirer. Fractionner, Zoom, Stores et les révélations de forme gardent leur variante par défaut, Flottant n'a pas de direction (Flotter vers le haut et Flotter vers le bas sont des préréglages distincts), et Clignotement est une approximation.
• Certains préréglages sont approximés à la lecture. Les effets d'entrée et de sortie jouent l'arbre de comportement propre à la présentation : ses formules, le minutage et l'accélération propres à chaque comportement, les trajectoires à allure constante sur leur longueur, les fondus et les essuyages, si bien que Balayer part juste hors du bord de la diapositive comme dans PowerPoint. Comparée image par image au rendu CreateVideo de PowerPoint pour 116 variantes de préréglage et de direction (une forme de 200 pt sur 2 s), la forme visible reste en moyenne à environ 15 px de celle de PowerPoint ; Pivoter et Pivot estompé ne diffèrent qu'à l'instant où leur largeur passe par zéro, et Arc vers le haut s'écarte jusqu'à 75 px au début de sa courbe. Encore approximés : Machine à écrire couleur joue un effet de substitution, les sorties Forme carrée, Cercle, Losange et Plus respectent leur direction Avant/Arrière (Arrière ouvre au centre un trou qui s'agrandit jusqu'aux bords), mais seulement à partir du jeton de filtre ou de presetSubtype 32, et les effets d'accentuation utilisent des images clés de préréglage.
• Pris en charge partiellement : un p14:bounceEnd de 100 % (plus aucune course restante, ce que PowerPoint lui-même rend de façon erratique) est limité à 95 %. Les déclencheurs sur signet multimédia (« Sur signet »), les transitions p15 avec leurs options de direction et la direction Avant/Arrière de la transition Zoom peuvent être créés dans les cinq liaisons, et la courbe d'amortissement de « Fin rebondissante » est ajustée sur les images de PowerPoint lui-même.

Détecter les lacunes à l'exécution

Inutile de deviner si un fichier touche une limitation. Le pipeline de chargement signale de nombreuses constructions non prises en charge ou approximées (pas toutes : les effets d'animation de substitution, par exemple, ne déclenchent aucun avertissement) dans data.warnings, typées PptxCompatibilityWarning :

interface PptxCompatibilityWarning {
	code: string; // stable machine-readable code
	message: string;
	severity: 'info' | 'warning';
	scope: 'presentation' | 'slide' | 'element' | 'save';
	slideId?: string; // present for slide/element-scoped warnings
	elementId?: string;
	xmlPath?: string; // where in the package the construct lives
}

Vérifiez data.warnings après load() (et après save()) si votre application doit signaler des écarts de fidélité aux utilisateurs ou activer des fonctionnalités selon le fichier.

Consultez Environnements d'exécution pour savoir où s'exécute chaque partie de pptx-viewer (navigateur / Node.js / Web Worker) et quels comportements propres à la plateforme découlent du bac à sable du navigateur plutôt que d'une fonctionnalité manquante.

Visionneuses pour frameworks (React, Vue 3, Angular, Svelte 5, Vanilla JS)

Le rendu basé sur CSS sacrifie quelques effets visuels au profit de la fidélité ailleurs

Les diapositives sont rendues en HTML/CSS plutôt qu'en Canvas, ce qui donne un texte net à tout niveau de zoom, une accessibilité native et l'interactivité du DOM. La contrepartie est que quelques effets de PowerPoint n'ont pas d'équivalent CSS exact et sont approximés.

Approximations d'effets visuels

Effet	Statut	Remarques
Formes et scènes 3D (a:sp3d / a:scene3d)	Résidu sur le métal	Les matériaux métalliques paraissaient délavés sous des éclairages à forte élévation ; la lumière spéculaire a désormais sa propre élévation plafonnée, réajustée sur 134 rendus PowerPoint (erreur absolue moyenne de 75,0 à 36,4 sur une échelle de 0-255), si bien qu'il reste un résidu plus faible. La correction des biseaux relaxedInset/slope/hardEdge du 2026-09-16 n'a pas encore été revérifiée sur un nouveau rendu PowerPoint. Voir Fidélité des effets visuels pour la provenance.
Déformations d'enveloppe WordArt (inflate / deflate / can / slant / fade / cascade / ...)	Préréglages can inexacts à certaines profondeurs	Les glyphes sont placés selon la longueur d'arc le long des courbes supérieure et inférieure. Mesuré à nouveau face au Slide.Export de PowerPoint (1920 px de large, Noto Sans, Verdana et Arial, 2026-09-25) : les préréglages can atteignent un IoU d'encre de 0,94-0,97 avec une erreur de contour moyenne de 0,8-1,7 px (95e centile 1,5-6 px) à la plupart des profondeurs, et inflate / deflate 0,96-0,97. Pour 9 des 20 valeurs adj balayées (textCanUp 80000-93333, textCanDown 3333-23333), PowerPoint arrête une ou deux lignes de texte environ 1,2 % de la largeur du cadre trop tôt et incline les glyphes ; ce comportement n'est pas modélisé (IoU de 0,73-0,86 dans ces cas). Les polices dont le fichier est introuvable utilisent un contour tracé à partir du rendu du navigateur, qui concorde avec le vrai fichier de police à 0,002 d'IoU près. Voir Fidélité des effets visuels.

Les réflexions, les bords adoucis et les dégradés de tracé sont aussi des approximations, mais tiennent bien la comparaison avec le vrai PowerPoint ; voir Fidélité des effets visuels pour la technique et les mesures COM qui étayent chacun d'eux.

Lacunes connues de rendu et d'édition (audit de 2026-09)

Un audit de septembre 2026 mené contre le vrai PowerPoint a relevé ces lacunes toujours ouvertes :

• Enregistrer une diapositive modifiée peut encore toucher des détails mineurs du balisage. Les équations, les sauts de ligne, la mise en forme héritée, les styles de texte du masque, les arrière-plans du thème, les horodatages des commentaires, les remplissages d'image, les actions au clic sur les médias, les langues et les propriétés des segments de texte, les segments ruby, les largeurs de contour, les couleurs d'ombre intérieure, les retraits de dégradé, les couleurs de puce sur une puce héritée, l'alignement de tabulation, les métadonnées d'animation et d'audio, et les graphiques non modifiés font désormais l'aller-retour, et docProps est actualisé à l'enregistrement comme le fait PowerPoint. Un <a:pPr/> vide, un <a:p/> nu, l'endParaRPr des notes et prstTxWarp/avLst survivent à une diapositive réécrite, et les décomptes de mots et de paragraphes dans docProps/app.xml sont recalculés à partir du texte des diapositives, des notes et de SmartArt comme PowerPoint les compte (vérifié via COM). Les diapositives non modifiées font l'aller-retour sans changement.
• Graphiques : les étiquettes extérieures de graphique en secteurs à la position bestFit qui se chevauchent sont écartées verticalement dans leur moitié du secteur, avec une ligne de repère vers chaque étiquette déplacée ; la règle d'espacement est une approximation, non mesurée via COM. La zone de traçage automatique d'un graphique en secteurs porte un retrait fixe de 6,7 px ajusté sur la taille de PowerPoint plutôt que mesuré, si bien qu'un graphique en secteurs peut encore différer d'un pixel ou deux.
• Les modèles 3D appliquent la caméra (perspective ou orthographique, position, vecteur haut, cible de visée, champ de vision), la transformation du modèle (échelle, rotation, post-translation, mètres par unité de modèle) et les lumières ambiante, ponctuelle, spot et directionnelle définies dans PowerPoint ; un modèle qui n'en a pas garde le cadrage et les lumières par défaut. Ce n'est pas encore vérifié sur des rendus PowerPoint : le sens de am3d:rot, le décalage am3d:preTrans (analysé, non appliqué), l'échelle orthographique, les unités d'intensité lumineuse et les angles de cône des spots sont au mieux approximatifs, et le modèle est centré sur sa boîte englobante plutôt que sur son origine d'origine.
• La couverture de l'éditeur est un sous-ensemble de celle de PowerPoint. Les galeries de styles du ruban (Shape Styles, Shape Effects, WordArt Styles, Picture Styles, les galeries Picture Format > Adjust Corrections, Color et Artistic Effects, les bibliothèques Bullets et Numbering, Table Styles, Chart Styles, Chart Colors et Quick Layout, SmartArt Styles et Change Colors, ainsi que Design > Variants Colors et Fonts) et les onglets contextuels Shape Format, Picture Format, Table Design, Chart Design et SmartArt Design sont disponibles dans les cinq liaisons ; les galeries Variants Effects et Background Styles et SmartArt Design > Layouts n'ont pas encore de galerie dans le ruban (la disposition SmartArt se définit depuis l'inspecteur). Modifier les points (avec les outils de dessin Forme libre : forme et Courbe), Fusionner les formes, le rognage d'image sur le canevas (poignées de rognage, Rogner selon les proportions, Remplissage, Ajuster), le Collage spécial, les menus contextuels du canevas vide et des éléments, la sélection multiple dans le volet des diapositives, un véritable aperçu des animations sur place et les raccourcis d'édition standard sont disponibles dans les cinq liaisons.

Pour aller plus loin

• Introduction - ce que le projet prend en charge dans son ensemble.
• Architecture - pourquoi ces compromis existent.
• Conformité OpenXML - la définition formelle de « pris en charge » utilisée par le manifeste de couverture.
• Fidélité des effets visuels - approximations d'effets CSS/SVG confirmées par rapport au vrai PowerPoint.
• @christophervr/ole2 - contient le writer .ppt et documente ses limites.
• Environnements d'exécution - où s'exécute chaque partie de pptx-viewer, et remarques de plateforme sur le bac à sable du navigateur.