Compartir a través de

Modelo de objetos de JavaScript en Word para Complementos de Office

  • Artículo

En este artículo se describen los conceptos fundamentales para usar la API de JavaScript de Word para crear complementos.

Importante

Consultar Usar el modelo de API específico de la aplicación para obtener información sobre la naturaleza asincrónica de las API de Word y cómo funcionan con el documento.

API Office.js para Word

Un complemento de Word interactúa con objetos de Word mediante la API de JavaScript de Office. Esto incluye dos modelos de objetos de JavaScript:

  • API de JavaScript de Word: La API de JavaScript de Word ofrece objetos de tipo inflexible que se pueden usar para acceder al documento, los rangos, las tablas, las listas, los formatos y mucho más.

  • API comunes: se pueden usar las API comunes para acceder a características como la interfaz de usuario, los cuadros de diálogo y la configuración del cliente, que son comunes a varios tipos de aplicaciones de Office.

Aunque probablemente usará la API de JavaScript de Word para desarrollar la mayor parte de la funcionalidad en los complementos destinados a Word, también usará objetos en la API compartida. Por ejemplo:

  • Office.Context: el Context objeto representa el entorno en tiempo de ejecución del complemento y proporciona acceso a objetos clave de la API. Consta de los detalles de configuración del documento como contentLanguage y officeTheme, y también proporciona información sobre el entorno runtime del complemento, como host y platform. Además, proporciona el requirements.isSetSupported() método , que puede usar para comprobar si la aplicación de Word donde se ejecuta el complemento admite un conjunto de requisitos especificado.
  • Office.Document: el Office.Document objeto proporciona el getFileAsync() método , que puede usar para descargar el archivo Word donde se ejecuta el complemento. Esto es independiente del Word. Objeto Document.

Diferencias entre la API de JS para Word y las API comunes.

Modelo de objetos específico de Word

Para comprender las API de Word, debe comprender cómo se relacionan entre sí los componentes de un documento.

  • El Documento contiene las Secciones y entidades del nivel de documento, como la configuración y los elementos XML personalizados.
  • Una Sección contiene un Cuerpo.
  • Un Cuerpo da acceso a los objetos del Párrafo, de ContentControl y de Rango, entre otros.
  • Un Rango representa un área de contenido contigua, incluido el texto, el espacio en blanco, las Tablasy las imágenes. También contiene la mayoría de los métodos de manipulación de texto.
  • Una Lista representa texto en una lista numerada o con viñetas.

Vea también