Blocs intégrés
Intégrez du contenu modifiable dans un autre produit Office en conservant son éditeur natif.
Les blocs intégrés placent un produit Univer dans un autre. Un document de projet peut contenir des budgets et des tâches, une diapositive peut contenir un tableur de travail, et une toile peut présenter des plans avec des notes. Le contenu intégré conserve son propre modèle de données et son éditeur natif, activant ainsi le bloc déplace focus et menus vers l'unité enfant.
Principe : Unit hôte et Unit enfant
Le Unité hôte stocke l'emplacement et la taille du bloc, la référence à l'unité enfant, et la vue par défaut. Le Groupe de l ' enfance stocke les cellules, paragraphes ou enregistrements réels. Chargement d'un bloc résout cette référence, charge l'unité enfants, et monte son éditeur à l'intérieur de l'hôte. Un Unité peut être un cahier de travail, un document, une présentation, une table relationnelle, ou une toile.
La relation et le contenu sont maintenus séparément. Modifier une cellule dans un tableur intégré met à jour la feuille enfant. Déplacement ou redimensionnement du bloc met à jour l'ancre stockée dans l'hôte.
Emplacements pris en charge
| Produit hôte | Emplacement | Usage courant |
|---|---|---|
| Sheet | Objet flottant ou onglet du cahier de travail | Un bref à côté d'un modèle de calcul, ou une base de données de tâches sur un onglet séparé. |
| Doc | Bloc dans le corps | Narratif, budgets et tâches sur une page de projet. |
| Slide | Objet flottant ou page de présentation | Données de source modifiables à côté de la conclusion. |
| Relational Table | Entrée de la liste des tables | Documentation de projet qui reste dans une base de données d'affaires. |
| Canvases | Objet flottant sur le canevas | Données, propositions et discussion sur une seule toile. |
Cinq exemples d’hôtes
Les exemples ci-dessous ont été produits par le biais du Facade API et capturés dans un navigateur, de sorte que l'interface est en anglais. Chaque cas utilise des unités pour enfants indépendantes, et tous les contenus et les chiffres sont des données d'échantillon.
Sheet : calculs et note de décision
Le centre de contrôle totalise les dépenses à gauche et intègre un Doc complet à droite. Son onglet Tracker de lancement ouvre une Table Relationnelle. Cette disposition convient à la tarification, aux opérations et aux cahiers de travail financiers qui doivent garder des hypothèses, des calculs et une décision écrite en un seul endroit. L'équivalent le plus proche est insérer un objet document dans Excel.
Doc : une page projet avec budget et tâches
L'organisme contient une feuille de budget suivie d'une table relationnelle, de sorte que les lecteurs peuvent examiner le modèle et maintenir les tâches dans leur contexte. L'arrangement ressemble à Les bases de données en ligne de Notion, sauf que le budget fonctionne toujours sur le moteur de formule feuille et les tâches gardent les champs de Table relationnelle et les vues.
Slide : les données sources pendant la revue
Une diapositive contient une feuille de budget, une table de relation des tâches et une mesure budgétaire fondée sur la formule. L'interaction est comparable à intégration de Excel dans PowerPoint: les évaluateurs peuvent commencer à la conclusion et revenir à un modèle de données modifiable. Le budget illustré a été mis à jour à 62 100 $.
Relational Table : la note au sein de la base
Dans une base de données de CRM, de suivi de projet ou d'exploitation, cela permet aux gens de se déplacer entre le travail structuré et son contexte écrit. Il s'agit d'une entrée de liste de table, et il ne crée pas automatiquement un document pour chaque enregistrement.
Canvases : un espace de planification partagé
La toile combine une feuille de budget, une proposition Doc, et un résumé des dépenses axé sur la formule. Ceci convient aux salles de projet, aux revues et aux toiles de recherche qui nécessitent des données sources et le contexte à portée de main lors d'une discussion.
Comment les formules restent liées
L'insertion d'un bloc ne crée pas de formule de résumé, de sorte que les références croisées doivent être configurées en premier. Une fois qu'elles sont en place, les cellules de feuille et les formes sous forme de formule dans Doc, Slide et Canvas peuvent lire les plages de feuille ou les champs de table relationnelle, et les champs de formule de table relationnel peuvent également référencer une feuille. Lorsque les données sources et les notifications de modification sont disponibles, les modifications pertinentes déclenchent un nouveau calcul.
| Scénario et formule | Résultat vérifié |
|---|---|
Budget dans Slide : =SUM('[Leadership Budget]Budget'!C5:C8) | Passer C7 de 17,100 à 18,000 actualise le total de 61,200 → 62,100. |
Total Relational Table dans Sheet : =SUM([Control Tasks]!Launch_tasks[Cost]) | Passer un Cost de 4,000 à 4,500 actualise le total de 18,000 → 18,500. |
Utilisez getFormula().buildReference() pour générer une référence avec le mapping externe appartenant à l'hôte qu'il exige. Pour une table dans la table relationnelle, utilisez table.getFormulaName() au lieu de concaténer un nom d'affichage ou un ID. Formes sous forme de formule utilisent shape.setFormula({ formula, externalReferences }); lire le résultat après les calculs terminés. Voir Formule Façade, Façade de forme et Formules de tableau relationnel.
Création et intégration
Enregistrez le produit hôte, le produit enfant et leur interface utilisateur dans la même instance Univer, puis ajoutez Embed et Embed UI. L'exemple ci-dessous insère une feuille existante dans un corps Doc; hostDocument et budgetWorkbook sont les Facades correspondantes.
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() crée la relation et l'ancrage de l'hôte. loadAsync() charge l'unité enfant et retourne sa Facade. displayTarget sélectionne la feuille de travail initiale, la page de diapositive ou la vue de la table relationnelle. La guide d'intégration couvre les plugins, styles, locaux et chargeurs. Embed Facade couvre les autres surfaces et méthodes.
Persistance, collaboration et périmètre
- L'hôte Snapshot conserve les références, le placement et les paramètres d'affichage, mais il ne paquete pas automatiquement le dernier contenu enfant.
- Server SDK fournit des snapshots pour enfants et les services de collaboration qui les accompagnent. Avec
@univerjs-pro/collaboration-embed, le navigateur charge l'enfant et rejoint sa session de collaboration. - L'application résout les références, charge les données et autorise l'accès. Être en mesure d'ouvrir l'hôte n'accorde pas à lui seul des droits d'édition sur l'enfant.
- Les types Feuille, Doc, Diapositive, Table Relationnelle et Toiles peuvent être intégrés les uns dans les autres. PDF, emboîtage de même type, et nicher plus profondément sont exclus. Dans un seul runtime Univer, une unité enfant peut appartenir à un seul emboîtement actif.
Utilisez liaison bidirectionnelle pour piloter les entrées, les métriques et les graphiques de l'application à partir d'un tableur. Utilisez Embed Block lorsque vous avez besoin de l'éditeur du produit enfant.
Que pensez-vous de ce guide ?