Поиск и замена

Найти и заменить поиск текста в листе и заменить его.Параметры сопоставления контролируют, насколько строго соответствует поиск.

Используйте панель поиска и замены в полном примере плагина ниже, чтобы попробовать эту функцию.

Режим плагина

Установка

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

Использование

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)

Поддержка мобильных устройств

Сначала установите Мобильный редактор. В настройке плагин-режима на этой странице замените регистрацию рабочего стола ниже на мобильный экспорт из тех же пакетов, и сделайте это Перед тем, как открыть документ, сохраните плагины модели, стили, локализации и импорт Facade такими, какие они есть, и не регистрируйте оба варианта.

ПакетНастольная регистрацияМобильная регистрация
@univerjs/find-replaceUniverFindReplacePluginUniverFindReplaceMobileUIPlugin
@univerjs/sheets-find-replaceUniverSheetsFindReplacePluginUniverSheetsFindReplaceMobileUIPlugin

Режим предустановки

Установка

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

Использование

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(),   ],})

Facade API

Полные определения типов Facade API приведены в разделе FacadeAPI.

Импорт

Заметка о режиме плагина

Пакет Facade требует ручного импорта только в режиме плагина. Предустановленный режим уже связывает соответствующий пакет Facade.

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

Создание средства поиска текста

Позвоните univerAPI.createTextFinderAsync(), чтобы создать текстовый искатель. Он возвращает экземпляр FTextFinder.

В таблице ниже перечислены некоторые из методов на FTextFinder.

МетодОписание
findAllВозвращает каждый матч в текущем листе. Текущий матч переходит в последний матч.
findNextПереключается на следующий матч в текущем листе и возвращает его, если он существует.
findPreviousПерейдите к предыдущему матчу в текущем листе и верните его, если он существует.
getCurrentMatchВозвращает текущий матч в текущий лист.
matchCaseAsyncУстанавливает вариант спичечного случая. Когда это правда, поиск чувствителен к случаю; в противном случае он игнорирует случай.
matchEntireCellAsyncУстанавливает опцию цельной ячейки. Когда это верно, поиск соответствует только полному значению ячейки; в противном случае он может соответствовать части значения.
matchFormulaTextAsyncУстанавливает опцию формула-текст. Когда это верно, поиск исследует текст формулы; в противном случае он исследует значения.
replaceAllWithAsyncЗаменяет каждое совпадение данным текстом.
replaceWithAsyncЗаменяет текущее соответствие данным текстом.
ensureCompleteAsyncУбедиться, что операция по поиску завершена. Это важно после изменения текущего листа.
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})

Насколько полезно это руководство?

© 2026 DreamNum Co., Ltd.