Conceptos básicos
Conozca los plugins, instantáneas, comandos y API de Facade de Univer Sheets. Para crear un editor, continúe con la instalación y el uso básico.
Conceptos básicos
Antes de profundizar en Univer, lea este documento para comprender los conceptos básicos de Univer, que le ayudarán a utilizar Univer con mayor fluidez.
Los conceptos básicos incluyen:
- Complemento
- Instantánea
- Comando
- API de Fachada
Complementos
Todas las características de Univer son proporcionadas por complementos, que son los básicos bloques de construcción de la Universidad. Varios complementos combinados forman una aplicación Univer.
Las responsabilidades de los complementos incluyen:
- Implementar características, como
@univerjs/sheets-filterproporciona funcionalidad de filtrado. - Proporcionar algunas capacidades básicas, como
@univerjs/engine-renderproporciona capacidades de renderizado.
Puede combinar los complementos de Univer para personalizar una aplicación Univer que cumpla con sus requisitos y evite cargar código innecesario. También puede ampliar la funcionalidad de Univer escribiendo complementos para satisfacer necesidades personalizadas.
Enlaces relacionados
- Escribir un complemento de importación CSV para aprender a escribir un complemento.
- Arquitectura de Univer para obtener más información sobre el diseño arquitectónico de Univer.
Instantánea
Debe cargar una instantánea en Univer para cargar un documento. Cada tipo de documento proporciona su propio formato de instantánea. Consulte la documentación API anterior para aprender cómo escribir una instantánea que cumpla con los requisitos de formato:
- El formato de instantánea de una hoja de cálculo es
IWorkbookData. - El formato de instantánea de un documento es
IDocumentData.
Funcional Los complementos pueden almacenar recursos, como imágenes, etc., a través del campo resources. Para obtener más información, consulte Complemento de modelo personalizado.
Caution
¡Nota! La instantánea de Univer solo se utiliza para almacenar datos. ¡No refleja el último estado del documento en tiempo de ejecución! Si desea guardar el estado del documento como una instantánea, utilice el método para guardar la instantánea en la API de Facade.
Comando
En Univer, todas las modificaciones de datos deben ejecutarse mediante comandos. El enfoque basado en comandos puede realizar un mejor seguimiento de los cambios en los valores, implementar funciones como deshacer, rehacer y edición colaborativa, manejar una lógica asociada compleja entre funciones, etc.
Si desea modificar los datos del documento mediante comandos, consulte Cómo encontrar el ID del comando. Si elige modificar los datos del documento a través de la API de Facade, la API de Facade preparará los parámetros para usted y ejecutará comandos detrás de escena.
Caution
¡No modifique la instantánea directamente! Esto no tendrá efecto y no activará la actualización de las vistas o la interfaz de usuario. Modifique los datos mediante comandos o la API de Facade.
API de Facade
Debido a la alta complejidad de las aplicaciones de oficina, la arquitectura de Univer también es muy compleja. Para facilitar el uso de Univer a los desarrolladores, proporcionamos la API de Facade, que es un contenedor para los complementos propios de Univer, que proporciona interfaces más simples que facilitan a los desarrolladores el uso de Univer.
La API de Facade se está mejorando activamente. Si tiene alguna pregunta o requisito, envíe un problema en GitHub.
La API Facade es una API de alto nivel que abstrae los detalles subyacentes. Si bien simplifica las tareas comunes, las características complejas pueden requerir comprender la arquitectura de Univer y usar la API de bajo nivel directamente.
Enlaces relacionados
Modo preset y modo plugin
Un preset agrupa plugins preconfigurados. Ambos modos ofrecen las mismas capacidades si incluyen los mismos plugins. Los presets simplifican la configuración; el modo plugin permite controlar la composición y la carga.
Mantenga versiones compatibles entre todas las dependencias de Univer. No vuelva a registrar un plugin que ya esté incluido en un preset.
| Modo plugin | Modo preset |
|---|---|
| Importar explícitamente las extensiones Facade | Extensiones Facade incluidas |
| Controlar el orden de registro | El preset gestiona sus plugins |
| Cargar plugins cuando se necesiten | Cargar los presets configurados al inicializar |
¿Cómo es esta guía?