Buscar y reemplazar

La función Buscar y reemplazar permite a los usuarios buscar rápidamente contenido específico en hojas de cálculo y reemplazarlo, admitiendo varias opciones de coincidencia para ayudar a los usuarios a procesar datos de manera eficiente.

Abra el panel de búsqueda y reemplazo en el ejemplo completo de plugins siguiente para probar esta función.

Complemento Modo

Instalación

Shell
pnpm add @univerjs/find-replace @univerjs/sheets-find-replace

Uso

TypeScript
import { LocaleType, mergeLocales, Univer } from '@univerjs/core'import { UniverFindReplacePlugin } from '@univerjs/find-replace'import FindReplaceEnUS from '@univerjs/find-replace/locale/en-US'import { UniverSheetsFindReplacePlugin } from '@univerjs/sheets-find-replace'import '@univerjs/find-replace/lib/index.css'import '@univerjs/sheets-find-replace/facade'const univer = new Univer({  locale: LocaleType.EN_US,  locales: {    [LocaleType.EN_US]: mergeLocales(      FindReplaceEnUS,     ),  },})univer.registerPlugin(UniverFindReplacePlugin)univer.registerPlugin(UniverSheetsFindReplacePlugin)

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.

PaqueteRegistro de escritorioRegistro móvil
@univerjs/find-replaceUniverFindReplacePluginUniverFindReplaceMobileUIPlugin
@univerjs/sheets-find-replaceUniverSheetsFindReplacePluginUniverSheetsFindReplaceMobileUIPlugin

Modo preestablecido

Instalación

Shell
pnpm add @univerjs/preset-sheets-find-replace

Uso

TypeScript
import { UniverSheetsCorePreset } from '@univerjs/preset-sheets-core'import UniverPresetSheetsCoreEnUS from '@univerjs/preset-sheets-core/locales/en-US'import { UniverSheetsFindReplacePreset } from '@univerjs/preset-sheets-find-replace'import UniverPresetSheetsFindReplaceEnUS from '@univerjs/preset-sheets-find-replace/locales/en-US'import { createUniver, LocaleType, mergeLocales } from '@univerjs/presets'import '@univerjs/preset-sheets-core/lib/index.css'import '@univerjs/preset-sheets-find-replace/lib/index.css'const { univerAPI } = createUniver({  locale: LocaleType.EN_US,  locales: {    [LocaleType.EN_US]: mergeLocales(      UniverPresetSheetsCoreEnUS,      UniverPresetSheetsFindReplaceEnUS,     ),  },  presets: [    UniverSheetsCorePreset(),    UniverSheetsFindReplacePreset(),   ],})

API de Facade

Las definiciones completas del tipo de API de Facade se pueden encontrar en FacadeAPI.

Importación

Plugin mode note

Solo el modo complemento requiere importar manualmente el paquete Facade. El modo preestablecido ya incluye el paquete Facade correspondiente, por lo que no se necesita ninguna importación adicional.

TypeScript
import '@univerjs/sheets-find-replace/facade'

Crear buscador de texto

univerAPI.createTextFinderAsync() crea un buscador de texto y devuelve una instancia FTextFinder.

Aquí se muestran algunos métodos de miembros FTextFinder:

MétodoDescripción
findAllObtener todas las celdas coincidentes de la hoja actual, la celda coincidente actual es la última celda coincidente
findNextObtener la siguiente celda coincidente de la hoja actual, si existe, devolver la siguiente celda coincidente y mover la celda coincidente actual a la siguiente celda coincidente
findPreviousObtener la celda coincidente anterior de la hoja actual, si existe, devolver la celda coincidente anterior y mover la celda coincidente actual a la celda coincidente anterior celda
getCurrentMatchObtener la celda coincidente actual de la hoja actual
matchCaseAsyncEstablezca la opción de coincidencia de mayúsculas y minúsculas; si es verdadero, la operación de búsqueda coincidirá con mayúsculas y minúsculas; de lo contrario, la operación de búsqueda ignorará las mayúsculas y minúsculas
matchEntireCellAsyncEstablezca la opción de coincidir con toda la celda; si es verdadero, la operación de búsqueda coincidirá con el valor completo de la celda; de lo contrario, la operación de búsqueda coincidirá con parte del valor de la celda
matchFormulaTextAsyncEstablezca la opción de coincidir con el texto de la fórmula; si es verdadero, la operación de búsqueda coincidirá con el texto de la fórmula; de lo contrario, la operación de búsqueda coincidirá valor
replaceAllWithAsyncReemplazar todo el texto coincidente con el texto dado
replaceWithAsyncReemplazar el texto coincidente actual con el texto dado
ensureCompleteAsyncAsegúrese de que se complete la operación de búsqueda. Especialmente cuando se cambia la hoja actual, utilice este método para garantizar que se complete la operación de búsqueda
TypeScript
// Assume the current sheet is empty sheet.const fWorkbook = univerAPI.getActiveWorkbook()const fWorksheet = fWorkbook.getActiveSheet()// Set some values to the range A1:D10.const fRange = fWorksheet.getRange('A1:D10')fRange.setValues([  [1, 2, 3, 4],  [2, 3, 4, 5],  [3, 4, 5, 6],  [4, 5, 6, 7],  [5, 6, 7, 8],  [6, 7, 8, 9],  [7, 8, 9, 10],  [8, 9, 10, 11],  [9, 10, 11, 12],  [10, 11, 12, 13],])// Create a text-finder to find the text '5'.const textFinder = await univerAPI.createTextFinderAsync('5')// Find all cells that contain the text '5'.const matchCells = textFinder.findAll()matchCells.forEach((cell) => {  cell.getA1Notation() // D2, C3, B4, A5})

¿Cómo es esta guía?

© 2026 DreamNum Co., Ltd.