Limitaciones

Lea esto antes de adoptar la biblioteca

pptx-viewer cubre una gran parte de la especificación OpenXML, pero algunas cosas se aproximan, son de solo lectura o están limitadas por la plataforma del navegador. Esta página recoge las limitaciones conocidas; no es una garantía exhaustiva de compatibilidad con cada función de Office o extensión de terceros. Revise data.warnings después de cargar una presentación y consulte Conformidad OpenXML para el manifiesto formal de cobertura.

Motor principal (pptx-viewer-core)

Función	Estado	Notas
Diseño de SmartArt	Aproximado sin dibujo en caché	Las presentaciones guardadas sin el dsp:drawing en caché se maquetan con un motor DiagramML por punto (143 diseños) o con el intérprete por familias más antiguo. Frente a 229 fixtures de la galería creados mediante COM, 228 producen el mismo conjunto de formas que PowerPoint, 143 coinciden con su geometría con un margen del 1 % (181 con un margen del 5 %) y 129 coinciden en todos los tamaños de fuente. Siguen siendo inexactos Name and Title Organization Chart, las jerarquías etiquetadas y de tabla, los organigramas horizontales con asistentes y tres diseños (Arrow Ribbon, Balance, Varying Width List). Consulte Conformidad OpenXML para ver las mediciones.

Creación de animaciones

Un efecto creado en el panel de animación se integra en el árbol p:timing existente de la diapositiva; los efectos propios de la presentación se conservan idénticos byte a byte. Carencias conocidas:

• Las direcciones cubren solo las variantes de borde y esquina. Cada efecto de entrada y salida se guarda con el propio árbol de comportamiento de PowerPoint para su preajuste y dirección; al cambiar el preajuste o la dirección de un efecto existente, ese árbol se reconstruye, y una nueva duración reajusta sus tiempos (reabierto en PowerPoint mediante COM, su propia representación coincide fotograma a fotograma con los efectos creados en PowerPoint). El selector de dirección ofrece exactamente las variantes que tiene PowerPoint: las ocho para Desplazar hacia dentro y Arrastrar, los cuatro bordes para Barrido, Asomar y Estirar. Dividir, Zoom, Persianas y las revelaciones de forma mantienen su variante predeterminada, Flotar hacia dentro no tiene dirección (Flotar hacia arriba y Flotar hacia abajo son preajustes distintos), y Parpadear es una aproximación.
• Algunos preajustes se aproximan al reproducirse. Los efectos de entrada y salida reproducen el propio árbol de comportamiento de la presentación: sus fórmulas, la temporización y la aceleración de cada comportamiento, las trayectorias de movimiento a ritmo constante a lo largo de su longitud, los desvanecimientos y los barridos, de modo que Desplazar hacia dentro empieza justo fuera del borde de la diapositiva, como en PowerPoint. Comparada fotograma a fotograma con la representación CreateVideo de PowerPoint de 116 variantes de preajuste y dirección (una forma de 200 pt durante 2 s), la forma visible queda en promedio a unos 15 px de la de PowerPoint; Girar y Giro desvanecido solo difieren en el instante en que su anchura pasa por cero, y Arco hacia arriba se desvía hasta 75 px al comienzo de su curva. Todavía aproximados: Máquina de escribir en color reproduce un efecto sustituto, las salidas Cuadro, Círculo, Rombo y Más respetan su dirección Entrada/Salida (Salida abre un hueco en el centro que crece hasta los bordes), pero solo a partir del token de filtro o de presetSubtype 32, y los efectos de énfasis usan fotogramas clave de preajuste.
• Compatibilidad parcial: un p14:bounceEnd del 100 % (sin recorrido restante, algo que el propio PowerPoint representa de forma errática) se limita al 95 %. Los desencadenadores de marcadores multimedia ("Al llegar al marcador"), las transiciones p15 con sus opciones de dirección y la dirección Acercar/Alejar de la transición Zoom se pueden crear en los cinco enlaces, y la curva de asentamiento de "Rebote final" está ajustada a los fotogramas del propio PowerPoint.

Detectar carencias en tiempo de ejecución

No hace falta adivinar si un archivo se ha topado con una limitación. La canalización de carga informa de muchas construcciones no compatibles o aproximadas (no de todas: los efectos de animación sustitutos, por ejemplo, no generan ninguna advertencia) en data.warnings, con el tipo 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
}

Revise data.warnings después de load() (y después de save()) si su aplicación necesita mostrar avisos de fidelidad a los usuarios o habilitar funciones según el archivo.

Consulte Entornos de ejecución para saber dónde se ejecuta cada parte de pptx-viewer (navegador / Node.js / Web Worker) y qué comportamientos específicos de la plataforma se deben al entorno aislado del navegador y no a una función ausente.

Visores para frameworks (React, Vue 3, Angular, Svelte 5, Vanilla JS)

El renderizado basado en CSS sacrifica algunos efectos visuales a cambio de fidelidad en otros aspectos

Las diapositivas se renderizan como HTML/CSS en lugar de Canvas, lo que ofrece texto nítido con cualquier zoom, accesibilidad nativa e interactividad del DOM. La contrapartida es que algunos efectos de PowerPoint no tienen un equivalente exacto en CSS y se aproximan.

Aproximaciones de efectos visuales

Efecto	Estado	Notas
Formas y escenas 3D (a:sp3d / a:scene3d)	Error residual en el metal	Los materiales metálicos antes se veían desvaídos con esquemas de iluminación de elevación alta; la luz especular tiene ahora su propia elevación limitada, reajustada frente a 134 renderizados de PowerPoint (error absoluto medio de 75,0 a 36,4 en una escala de 0-255), de modo que queda un residuo menor. La corrección de biseles relaxedInset/slope/hardEdge del 2026-09-16 aún no se ha vuelto a verificar frente a un renderizado nuevo de PowerPoint. Consulte Fidelidad de efectos visuales para ver su procedencia.
Deformaciones de envolvente de WordArt (inflate / deflate / can / slant / fade / cascade / ...)	Preajustes can inexactos en algunas profundidades	Los glifos se colocan por longitud de arco a lo largo de las curvas superior e inferior. Medido de nuevo frente a Slide.Export de PowerPoint (1920 px de ancho, Noto Sans, Verdana y Arial, 2026-09-25): los preajustes can obtienen un IoU de tinta de 0,94-0,97 con un error de contorno medio de 0,8-1,7 px (percentil 95: 1,5-6 px) en la mayoría de las profundidades, e inflate / deflate 0,96-0,97. En 9 de 20 valores de adj barridos (textCanUp 80000-93333, textCanDown 3333-23333), PowerPoint termina una o ambas filas de texto aproximadamente un 1,2 % del ancho del cuadro antes e inclina los glifos; esto no está modelado (IoU 0,73-0,86 en esos casos). Las fuentes cuyo archivo no se puede obtener usan un contorno trazado a partir del propio renderizado del navegador, que coincide con el archivo de fuente real con una diferencia de 0,002 de IoU. Consulte Fidelidad de efectos visuales.

Los reflejos, los bordes suaves y los degradados de trazado también son aproximaciones, pero se sostienen bien frente a PowerPoint real; consulte Fidelidad de efectos visuales para conocer la técnica y las mediciones por COM que respaldan cada uno.

Carencias conocidas de renderizado y edición (auditoría de 2026-09)

Una auditoría de septiembre de 2026 frente a PowerPoint real encontró estas carencias que siguen abiertas:

• Guardar una diapositiva editada todavía puede alterar detalles menores del marcado. Las ecuaciones, los saltos de línea, el formato heredado, los estilos de texto del patrón, los fondos del tema, las marcas de tiempo de los comentarios, los rellenos de imagen, las acciones de clic en elementos multimedia, los idiomas y las propiedades de los fragmentos de texto, los fragmentos ruby, los anchos de contorno, los colores de las sombras interiores, las sangrías de los degradados, los colores de viñeta sobre una viñeta heredada, la alineación de tabulación, los metadatos de animación y audio, y los gráficos sin modificar se conservan en el ciclo de ida y vuelta, y docProps se actualiza al guardar tal como hace PowerPoint. Un <a:pPr/> vacío, un <a:p/> sin contenido, el endParaRPr de las notas y prstTxWarp/avLst se conservan en una diapositiva reescrita, y los recuentos de palabras y párrafos en docProps/app.xml se recalculan a partir del texto de las diapositivas, las notas y SmartArt tal como los cuenta PowerPoint (verificado mediante COM). Las diapositivas no editadas se conservan intactas.
• Gráficos: las etiquetas exteriores de un gráfico circular en la posición bestFit que se solapan se separan verticalmente dentro de su lado del gráfico, con una línea guía hacia cada etiqueta desplazada; la regla de espaciado es una aproximación, no medida mediante COM. El área de trazado automática del gráfico circular lleva un margen interior fijo de 6,7 px ajustado al tamaño de PowerPoint en lugar de medido, por lo que un gráfico circular aún puede diferir en un píxel o dos.
• Los modelos 3D aplican la cámara (perspectiva u ortográfica, posición, vector superior, objetivo de mira, campo de visión), la transformación del modelo (escala, rotación, post-traslación, metros por unidad del modelo) y las luces ambientales, puntuales, de foco y direccionales definidas en PowerPoint; un modelo sin ellas conserva el encuadre y las luces predeterminados. Esto aún no está verificado frente a renderizados de PowerPoint: la lateralidad de am3d:rot, el desplazamiento am3d:preTrans (se analiza, no se aplica), la escala ortográfica, las unidades de intensidad de luz y los ángulos de cono de los focos son de mejor esfuerzo, y el modelo se centra en su caja delimitadora y no en su origen definido.
• La cobertura del editor es un subconjunto de la de PowerPoint. Las galerías de estilos de la cinta (Estilos de forma, Efectos de forma, Estilos de WordArt, Estilos de imagen, las galerías Correcciones, Color y Efectos artísticos de Formato de imagen > Ajustar, las bibliotecas de Viñetas y Numeración, Estilos de tabla, Estilos de gráfico, Cambiar colores de gráfico y Diseño rápido, Estilos de SmartArt y Cambiar colores, y los Colores y Fuentes de Diseño > Variantes) y las pestañas contextuales Formato de forma, Formato de imagen, Diseño de tabla, Diseño de gráfico y Diseño de SmartArt están disponibles en los cinco enlaces; las galerías Efectos de Variantes y Estilos de fondo y SmartArt Diseño > Diseños aún no tienen galería en la cinta (el diseño de SmartArt se define desde el inspector). Modificar puntos (con las herramientas de dibujo Forma libre: forma y Curva), Combinar formas, el recorte de imágenes sobre el lienzo (controladores de recorte, Recortar a la relación de aspecto, Rellenar, Ajustar), Pegado especial, los menús contextuales del lienzo vacío y de los elementos, la selección múltiple en el panel de diapositivas, una vista previa real de animaciones en su sitio y los atajos de edición habituales están disponibles en los cinco enlaces.

Lecturas relacionadas

• Introducción - lo que admite el proyecto en general.
• Arquitectura - por qué existen estas concesiones.
• Conformidad OpenXML - la definición formal de "compatible" que utiliza el manifiesto de cobertura.
• Fidelidad de efectos visuales - aproximaciones de efectos CSS/SVG confirmadas frente a PowerPoint real.
• @christophervr/ole2 - contiene el escritor de .ppt y documenta sus límites.
• Entornos de ejecución - dónde se ejecuta cada parte de pptx-viewer y notas de plataforma sobre el entorno aislado del navegador.