Bloques incrustados

Inserta contenido editable en otro producto Office conservando su editor nativo.

Los bloques insertados colocan un producto Univer dentro de otro. Un documento de proyecto puede contener presupuestos y tareas, una diapositiva puede llevar una hoja de cálculo de trabajo, y un lienzo puede presentar planes junto con notas. El contenido integrado mantiene su propio modelo de datos y su editor nativo, así que activar el bloque mueve enfoque y menús a la unidad infantil.

Principio: Unit anfitriona y Unit hija

El Unidad de acogida almacena la colocación y el tamaño del bloque, la referencia a la unidad infantil y la vista predeterminada. El Dependencia de la Infancia guarda las celdas, párrafos o registros reales. Carga un bloque resuelve esa referencia, carga la unidad infantil, y monta su editor dentro del host. Un Dependencia puede ser un libro de trabajo, un documento, una presentación, una tabla relacional, o un lienzo.

100%

La relación y el contenido se persisten por separado. Editar una célula en una hoja de cálculo incrustada actualiza la hoja de niño. Moviendo o redimensionando el bloque actualiza el ancla almacenado en el host.

Ubicaciones compatibles

Producto anfitriónUbicaciónUso habitual
SheetObjeto flotante o una pestaña de libro de trabajoUn breve junto a un modelo de cálculo, o una base de datos de tareas en una pestaña separada.
DocBloque del cuerpoNarrative, budgets, and tasks on one project page.
SlideObjeto flotante o página de presentaciónDatos de origen editables al lado de la conclusión.
Relational TableEntrada de la lista de tablasDocumentación del proyecto que permanece dentro de una base de datos de negocios.
CanvasesObjeto flotante en el lienzoDatos, propuestas y discusión sobre un único lienzo.

Cinco ejemplos de anfitrión

Los ejemplos a continuación fueron producidos a través de Facade API y capturados en un navegador, por lo que la interfaz está en inglés. Cada caso utiliza unidades infantiles independientes, y todos los contenidos y figuras son datos de muestra.

Sheet: cálculos y un informe de decisión

El centro de control total gasta a la izquierda e incorpora un Doc completo a la derecha. Su pestaña de rastreador de lanzamiento abre una Tabla de Relación. Esta disposición se adapta a los precios, operaciones y libros de trabajo financieros que deben mantener suposiciones, cálculos y una decisión escrita en un solo lugar. El equivalente más cercano es insertar un objeto de documento en Excel.

Doc: una página de proyecto con presupuesto y tareas

El cuerpo contiene una hoja presupuestaria seguida de una Tabla de Relación, por lo que los lectores pueden examinar el modelo y mantener tareas en contexto. El arreglo se asemeja a Bases de datos en línea de Noción, excepto que el presupuesto todavía funciona en el motor de fórmula de hoja y las tareas mantienen campos y puntos de vista de tabla relacional.

Slide: datos fuente durante la revisión

Una diapositiva lleva una hoja presupuestaria, una tabla de relaciones y una métrica de presupuesto impulsada por fórmulas. La interacción es comparable a incrustaciones Excel en PowerPoint: los revisores pueden comenzar desde la conclusión y volver a un modelo de datos editable. El presupuesto ilustrado ha sido actualizado a $62,100.

Relational Table: documentación dentro de la base

Un breve Lanzamiento Doc se sienta al lado de la tabla de tareas en la lista de tablas. En una base de datos CRM, rastreador de proyectos o operaciones, esto permite a la gente moverse entre el trabajo estructurado y su contexto escrito. Esta es una entrada de lista de tabla, y no crea automáticamente un documento para cada registro.

Canvases: un espacio de planificación compartido

El lienzo combina una hoja presupuestaria, una propuesta Doc, y un resumen de gasto basado en fórmulas. Esto se adapta a las salas de proyectos, revisiones y lienzos de investigación que necesitan datos fuente y contexto a mano durante una discusión.

Cómo se conectan las fórmulas

La inserción de un bloque no crea una fórmula sumaria, por lo que las referencias transversales deben configurarse primero. Una vez que estén en su lugar, las células de hoja y las formas impulsadas por fórmulas en Doc, Slide y Canvases pueden leer rangos de hoja o campos de tabla relacional, y los campos de fórmulas de tabla de relacional también pueden hacer referencia a una hoja.

100%
Escenario y fórmulaResultado verificado
Presupuesto en Slide: =SUM('[Leadership Budget]Budget'!C5:C8)Cambiar C7 de 17,100 a 18,000 actualiza el total de 61,200 → 62,100.
Total de Relational Table en Sheet: =SUM([Control Tasks]!Launch_tasks[Cost])Cambiar un Cost de 4,000 a 4,500 actualiza el total de 18,000 → 18,500.

Los nombres de las Fórmulas sirven como calificadores legibles, y una integración también debe persistir los IDs de Unidad estables detrás de ellos. getFormula().buildReference() para generar una referencia junto con la cartografía externa de propiedad de host que requiere. Para una tabla en Tabla de Relación, utilice table.getFormulaName() en lugar de concatenar un nombre de pantalla o ID. shape.setFormula({ formula, externalReferences }); leer el resultado después de completar el cálculo. Fórmula Facade, Shape Facade y Fórmulas de tablas relacionales.

Creación e integración

Registrar el producto anfitrión, el producto del niño y su interfaz de usuario en la misma instancia Univer, luego añadir Embed y Embed UI. El ejemplo a continuación inserta una hoja existente en un cuerpo Doc; hostDocument y budgetWorkbook son las Facades correspondientes.

TypeScript
import '@univerjs-pro/embed/facade'const block = univerAPI.createEmbed({  host: {    unitId: hostDocument.getId(),    surface: univerAPI.Enum.FEmbedHostSurface.DocBlock,  },  content: {    unitType: univerAPI.Enum.UniverInstanceType.UNIVER_SHEET,    ref: `#unit=${encodeURIComponent(budgetWorkbook.getId())}&type=sheet`,  },})const embeddedWorkbook = await block.loadAsync()

createEmbed() crea la relación y el ancla anfitriona. loadAsync() carga al niño Unidad y devuelve su Facade. displayTarget selecciona la hoja de trabajo inicial, página de diapositivas, o vista de tabla relacional. El guía de la incrustación cubre plugins, estilos, locales y cargadores. Embed Facade cubre las otras superficies y métodos.

Persistencia, colaboración y alcance

  • El host Snapshot mantiene las referencias, la colocación y la configuración de visualización, pero no empaqueta el último contenido del niño automáticamente. La eliminación de un bloque no elimina el documento del niño.
  • Server SDK ofrece instantáneas infantiles y los servicios de colaboración que los acompañan. Con @univerjs-pro/collaboration-embed, el navegador carga al niño y se une a su sesión de colaboración.
  • La aplicación resuelve referencias, carga datos y autoriza el acceso. Ser capaz de abrir el host no otorga por sí mismo derechos de edición sobre el niño.
  • Los tipos de Hoja, Doc, Diapositiva, Tabla Relacional y Canvasas se pueden incrustar entre sí. PDF, incrustación del mismo tipo, y anidación más profunda están excluidos. Dentro de un tiempo de ejecución Univer, una unidad infantil puede pertenecer a sólo una incrustación activa.

Utilice dos vías vinculantes para conducir las propias entradas, métricas y gráficos de la aplicación desde una hoja de cálculo. Use Embed Block cuando necesite el editor del producto del niño.

Volver a funciones

¿Cómo es esta guía?

© 2026 DreamNum Co., Ltd.