| // Copyright 2014 The Chromium Authors. All rights reserved. |
| // Use of this source code is governed by a BSD-style license that can be |
| // found in the LICENSE file. |
| |
| import * as Common from '../../core/common/common.js'; |
| import * as Host from '../../core/host/host.js'; |
| import * as i18n from '../../core/i18n/i18n.js'; |
| import * as UI from '../../ui/legacy/legacy.js'; |
| |
| import searchViewStyles from './searchView.css.js'; |
| |
| import {SearchConfig, type SearchResult, type SearchScope} from './SearchConfig.js'; |
| import {SearchResultsPane} from './SearchResultsPane.js'; |
| |
| const UIStrings = { |
| /** |
| *@description Title of a search bar or tool |
| */ |
| search: 'Search', |
| /** |
| *@description Accessibility label for search query text box |
| */ |
| searchQuery: 'Search Query', |
| /** |
| *@description Text to search by matching case of the input |
| */ |
| matchCase: 'Match Case', |
| /** |
| *@description Text for searching with regular expressinn |
| */ |
| useRegularExpression: 'Use Regular Expression', |
| /** |
| *@description Text to refresh the page |
| */ |
| refresh: 'Refresh', |
| /** |
| *@description Text to clear content |
| */ |
| clear: 'Clear', |
| /** |
| *@description Search message element text content in Search View of the Search tab |
| */ |
| indexing: 'Indexing…', |
| /** |
| *@description Text to indicate the searching is in progress |
| */ |
| searching: 'Searching…', |
| /** |
| *@description Text in Search View of the Search tab |
| */ |
| indexingInterrupted: 'Indexing interrupted.', |
| /** |
| *@description Search results message element text content in Search View of the Search tab |
| */ |
| foundMatchingLineInFile: 'Found 1 matching line in 1 file.', |
| /** |
| *@description Search results message element text content in Search View of the Search tab |
| *@example {2} PH1 |
| */ |
| foundDMatchingLinesInFile: 'Found {PH1} matching lines in 1 file.', |
| /** |
| *@description Search results message element text content in Search View of the Search tab |
| *@example {2} PH1 |
| *@example {2} PH2 |
| */ |
| foundDMatchingLinesInDFiles: 'Found {PH1} matching lines in {PH2} files.', |
| /** |
| *@description Search results message element text content in Search View of the Search tab |
| */ |
| noMatchesFound: 'No matches found.', |
| /** |
| *@description Text in Search View of the Search tab |
| */ |
| searchFinished: 'Search finished.', |
| /** |
| *@description Text in Search View of the Search tab |
| */ |
| searchInterrupted: 'Search interrupted.', |
| }; |
| const str_ = i18n.i18n.registerUIStrings('panels/search/SearchView.ts', UIStrings); |
| const i18nString = i18n.i18n.getLocalizedString.bind(undefined, str_); |
| |
| export class SearchView extends UI.Widget.VBox { |
| private focusOnShow: boolean; |
| private isIndexing: boolean; |
| private searchId: number; |
| private searchMatchesCount: number; |
| private searchResultsCount: number; |
| private nonEmptySearchResultsCount: number; |
| private searchingView: UI.Widget.Widget|null; |
| private notFoundView: UI.Widget.Widget|null; |
| private searchConfig: SearchConfig|null; |
| private pendingSearchConfig: SearchConfig|null; |
| private searchResultsPane: SearchResultsPane|null; |
| private progressIndicator: UI.ProgressIndicator.ProgressIndicator|null; |
| private visiblePane: UI.Widget.Widget|null; |
| private readonly searchPanelElement: HTMLElement; |
| private readonly searchResultsElement: HTMLElement; |
| private search: UI.HistoryInput.HistoryInput; |
| private matchCaseButton: UI.Toolbar.ToolbarToggle; |
| private readonly regexButton: UI.Toolbar.ToolbarToggle; |
| private searchMessageElement: HTMLElement; |
| private readonly searchProgressPlaceholderElement: HTMLElement; |
| private searchResultsMessageElement: HTMLElement; |
| private readonly advancedSearchConfig: Common.Settings.Setting<{ |
| query: string, |
| ignoreCase: boolean, |
| isRegex: boolean, |
| }>; |
| private searchScope: SearchScope|null; |
| constructor(settingKey: string) { |
| super(true); |
| this.setMinimumSize(0, 40); |
| |
| this.focusOnShow = false; |
| this.isIndexing = false; |
| this.searchId = 1; |
| this.searchMatchesCount = 0; |
| this.searchResultsCount = 0; |
| this.nonEmptySearchResultsCount = 0; |
| this.searchingView = null; |
| this.notFoundView = null; |
| this.searchConfig = null; |
| this.pendingSearchConfig = null; |
| this.searchResultsPane = null; |
| this.progressIndicator = null; |
| this.visiblePane = null; |
| |
| this.contentElement.classList.add('search-view'); |
| this.contentElement.addEventListener('keydown', event => { |
| this.onKeyDownOnPanel((event as KeyboardEvent)); |
| }); |
| |
| this.searchPanelElement = this.contentElement.createChild('div', 'search-drawer-header'); |
| this.searchResultsElement = this.contentElement.createChild('div'); |
| this.searchResultsElement.className = 'search-results'; |
| |
| const searchContainer = document.createElement('div'); |
| searchContainer.style.flex = 'auto'; |
| searchContainer.style.justifyContent = 'start'; |
| searchContainer.style.maxWidth = '300px'; |
| searchContainer.style.overflow = 'revert'; |
| this.search = UI.HistoryInput.HistoryInput.create(); |
| this.search.addEventListener('keydown', event => { |
| this.onKeyDown((event as KeyboardEvent)); |
| }); |
| searchContainer.appendChild(this.search); |
| this.search.placeholder = i18nString(UIStrings.search); |
| this.search.setAttribute('type', 'text'); |
| this.search.setAttribute('results', '0'); |
| this.search.setAttribute('size', '42'); |
| UI.ARIAUtils.setAccessibleName(this.search, i18nString(UIStrings.searchQuery)); |
| const searchItem = new UI.Toolbar.ToolbarItem(searchContainer); |
| |
| const toolbar = new UI.Toolbar.Toolbar('search-toolbar', this.searchPanelElement); |
| this.matchCaseButton = SearchView.appendToolbarToggle(toolbar, 'Aa', i18nString(UIStrings.matchCase)); |
| this.regexButton = SearchView.appendToolbarToggle(toolbar, '.*', i18nString(UIStrings.useRegularExpression)); |
| toolbar.appendToolbarItem(searchItem); |
| const refreshButton = new UI.Toolbar.ToolbarButton(i18nString(UIStrings.refresh), 'refresh'); |
| const clearButton = new UI.Toolbar.ToolbarButton(i18nString(UIStrings.clear), 'clear'); |
| toolbar.appendToolbarItem(refreshButton); |
| toolbar.appendToolbarItem(clearButton); |
| refreshButton.addEventListener(UI.Toolbar.ToolbarButton.Events.Click, () => this.onAction()); |
| clearButton.addEventListener(UI.Toolbar.ToolbarButton.Events.Click, () => { |
| this.resetSearch(); |
| this.onSearchInputClear(); |
| }); |
| |
| const searchStatusBarElement = this.contentElement.createChild('div', 'search-toolbar-summary'); |
| this.searchMessageElement = searchStatusBarElement.createChild('div', 'search-message'); |
| this.searchProgressPlaceholderElement = searchStatusBarElement.createChild('div', 'flex-centered'); |
| this.searchResultsMessageElement = searchStatusBarElement.createChild('div', 'search-message'); |
| |
| this.advancedSearchConfig = Common.Settings.Settings.instance().createLocalSetting( |
| settingKey + 'SearchConfig', new SearchConfig('', true, false).toPlainObject()); |
| |
| this.load(); |
| this.searchScope = null; |
| } |
| |
| private static appendToolbarToggle(toolbar: UI.Toolbar.Toolbar, text: string, tooltip: string): |
| UI.Toolbar.ToolbarToggle { |
| const toggle = new UI.Toolbar.ToolbarToggle(tooltip); |
| toggle.setText(text); |
| toggle.addEventListener(UI.Toolbar.ToolbarButton.Events.Click, () => toggle.setToggled(!toggle.toggled())); |
| toolbar.appendToolbarItem(toggle); |
| return toggle; |
| } |
| |
| private buildSearchConfig(): SearchConfig { |
| return new SearchConfig(this.search.value, !this.matchCaseButton.toggled(), this.regexButton.toggled()); |
| } |
| |
| async toggle(queryCandidate: string, searchImmediately?: boolean): Promise<void> { |
| if (queryCandidate) { |
| this.search.value = queryCandidate; |
| } |
| if (this.isShowing()) { |
| this.focus(); |
| } else { |
| this.focusOnShow = true; |
| } |
| |
| this.initScope(); |
| if (searchImmediately) { |
| this.onAction(); |
| } else { |
| this.startIndexing(); |
| } |
| } |
| |
| createScope(): SearchScope { |
| throw new Error('Not implemented'); |
| } |
| |
| private initScope(): void { |
| this.searchScope = this.createScope(); |
| } |
| |
| override wasShown(): void { |
| if (this.focusOnShow) { |
| this.focus(); |
| this.focusOnShow = false; |
| } |
| this.registerCSSFiles([searchViewStyles]); |
| } |
| |
| private onIndexingFinished(): void { |
| if (!this.progressIndicator) { |
| return; |
| } |
| |
| const finished = !this.progressIndicator.isCanceled(); |
| this.progressIndicator.done(); |
| this.progressIndicator = null; |
| this.isIndexing = false; |
| this.indexingFinished(finished); |
| if (!finished) { |
| this.pendingSearchConfig = null; |
| } |
| if (!this.pendingSearchConfig) { |
| return; |
| } |
| const searchConfig = this.pendingSearchConfig; |
| this.pendingSearchConfig = null; |
| this.innerStartSearch(searchConfig); |
| } |
| |
| private startIndexing(): void { |
| this.isIndexing = true; |
| if (this.progressIndicator) { |
| this.progressIndicator.done(); |
| } |
| this.progressIndicator = new UI.ProgressIndicator.ProgressIndicator(); |
| this.searchMessageElement.textContent = i18nString(UIStrings.indexing); |
| this.progressIndicator.show(this.searchProgressPlaceholderElement); |
| if (this.searchScope) { |
| this.searchScope.performIndexing( |
| new Common.Progress.ProgressProxy(this.progressIndicator, this.onIndexingFinished.bind(this))); |
| } |
| } |
| |
| private onSearchInputClear(): void { |
| this.search.value = ''; |
| this.save(); |
| this.focus(); |
| } |
| |
| private onSearchResult(searchId: number, searchResult: SearchResult): void { |
| if (searchId !== this.searchId || !this.progressIndicator) { |
| return; |
| } |
| if (this.progressIndicator && this.progressIndicator.isCanceled()) { |
| this.onIndexingFinished(); |
| return; |
| } |
| this.addSearchResult(searchResult); |
| if (!searchResult.matchesCount()) { |
| return; |
| } |
| if (!this.searchResultsPane) { |
| this.searchResultsPane = new SearchResultsPane((this.searchConfig as SearchConfig)); |
| this.showPane(this.searchResultsPane); |
| } |
| this.searchResultsPane.addSearchResult(searchResult); |
| } |
| |
| private onSearchFinished(searchId: number, finished: boolean): void { |
| if (searchId !== this.searchId || !this.progressIndicator) { |
| return; |
| } |
| if (!this.searchResultsPane) { |
| this.nothingFound(); |
| } |
| this.searchFinished(finished); |
| this.searchConfig = null; |
| UI.ARIAUtils.alert(this.searchMessageElement.textContent + ' ' + this.searchResultsMessageElement.textContent); |
| } |
| |
| private async startSearch(searchConfig: SearchConfig): Promise<void> { |
| this.resetSearch(); |
| ++this.searchId; |
| this.initScope(); |
| if (!this.isIndexing) { |
| this.startIndexing(); |
| } |
| this.pendingSearchConfig = searchConfig; |
| } |
| |
| private innerStartSearch(searchConfig: SearchConfig): void { |
| this.searchConfig = searchConfig; |
| if (this.progressIndicator) { |
| this.progressIndicator.done(); |
| } |
| this.progressIndicator = new UI.ProgressIndicator.ProgressIndicator(); |
| this.searchStarted(this.progressIndicator); |
| if (this.searchScope) { |
| void this.searchScope.performSearch( |
| searchConfig, this.progressIndicator, this.onSearchResult.bind(this, this.searchId), |
| this.onSearchFinished.bind(this, this.searchId)); |
| } |
| } |
| |
| private resetSearch(): void { |
| this.stopSearch(); |
| this.showPane(null); |
| this.searchResultsPane = null; |
| this.clearSearchMessage(); |
| } |
| |
| private clearSearchMessage(): void { |
| this.searchMessageElement.textContent = ''; |
| this.searchResultsMessageElement.textContent = ''; |
| } |
| |
| private stopSearch(): void { |
| if (this.progressIndicator && !this.isIndexing) { |
| this.progressIndicator.cancel(); |
| } |
| if (this.searchScope) { |
| this.searchScope.stopSearch(); |
| } |
| this.searchConfig = null; |
| } |
| |
| private searchStarted(progressIndicator: UI.ProgressIndicator.ProgressIndicator): void { |
| this.resetCounters(); |
| if (!this.searchingView) { |
| this.searchingView = new UI.EmptyWidget.EmptyWidget(i18nString(UIStrings.searching)); |
| } |
| this.showPane(this.searchingView); |
| this.searchMessageElement.textContent = i18nString(UIStrings.searching); |
| progressIndicator.show(this.searchProgressPlaceholderElement); |
| this.updateSearchResultsMessage(); |
| } |
| |
| private indexingFinished(finished: boolean): void { |
| this.searchMessageElement.textContent = finished ? '' : i18nString(UIStrings.indexingInterrupted); |
| } |
| |
| private updateSearchResultsMessage(): void { |
| if (this.searchMatchesCount && this.searchResultsCount) { |
| if (this.searchMatchesCount === 1 && this.nonEmptySearchResultsCount === 1) { |
| this.searchResultsMessageElement.textContent = i18nString(UIStrings.foundMatchingLineInFile); |
| } else if (this.searchMatchesCount > 1 && this.nonEmptySearchResultsCount === 1) { |
| this.searchResultsMessageElement.textContent = |
| i18nString(UIStrings.foundDMatchingLinesInFile, {PH1: this.searchMatchesCount}); |
| } else { |
| this.searchResultsMessageElement.textContent = i18nString( |
| UIStrings.foundDMatchingLinesInDFiles, |
| {PH1: this.searchMatchesCount, PH2: this.nonEmptySearchResultsCount}); |
| } |
| } else { |
| this.searchResultsMessageElement.textContent = ''; |
| } |
| } |
| |
| private showPane(panel: UI.Widget.Widget|null): void { |
| if (this.visiblePane) { |
| this.visiblePane.detach(); |
| } |
| if (panel) { |
| panel.show(this.searchResultsElement); |
| } |
| this.visiblePane = panel; |
| } |
| |
| private resetCounters(): void { |
| this.searchMatchesCount = 0; |
| this.searchResultsCount = 0; |
| this.nonEmptySearchResultsCount = 0; |
| } |
| |
| private nothingFound(): void { |
| if (!this.notFoundView) { |
| this.notFoundView = new UI.EmptyWidget.EmptyWidget(i18nString(UIStrings.noMatchesFound)); |
| } |
| this.showPane(this.notFoundView); |
| this.searchResultsMessageElement.textContent = i18nString(UIStrings.noMatchesFound); |
| } |
| |
| private addSearchResult(searchResult: SearchResult): void { |
| const matchesCount = searchResult.matchesCount(); |
| this.searchMatchesCount += matchesCount; |
| this.searchResultsCount++; |
| if (matchesCount) { |
| this.nonEmptySearchResultsCount++; |
| } |
| this.updateSearchResultsMessage(); |
| } |
| |
| private searchFinished(finished: boolean): void { |
| this.searchMessageElement.textContent = |
| finished ? i18nString(UIStrings.searchFinished) : i18nString(UIStrings.searchInterrupted); |
| } |
| |
| override focus(): void { |
| this.search.focus(); |
| this.search.select(); |
| } |
| |
| override willHide(): void { |
| this.stopSearch(); |
| } |
| |
| private onKeyDown(event: KeyboardEvent): void { |
| this.save(); |
| switch (event.keyCode) { |
| case UI.KeyboardShortcut.Keys.Enter.code: |
| this.onAction(); |
| break; |
| } |
| } |
| |
| /** |
| * Handles keydown event on panel itself for handling expand/collapse all shortcut |
| * |
| * We use `event.code` instead of `event.key` here to check whether the shortcut is triggered. |
| * The reason is, `event.key` is dependent on the modification keys, locale and keyboard layout. |
| * Usually it is useful when we care about the character that needs to be printed. |
| * |
| * However, our aim in here is to assign a shortcut to the physical key combination on the keyboard |
| * not on the character that the key combination prints. |
| * |
| * For example, `Cmd + [` shortcut in global shortcuts map to focusing on previous panel. |
| * In Turkish - Q keyboard layout, the key combination that triggers the shortcut prints `ğ` |
| * character. Whereas in Turkish - Q Legacy keyboard layout, the shortcut that triggers focusing |
| * on previous panel prints `[` character. So, if we use `event.key` and check |
| * whether it is `[`, we break the shortcut in Turkish - Q keyboard layout. |
| * |
| * @param event KeyboardEvent |
| */ |
| private onKeyDownOnPanel(event: KeyboardEvent): void { |
| const isMac = Host.Platform.isMac(); |
| // "Command + Alt + ]" for Mac |
| const shouldShowAllForMac = |
| isMac && event.metaKey && !event.ctrlKey && event.altKey && event.code === 'BracketRight'; |
| // "Ctrl + Shift + }" for other platforms |
| const shouldShowAllForOtherPlatforms = |
| !isMac && event.ctrlKey && !event.metaKey && event.shiftKey && event.code === 'BracketRight'; |
| // "Command + Alt + [" for Mac |
| const shouldCollapseAllForMac = |
| isMac && event.metaKey && !event.ctrlKey && event.altKey && event.code === 'BracketLeft'; |
| // "Command + Alt + {" for other platforms |
| const shouldCollapseAllForOtherPlatforms = |
| !isMac && event.ctrlKey && !event.metaKey && event.shiftKey && event.code === 'BracketLeft'; |
| |
| if (shouldShowAllForMac || shouldShowAllForOtherPlatforms) { |
| this.searchResultsPane?.showAllMatches(); |
| } else if (shouldCollapseAllForMac || shouldCollapseAllForOtherPlatforms) { |
| this.searchResultsPane?.collapseAllResults(); |
| } |
| } |
| |
| private save(): void { |
| this.advancedSearchConfig.set(this.buildSearchConfig().toPlainObject()); |
| } |
| |
| private load(): void { |
| const searchConfig = SearchConfig.fromPlainObject(this.advancedSearchConfig.get()); |
| this.search.value = searchConfig.query(); |
| this.matchCaseButton.setToggled(!searchConfig.ignoreCase()); |
| this.regexButton.setToggled(searchConfig.isRegex()); |
| } |
| |
| private onAction(): void { |
| const searchConfig = this.buildSearchConfig(); |
| if (!searchConfig.query() || !searchConfig.query().length) { |
| return; |
| } |
| void this.startSearch(searchConfig); |
| } |
| } |