Поиск и замена
Найти и заменить поиск текста в листе и заменить его.Параметры сопоставления контролируют, насколько строго соответствует поиск.
Используйте панель поиска и замены в полном примере плагина ниже, чтобы попробовать эту функцию.
Режим плагина
Установка
pnpm add @univerjs/find-replace @univerjs/sheets-find-replacenpm install @univerjs/find-replace @univerjs/sheets-find-replaceyarn add @univerjs/find-replace @univerjs/sheets-find-replacebun add @univerjs/find-replace @univerjs/sheets-find-replaceИспользование
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-replace | UniverFindReplacePlugin | UniverFindReplaceMobileUIPlugin |
@univerjs/sheets-find-replace | UniverSheetsFindReplacePlugin | UniverSheetsFindReplaceMobileUIPlugin |
Режим предустановки
Установка
pnpm add @univerjs/preset-sheets-find-replacenpm install @univerjs/preset-sheets-find-replaceyarn add @univerjs/preset-sheets-find-replacebun add @univerjs/preset-sheets-find-replaceИспользование
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.
import '@univerjs/sheets-find-replace/facade'Создание средства поиска текста
Позвоните univerAPI.createTextFinderAsync(), чтобы создать текстовый искатель. Он возвращает экземпляр FTextFinder.
В таблице ниже перечислены некоторые из методов на FTextFinder.
| Метод | Описание |
|---|---|
| findAll | Возвращает каждый матч в текущем листе. Текущий матч переходит в последний матч. |
| findNext | Переключается на следующий матч в текущем листе и возвращает его, если он существует. |
| findPrevious | Перейдите к предыдущему матчу в текущем листе и верните его, если он существует. |
| getCurrentMatch | Возвращает текущий матч в текущий лист. |
| matchCaseAsync | Устанавливает вариант спичечного случая. Когда это правда, поиск чувствителен к случаю; в противном случае он игнорирует случай. |
| matchEntireCellAsync | Устанавливает опцию цельной ячейки. Когда это верно, поиск соответствует только полному значению ячейки; в противном случае он может соответствовать части значения. |
| matchFormulaTextAsync | Устанавливает опцию формула-текст. Когда это верно, поиск исследует текст формулы; в противном случае он исследует значения. |
| replaceAllWithAsync | Заменяет каждое совпадение данным текстом. |
| replaceWithAsync | Заменяет текущее соответствие данным текстом. |
| ensureCompleteAsync | Убедиться, что операция по поиску завершена. Это важно после изменения текущего листа. |
// 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})Насколько полезно это руководство?