Llamada
La función de llamada le permite resaltar información importante en un documento con bloques visualmente distintos, completos con íconos y colores personalizables.
Introducción
En Univer Docs, los bloques de llamada le permiten:
- Resaltar información clave: llamar la atención sobre notas, advertencias o consejos importantes.
- Personalizar la apariencia: elija entre diferentes íconos y combinaciones de colores para que coincidan con su contenido.
- Organiza el contenido: estructura tu documento con secciones separadas visualmente.
Modo de complemento
Instalación
pnpm add @univerjs-pro/docs-callout @univerjs-pro/docs-callout-uinpm install @univerjs-pro/docs-callout @univerjs-pro/docs-callout-uiyarn add @univerjs-pro/docs-callout @univerjs-pro/docs-callout-uibun add @univerjs-pro/docs-callout @univerjs-pro/docs-callout-uiUso
import { UniverDocsCalloutPlugin } from '@univerjs-pro/docs-callout'import { UniverDocsCalloutUIPlugin } from '@univerjs-pro/docs-callout-ui'import DocsCalloutUIEnUS from '@univerjs-pro/docs-callout-ui/locale/en-US'import { LocaleType, mergeLocales, Univer } from '@univerjs/core'import '@univerjs-pro/docs-callout-ui/lib/index.css'const univer = new Univer({ locale: LocaleType.EN_US, locales: { [LocaleType.EN_US]: mergeLocales( DocsCalloutUIEnUS, ), },})univer.registerPlugin(UniverDocsCalloutPlugin)univer.registerPlugin(UniverDocsCalloutUIPlugin)Si tienes una licencia comercial de Univer, consulta Uso de la licencia en el cliente para la configuración.
Compatibilidad móvil
Configure primero el editor móvil. En la inicialización en modo plugin de esta página, sustituya los registros de escritorio siguientes por las exportaciones móviles de los mismos paquetes antes de abrir un documento. Conserve modelos, estilos, traducciones e importaciones Facade; no registre ambas variantes.
| Paquete | Registro de escritorio | Registro móvil |
|---|---|---|
@univerjs-pro/docs-callout-ui | UniverDocsCalloutUIPlugin | UniverDocsCalloutMobileUIPlugin |
API de fachada
Asegúrate de importar la fachada antes de usar el API:
import '@univerjs-pro/docs-callout/facade'Obtener todas las llamadas
const doc = univerAPI.getActiveDocument()const callouts = doc?.getCallouts() ?? []Obtener una llamada por ID
const doc = univerAPI.getActiveDocument()const callout = doc?.getCallout('callout-block-id')Insertar una llamada
const doc = univerAPI.getActiveDocument()const callout = doc?.insertCallout({ startOffset: 12, endOffset: 35, config: { icon: '💡' },})Actualizar configuración de llamada
const callout = univerAPI.getActiveDocument()?.getCallout('callout-block-id')callout?.updateConfig({ icon: '⚠️' })Establecer la apariencia de la llamada
const callout = univerAPI.getActiveDocument()?.getCallout('callout-block-id')callout?.setIcon('📝')callout?.setBackgroundColor('#FFF4E5')callout?.setBorder({ color: '#E6A23C', width: 2 })callout?.setTextColor('#5C3B00')Los cambios de apariencia de Callouts usan comandos del documento con deshacer/rehacer y colaboración. setTextColor() colorea todo el texto del bloque; resetTextColor() elimina esa sobrescritura y restaura los colores heredados del documento.
const callout = univerAPI.getActiveDocument()?.getCallout('callout-block-id')callout?.resetTextColor()¿Cómo es esta guía?