Skip to content

armgit / dbx

Public Imported from GitHub
0

25 MB lightweight cross-platform database client for 100+ databases, including MySQL, PostgreSQL, SQLite, Redis, MongoDB, DuckDB, SQL Server, and Dameng. Built-in AI, MCP Server, CLI, desktop and Docker. | 轻量级跨平台数据库管理工具,支持 MySQL、PostgreSQL、SQLite、Redis、MongoDB、达梦等 100+ 数据库,提供桌面端、Docker、CLI、内置 AI 助手和 MCP。

feat(grid): add find and replace for query results

caichangqing11208567e50887b5
diff --git a/apps/desktop/src/components/grid/DataGrid.vue b/apps/desktop/src/components/grid/DataGrid.vue
index cb51527263..1fda58e19b 100644
--- a/apps/desktop/src/components/grid/DataGrid.vue
+++ b/apps/desktop/src/components/grid/DataGrid.vue
@@ -305,6 +305,7 @@ import { createDataGridRuntimeScope } from "@/lib/dataGrid/dataGridRuntime";
import { useDataGridEditor } from "@/composables/useDataGridEditor";
import { useDataGridSort } from "@/composables/useDataGridSort";
import { useDataGridSearch, type DataGridSearchMatch } from "@/composables/useDataGridSearch";
+import { findDataGridReplacementMatches, replaceDataGridText, type DataGridReplaceScope } from "@/lib/dataGrid/dataGridReplace";
import { useDataGridResultLifecycle } from "@/composables/useDataGridResultLifecycle";
import { useDataGridAutoRefresh } from "@/composables/useDataGridAutoRefresh";
import { useDataGridAsyncSurface } from "@/composables/useDataGridAsyncSurface";
@@ -1012,11 +1013,21 @@ const transposeScrollLeft = ref(0);
const transposeViewportWidth = ref(0);
const { sortColumn: sortCol, sortColumnIndex: sortColIndex, sortDirection: sortDir, sortMode, setSort, clearSort } = useDataGridSort();
const searchBarRef = ref<{ focus: (select?: boolean) => void } | null>(null);
+const replaceOpen = ref(false);
+const replacementText = ref("");
+const replaceScope = ref<DataGridReplaceScope>("loaded");
+const replaceCaseSensitive = ref(false);
+const replaceColumn = ref(-1);
const dataGridSearch = useDataGridSearch({
columns: () => props.result.columns,
suggestionColumns: () => props.tableMeta?.columns.map((column) => column.name) ?? props.result.columns,
rows: () => displayItems.value,
getCellSearchText: (row, columnIndex) => (row.data[columnIndex] === null ? "" : rowLowerTextCache.get(row.data, columnIndex)),
+ getCellRawSearchText: (row, columnIndex) => (typeof row.data[columnIndex] === "string" ? (row.data[columnIndex] as string) : replaceOpen.value ? "" : String(row.data[columnIndex] ?? "")),
+ caseSensitive: () => replaceOpen.value && replaceCaseSensitive.value,
+ literalQuery: replaceOpen,
+ includeColumnMatches: () => !replaceOpen.value,
+ isCellSearchable: (row, columnIndex) => !replaceOpen.value || (canReplaceGridCell(row, columnIndex) && replacementCellInScope(row.id, columnIndex)),
onNavigate: () => nextTick(scrollToCurrentMatch),
// Same key as useDataGridEditor below: table data tabs use the tab id, query
// results use resultGridInstanceKey so a re-execute starts with a clean search.
@@ -1724,12 +1735,23 @@ function focusSearch(target: Element | null = null): boolean {
}
function closeSearch() {
+ replaceOpen.value = false;
dataGridSearch.close();
}
const PAIRS: Record<string, string> = { "'": "'", '"': '"', "(": ")" };
function onSearchKeydown(e: KeyboardEvent) {
+ if (replaceOpen.value) {
+ if (isCancelSearchShortcut(e)) {
+ e.preventDefault();
+ closeSearch();
+ } else if (e.key === "Enter") {
+ e.preventDefault();
+ navigateMatch(e.shiftKey ? -1 : 1);
+ }
+ return;
+ }
if (e.key in PAIRS && !e.ctrlKey && !e.metaKey) {
const input = e.target as HTMLInputElement;
const start = input.selectionStart ?? 0;
@@ -3704,6 +3726,7 @@ const {
commitEditAndMaybeAutoSave,
commitEditFromBlur,
applyCellValue,
+ stageCellReplacements,
restoreCellValue,
cancelEdit,
onEditKeydown,
@@ -4367,7 +4390,7 @@ const rollbackToolbarCapability = computed<DataGridToolbarActionCapability>(() =
const sortedRows = computed(() => {
let indices = localFilteredRows.value;
const q = deferredClientSearchText.value;
- if (q && dataGridSearchMode.value === "filter") {
+ if (q && dataGridSearchMode.value === "filter" && !replaceOpen.value) {
// Preserve the legacy Ctrl+F behavior when the user chooses row filtering.
const rows = props.result.rows;
indices = indices.filter((sourceIndex) => {
@@ -4771,7 +4794,7 @@ const deleteRowDetails = computed(() => {
});
const hasVisibleRows = computed(() => displayRowCount.value > 0);
-const hasActiveFilter = computed(() => (dataGridSearchMode.value === "filter" && !!deferredClientSearchText.value) || rowStatusFilter.value !== "all" || hasLocalColumnFilters.value || hasServerColumnFilters.value);
+const hasActiveFilter = computed(() => (dataGridSearchMode.value === "filter" && !replaceOpen.value && !!deferredClientSearchText.value) || rowStatusFilter.value !== "all" || hasLocalColumnFilters.value || hasServerColumnFilters.value);
const emptyTitle = computed(() => (hasActiveFilter.value ? t("grid.noFilteredRows") : t("grid.noRows")));
const emptyDescription = computed(() => (hasActiveFilter.value ? t("grid.noFilteredRowsDescription") : t("grid.noRowsDescription")));
watch(
@@ -8059,6 +8082,84 @@ function selectedRangeTargetsOnlyDraftRow(): boolean {
return displayItemAt(range.startRow)?.isDraft === true;
}
+const replaceAvailable = computed(() => !!props.editable && hasDataGridSaveTarget.value && canEditExistingRows.value && !resolvedConnectionConfig.value?.read_only && !isConditionalUpdateActive.value);
+const replaceBusy = computed(() => isSaving.value || gridSurfaceBusy.value || props.loading === true);
+
+function replacementRowItem(rowId: number): RowItem | undefined {
+ const row = props.result.rows[rowId];
+ if (!row || rowId < 0) return undefined;
+ return { id: rowId, displayIndex: displayRowIndexById(rowId), sourceIndex: rowId, data: rowDataWithChanges(row, rowId), isNew: false, isDeleted: deletedRows.value.has(rowId), isDirtyCol: [], status: dirtyRows.value.has(rowId) ? "edited" : "clean" };
+}
+
+function canReplaceGridCell(item: RowItem | undefined, col: number): boolean {
+ const type = allColumnTypes.value[col];
+ return (
+ replaceAvailable.value &&
+ !!item &&
+ item.sourceIndex !== undefined &&
+ !item.isNew &&
+ !item.isDraft &&
+ typeof item.data[col] === "string" &&
+ canEditCellItem(item, col) &&
+ !isLargeValuePreview(item, col) &&
+ !isBinaryCellColumnType(type) &&
+ !isNumericColumnType(type) &&
+ !isBooleanGridCell(item, col)
+ );
+}
+
+function replacementCellInScope(rowId: number, col: number): boolean {
+ if (replaceScope.value === "loaded") return true;
+ if (replaceScope.value === "column") return col === replaceColumn.value;
+ const rowIndex = displayRowIndexById(rowId);
+ const visibleCol = visibleColumnIndexes.value.indexOf(col);
+ return rowIndex >= 0 && visibleCol >= 0 && (cellIsSelected(rowIndex, visibleCol) || isRowSelected(rowId) || columnIsSelected(visibleCol));
+}
+
+const replacementMatches = computed(() => {
+ if (!replaceOpen.value || !replaceAvailable.value) return [];
+ const items = new Map(props.result.rows.map((_, rowId) => [rowId, replacementRowItem(rowId)!]));
+ return findDataGridReplacementMatches({
+ rows: [...items.values()].map((item) => ({ rowId: item.id, data: item.data })),
+ search: deferredClientSearchText.value,
+ caseSensitive: replaceCaseSensitive.value,
+ includesCell: replacementCellInScope,
+ canReplaceCell: (rowId, col) => canReplaceGridCell(items.get(rowId), col),
+ });
+});
+
+const canReplaceCurrent = computed(() => {
+ if (searchText.value !== deferredClientSearchText.value) return false;
+ const match = currentSearchMatch.value;
+ if (!match || match.kind !== "cell") return false;
+ const item = displayItemAt(match.displayRow);
+ return !!item && replacementMatches.value.some((candidate) => candidate.rowId === item.id && candidate.col === match.col);
+});
+
+watch([replaceOpen, replaceScope], () => {
+ if (!replaceOpen.value || replaceScope.value !== "column") return;
+ const selectionCol = selectionFocus.value?.colIndex ?? [...selectedColumnIndexes.value][0];
+ replaceColumn.value = selectionCol !== null && selectionCol !== undefined ? actualColumnIndex(selectionCol) : (currentSearchMatch.value?.col ?? visibleColumnIndexes.value[0] ?? -1);
+});
+
+watch(
+ () => props.result,
+ () => {
+ replaceOpen.value = false;
+ replaceColumn.value = -1;
+ },
+);
+
+function replaceGridMatches(currentOnly = false) {
+ if (!replaceAvailable.value || replaceBusy.value) return;
+ if (currentOnly && !canReplaceCurrent.value) return;
+ const current = currentSearchMatch.value;
+ const currentRowId = current?.kind === "cell" ? displayItemAt(current.displayRow)?.id : undefined;
+ const matches = replacementMatches.value.filter((match) => !currentOnly || (match.rowId === currentRowId && match.col === current?.col));
+ const count = stageCellReplacements(matches.map((match) => ({ ...match, previousValue: match.value, value: replaceDataGridText(match.value, deferredClientSearchText.value, replacementText.value, replaceCaseSensitive.value) })));
+ if (count > 0) toast(t("grid.replaceStagedCells", { count }), 5000);
+}
+
function fillSelectionWithValue(value: string | null, options: { preserveEmptyString?: boolean; emptyStringAsNull?: boolean } = {}): boolean {
const range = selectedRange.value;
let applied = false;
@@ -11842,6 +11943,16 @@ useUpdateBlocker(() => (hasPendingChanges.value || hasPendingDataEditorDraft.val
<DataGridSearchBar
ref="searchBarRef"
v-model:text="searchText"
+ v-model:replace-open="replaceOpen"
+ v-model:replacement-text="replacementText"
+ v-model:replace-scope="replaceScope"
+ v-model:case-sensitive="replaceCaseSensitive"
+ v-model:replace-column="replaceColumn"
+ :replace-available="replaceAvailable"
+ :replace-busy="replaceBusy"
+ :replace-match-count="replacementMatches.length"
+ :can-replace-current="canReplaceCurrent"
+ :columns="props.result.columns"
:open="searchOverlayVisible"
:suggestions="searchSuggestions"
:suggestion-index="suggestionIndex"
@@ -11851,6 +11962,8 @@ useUpdateBlocker(() => (hasPendingChanges.value || hasPendingDataEditorDraft.val
:values-truncated="(props.result.large_value_cells?.length ?? 0) > 0"
@keydown="onSearchKeydown"
@navigate="navigateMatch"
+ @replace-current="replaceGridMatches(true)"
+ @replace-all="replaceGridMatches()"
@close="closeSearch"
@accept-suggestion="
suggestionIndex = $event;
diff --git a/apps/desktop/src/components/grid/DataGridSearchBar.vue b/apps/desktop/src/components/grid/DataGridSearchBar.vue
index a7a912255e..fb47bd2734 100644
--- a/apps/desktop/src/components/grid/DataGridSearchBar.vue
+++ b/apps/desktop/src/components/grid/DataGridSearchBar.vue
@@ -1,29 +1,45 @@
<script setup lang="ts">
import { ref } from "vue";
-import { ChevronDown, ChevronUp, Search, X } from "@lucide/vue";
+import { CaseSensitive, ChevronDown, ChevronRight, ChevronUp, Search, X } from "@lucide/vue";
import { useI18n } from "vue-i18n";
import { vNamingStyleSupport } from "@/directives/vNamingStyleSupport";
+import type { DataGridReplaceScope } from "@/lib/dataGrid/dataGridReplace";
const { t } = useI18n();
-const props = defineProps<{
- open: boolean;
- suggestions: string[];
- suggestionIndex: number;
- matchCount: number;
- currentMatchIndex: number;
- hasDeferredSearchText: boolean;
- /** 结果里含被截断显示的长值(large_value_cells),搜索只覆盖显示文本。 */
- valuesTruncated?: boolean;
-}>();
+const props = withDefaults(
+ defineProps<{
+ open: boolean;
+ suggestions: string[];
+ suggestionIndex: number;
+ matchCount: number;
+ currentMatchIndex: number;
+ hasDeferredSearchText: boolean;
+ /** 结果里含被截断显示的长值(large_value_cells),搜索只覆盖显示文本。 */
+ valuesTruncated?: boolean;
+ replaceAvailable?: boolean;
+ replaceBusy?: boolean;
+ replaceMatchCount?: number;
+ canReplaceCurrent?: boolean;
+ columns?: string[];
+ }>(),
+ { replaceAvailable: undefined },
+);
const searchText = defineModel<string>("text", { default: "" });
+const replaceOpen = defineModel<boolean>("replaceOpen", { default: false });
+const replacementText = defineModel<string>("replacementText", { default: "" });
+const replaceScope = defineModel<DataGridReplaceScope>("replaceScope", { default: "loaded" });
+const caseSensitive = defineModel<boolean>("caseSensitive", { default: false });
+const replaceColumn = defineModel<number>("replaceColumn", { default: -1 });
const emit = defineEmits<{
keydown: [event: KeyboardEvent];
close: [];
navigate: [delta: number];
acceptSuggestion: [index: number];
hoverSuggestion: [index: number];
+ replaceCurrent: [];
+ replaceAll: [];
}>();
const searchInput = ref<HTMLInputElement>();
@@ -48,66 +64,124 @@ defineExpose({
<template>
<Transition enter-active-class="transition-opacity duration-150" leave-active-class="transition-opacity duration-100" enter-from-class="opacity-0" leave-to-class="opacity-0">
- <div v-if="props.open" class="absolute top-1 right-2 z-20 flex items-center gap-1 px-2 py-1 bg-background border rounded-md shadow-md">
- <Search class="w-3.5 h-3.5 text-muted-foreground shrink-0" />
- <input
- ref="searchInput"
- v-model="searchText"
- v-naming-style-support
- type="search"
- autocapitalize="off"
- autocomplete="off"
- autocorrect="off"
- spellcheck="false"
- class="w-48 h-5 min-w-0 text-xs bg-transparent outline-none placeholder:text-muted-foreground"
- :placeholder="t('grid.search')"
- @keydown="emit('keydown', $event)"
- />
- <div v-if="props.suggestions.length > 0" class="absolute top-full right-0 mt-0.5 z-50 min-w-[180px] rounded-md border bg-popover text-popover-foreground shadow-md">
- <div
- v-for="(suggestion, index) in props.suggestions"
- :key="suggestion"
- class="flex items-center px-3 py-1.5 text-xs cursor-pointer"
- :class="index === props.suggestionIndex ? 'bg-accent text-accent-foreground' : 'hover:bg-gray-200 dark:hover:bg-gray-800'"
- @mousedown="onSuggestionMouseDown($event, index)"
- @mouseenter="emit('hoverSuggestion', index)"
+ <div v-if="props.open" data-grid-search-bar class="absolute top-1 right-2 z-20 max-w-[calc(100%-1rem)] px-2 py-1 bg-background border rounded-md shadow-md" @keydown.esc.stop.prevent="emit('close')">
+ <div class="flex items-center gap-1 min-w-0">
+ <button
+ v-if="props.replaceAvailable !== undefined"
+ data-grid-replace-toggle
+ type="button"
+ class="shrink-0 text-muted-foreground hover:text-foreground"
+ :disabled="!props.replaceAvailable"
+ :title="t(replaceOpen ? 'editor.search.collapseReplace' : 'editor.search.expandReplace')"
+ :aria-label="t(replaceOpen ? 'editor.search.collapseReplace' : 'editor.search.expandReplace')"
+ :aria-expanded="replaceOpen"
+ @click="replaceOpen = !replaceOpen"
+ >
+ <ChevronDown v-if="replaceOpen" class="w-3.5 h-3.5" />
+ <ChevronRight v-else class="w-3.5 h-3.5" />
+ </button>
+ <Search class="w-3.5 h-3.5 text-muted-foreground shrink-0" />
+ <input
+ ref="searchInput"
+ v-model="searchText"
+ v-naming-style-support
+ type="search"
+ autocapitalize="off"
+ autocomplete="off"
+ autocorrect="off"
+ spellcheck="false"
+ class="w-48 h-5 min-w-0 flex-1 text-xs bg-transparent outline-none placeholder:text-muted-foreground"
+ :placeholder="t('grid.search')"
+ @keydown="emit('keydown', $event)"
+ />
+ <button
+ v-if="replaceOpen"
+ data-grid-replace-case
+ type="button"
+ class="shrink-0 rounded p-0.5 text-muted-foreground hover:text-foreground"
+ :class="caseSensitive ? 'bg-accent text-accent-foreground' : ''"
+ :title="t('editor.search.caseSensitive')"
+ :aria-label="t('editor.search.caseSensitive')"
+ :aria-pressed="caseSensitive"
+ @click="caseSensitive = !caseSensitive"
>
- <Search class="w-3 h-3 mr-2 text-muted-foreground shrink-0" />
- <span>{{ suggestion }}</span>
+ <CaseSensitive class="w-3.5 h-3.5" />
+ </button>
+ <div v-if="props.suggestions.length > 0" class="absolute top-full right-0 mt-0.5 z-50 min-w-[180px] rounded-md border bg-popover text-popover-foreground shadow-md">
+ <div
+ v-for="(suggestion, index) in props.suggestions"
+ :key="suggestion"
+ class="flex items-center px-3 py-1.5 text-xs cursor-pointer"
+ :class="index === props.suggestionIndex ? 'bg-accent text-accent-foreground' : 'hover:bg-gray-200 dark:hover:bg-gray-800'"
+ @mousedown="onSuggestionMouseDown($event, index)"
+ @mouseenter="emit('hoverSuggestion', index)"
+ >
+ <Search class="w-3 h-3 mr-2 text-muted-foreground shrink-0" />
+ <span>{{ suggestion }}</span>
+ </div>
</div>
- </div>
- <!-- 截断标记:表格预览对长文本/JSON 值做服务端截断,客户端搜索只能覆盖
+ <!-- 截断标记:表格预览对长文本/JSON 值做服务端截断,客户端搜索只能覆盖
显示前缀,匹配数可能少于 SQL 查询(#7279)。 -->
- <span v-if="props.valuesTruncated && (props.matchCount > 0 || props.hasDeferredSearchText)" data-grid-search-truncated-hint class="text-xs text-amber-600 dark:text-amber-400 shrink-0 cursor-help" :title="t('grid.searchTruncatedValuesHint')" :aria-label="t('grid.searchTruncatedValuesHint')"
- >≈</span
- >
- <span v-if="props.matchCount > 0" class="text-xs text-muted-foreground shrink-0">{{ props.currentMatchIndex + 1 }}/{{ props.matchCount }}</span>
- <span v-else-if="props.hasDeferredSearchText" class="text-xs text-muted-foreground shrink-0">0</span>
- <button
- type="button"
- class="text-muted-foreground hover:text-foreground disabled:opacity-40 disabled:pointer-events-none shrink-0"
- :disabled="props.matchCount === 0"
- :title="t('search.prevMatch')"
- :aria-label="t('search.prevMatch')"
- @mousedown="keepSearchInputFocused"
- @click="emit('navigate', -1)"
- >
- <ChevronUp class="w-3.5 h-3.5" />
- </button>
- <button
- type="button"
- class="text-muted-foreground hover:text-foreground disabled:opacity-40 disabled:pointer-events-none shrink-0"
- :disabled="props.matchCount === 0"
- :title="t('search.nextMatch')"
- :aria-label="t('search.nextMatch')"
- @mousedown="keepSearchInputFocused"
- @click="emit('navigate', 1)"
- >
- <ChevronDown class="w-3.5 h-3.5" />
- </button>
- <button type="button" class="text-muted-foreground hover:text-foreground shrink-0" :title="t('search.close')" :aria-label="t('search.close')" @click="emit('close')">
- <X class="w-3.5 h-3.5" />
- </button>
+ <span v-if="props.valuesTruncated && (props.matchCount > 0 || props.hasDeferredSearchText)" data-grid-search-truncated-hint class="text-xs text-amber-600 dark:text-amber-400 shrink-0 cursor-help" :title="t('grid.searchTruncatedValuesHint')" :aria-label="t('grid.searchTruncatedValuesHint')"
+ >≈</span
+ >
+ <span v-if="props.matchCount > 0" class="text-xs text-muted-foreground shrink-0">{{ props.currentMatchIndex + 1 }}/{{ props.matchCount }}</span>
+ <span v-else-if="props.hasDeferredSearchText" class="text-xs text-muted-foreground shrink-0">0</span>
+ <button
+ type="button"
+ class="text-muted-foreground hover:text-foreground disabled:opacity-40 disabled:pointer-events-none shrink-0"
+ :disabled="props.matchCount === 0"
+ :title="t('editor.search.prevMatch')"
+ :aria-label="t('editor.search.prevMatch')"
+ @mousedown="keepSearchInputFocused"
+ @click="emit('navigate', -1)"
+ >
+ <ChevronUp class="w-3.5 h-3.5" />
+ </button>
+ <button
+ type="button"
+ class="text-muted-foreground hover:text-foreground disabled:opacity-40 disabled:pointer-events-none shrink-0"
+ :disabled="props.matchCount === 0"
+ :title="t('editor.search.nextMatch')"
+ :aria-label="t('editor.search.nextMatch')"
+ @mousedown="keepSearchInputFocused"
+ @click="emit('navigate', 1)"
+ >
+ <ChevronDown class="w-3.5 h-3.5" />
+ </button>
+ <button type="button" class="text-muted-foreground hover:text-foreground shrink-0" :title="t('editor.search.close')" :aria-label="t('editor.search.close')" @click="emit('close')">
+ <X class="w-3.5 h-3.5" />
+ </button>
+ </div>
+ <div v-if="replaceOpen" class="flex flex-wrap items-center gap-1 mt-1 border-t pt-1">
+ <input
+ v-model="replacementText"
+ data-grid-replacement-input
+ type="text"
+ autocomplete="off"
+ spellcheck="false"
+ class="h-6 min-w-0 w-48 flex-1 text-xs bg-transparent outline-none border rounded px-1.5"
+ :placeholder="t('grid.replaceText')"
+ :aria-label="t('grid.replaceText')"
+ @keydown.enter.stop.prevent="props.replaceAvailable && !props.replaceBusy && props.canReplaceCurrent && emit('replaceCurrent')"
+ />
+ <button data-grid-replace-current type="button" class="h-6 border rounded px-2 text-xs disabled:opacity-40" :disabled="!props.replaceAvailable || props.replaceBusy || !props.canReplaceCurrent" :title="t('grid.replaceCurrentCell')" @click="emit('replaceCurrent')">
+ {{ t("editor.search.replace") }}
+ </button>
+ <button data-grid-replace-all type="button" class="h-6 border rounded px-2 text-xs disabled:opacity-40" :disabled="!props.replaceAvailable || props.replaceBusy || !props.replaceMatchCount" @click="emit('replaceAll')">{{ t("editor.search.replaceAll") }}</button>
+ </div>
+ <div v-if="replaceOpen" class="flex flex-wrap items-center gap-1 mt-1 text-xs">
+ <select v-model="replaceScope" data-grid-replace-scope class="min-w-0 h-6 max-w-full rounded border bg-background px-1" :aria-label="t('grid.replaceScope')">
+ <option value="loaded">{{ t("grid.replaceLoadedResults") }}</option>
+ <option value="column">{{ t("grid.replaceCurrentColumn") }}</option>
+ <option value="selection">{{ t("grid.replaceSelectedCells") }}</option>
+ </select>
+ <select v-if="replaceScope === 'column'" v-model.number="replaceColumn" data-grid-replace-column class="h-6 min-w-0 flex-1 max-w-48 rounded border bg-background px-1" :aria-label="t('grid.replaceCurrentColumn')">
+ <option :value="-1" disabled>{{ t("grid.replaceChooseColumn") }}</option>
+ <option v-for="(column, index) in props.columns" :key="index" :value="index">{{ column }}</option>
+ </select>
+ <span class="text-muted-foreground" aria-live="polite">{{ t("grid.replaceMatchedCells", { count: props.replaceMatchCount ?? 0 }) }}</span>
+ </div>
</div>
</Transition>
</template>
diff --git a/apps/desktop/src/components/grid/__tests__/DataGridSearchReplace.spec.ts b/apps/desktop/src/components/grid/__tests__/DataGridSearchReplace.spec.ts
new file mode 100644
index 0000000000..798261df4e
--- /dev/null
+++ b/apps/desktop/src/components/grid/__tests__/DataGridSearchReplace.spec.ts
@@ -0,0 +1,86 @@
+// @vitest-environment happy-dom
+import { createApp, h, nextTick } from "vue";
+import { afterEach, describe, expect, it, vi } from "vitest";
+import DataGridSearchBar from "../DataGridSearchBar.vue";
+
+vi.mock("vue-i18n", () => ({ useI18n: () => ({ t: (key: string) => key }) }));
+const cleanup: (() => void)[] = [];
+afterEach(() => cleanup.splice(0).forEach((dispose) => dispose()));
+
+function mountBar(overrides: Record<string, unknown> = {}) {
+ const root = document.createElement("div");
+ document.body.append(root);
+ const replaceAll = vi.fn();
+ const replaceCurrent = vi.fn();
+ const changeText = vi.fn();
+ const changeScope = vi.fn();
+ const changeCase = vi.fn();
+ const app = createApp({
+ render: () =>
+ h(DataGridSearchBar, {
+ open: true,
+ suggestions: [],
+ suggestionIndex: -1,
+ matchCount: 2,
+ currentMatchIndex: 0,
+ hasDeferredSearchText: true,
+ replaceOpen: true,
+ replaceAvailable: true,
+ replaceMatchCount: 2,
+ canReplaceCurrent: true,
+ columns: ["first", "paths"],
+ onReplaceAll: replaceAll,
+ onReplaceCurrent: replaceCurrent,
+ "onUpdate:replacementText": changeText,
+ "onUpdate:replaceScope": changeScope,
+ "onUpdate:caseSensitive": changeCase,
+ ...overrides,
+ }),
+ });
+ app.mount(root);
+ cleanup.push(() => {
+ app.unmount();
+ root.remove();
+ });
+ return { root, replaceAll, replaceCurrent, changeText, changeScope, changeCase };
+}
+
+describe("DataGridSearchBar replacement controls", () => {
+ it("emits literal empty replacement input, scope and case choices and replacement commands", async () => {
+ const bar = mountBar();
+ const input = bar.root.querySelector<HTMLInputElement>("[data-grid-replacement-input]")!;
+ expect(input).not.toBeNull();
+ input.value = "$&";
+ input.dispatchEvent(new Event("input"));
+ expect(bar.changeText).toHaveBeenCalledWith("$&");
+ input.value = "";
+ input.dispatchEvent(new Event("input"));
+ expect(bar.changeText).toHaveBeenLastCalledWith("");
+ const scope = bar.root.querySelector<HTMLSelectElement>("[data-grid-replace-scope]")!;
+ scope.value = "selection";
+ scope.dispatchEvent(new Event("change"));
+ expect(bar.changeScope).toHaveBeenCalledWith("selection");
+ bar.root.querySelector<HTMLButtonElement>("[data-grid-replace-case]")!.click();
+ expect(bar.changeCase).toHaveBeenCalledWith(true);
+ bar.root.querySelector<HTMLButtonElement>("[data-grid-replace-all]")!.click();
+ bar.root.querySelector<HTMLButtonElement>("[data-grid-replace-current]")!.click();
+ expect(bar.replaceAll).toHaveBeenCalledOnce();
+ expect(bar.replaceCurrent).toHaveBeenCalledOnce();
+ await nextTick();
+ });
+
+ it("disables replacement for readonly/busy results and does not expose it in search-only hosts", () => {
+ const readonly = mountBar({ replaceAvailable: false });
+ const button = readonly.root.querySelector<HTMLButtonElement>("[data-grid-replace-all]")!;
+ expect(button.disabled).toBe(true);
+ button.click();
+ expect(readonly.replaceAll).not.toHaveBeenCalled();
+ const busy = mountBar({ replaceBusy: true });
+ expect(busy.root.querySelector<HTMLButtonElement>("[data-grid-replace-all]")!.disabled).toBe(true);
+ const empty = mountBar({ replaceMatchCount: 0, canReplaceCurrent: false });
+ expect(empty.root.querySelector<HTMLButtonElement>("[data-grid-replace-all]")!.disabled).toBe(true);
+ const searchOnly = mountBar({ replaceOpen: false, replaceAvailable: undefined });
+ expect(searchOnly.root.querySelector("[data-grid-replacement-input]")).toBeNull();
+ expect(searchOnly.root.querySelector("[data-grid-replace-toggle]")).toBeNull();
+ });
+});
diff --git a/apps/desktop/src/components/grid/__tests__/DataGridSurfaces.spec.ts b/apps/desktop/src/components/grid/__tests__/DataGridSurfaces.spec.ts
index fdbcff4a78..84405205da 100644
--- a/apps/desktop/src/components/grid/__tests__/DataGridSurfaces.spec.ts
+++ b/apps/desktop/src/components/grid/__tests__/DataGridSurfaces.spec.ts
@@ -20,6 +20,7 @@ vi.mock("@lucide/vue", async () => {
const icon = createPassthroughStub("Icon", "i");
return {
Check: icon,
+ CaseSensitive: icon,
ChevronDown: icon,
ChevronUp: icon,
ChevronLeft: icon,
@@ -225,14 +226,14 @@ describe("DataGridSearchBar", () => {
dispatch(suggestion, "mouseenter");
expect(hoverSuggestion).toHaveBeenCalledWith(0);
- const previousButton = findOne(mounted.root, (node) => node.props["aria-label"] === "search.prevMatch");
- const nextButton = findOne(mounted.root, (node) => node.props["aria-label"] === "search.nextMatch");
+ const previousButton = findOne(mounted.root, (node) => node.props["aria-label"] === "editor.search.prevMatch");
+ const nextButton = findOne(mounted.root, (node) => node.props["aria-label"] === "editor.search.nextMatch");
expect(dispatch(previousButton, "mousedown").defaultPrevented).toBe(true);
dispatch(previousButton, "click");
dispatch(nextButton, "click");
expect(navigate.mock.calls).toEqual([[-1], [1]]);
- const closeButton = findOne(mounted.root, (node) => node.props["aria-label"] === "search.close");
+ const closeButton = findOne(mounted.root, (node) => node.props["aria-label"] === "editor.search.close");
dispatch(closeButton, "click");
expect(close).toHaveBeenCalledOnce();
diff --git a/apps/desktop/src/composables/__tests__/useDataGridEditor.spec.ts b/apps/desktop/src/composables/__tests__/useDataGridEditor.spec.ts
index e35ad3b3e1..36b7486034 100644
--- a/apps/desktop/src/composables/__tests__/useDataGridEditor.spec.ts
+++ b/apps/desktop/src/composables/__tests__/useDataGridEditor.spec.ts
@@ -49,6 +49,7 @@ function createEditorWithResult(
onCellValueChanged?: (rowId: number, columnIndex: number) => void,
tableColumns?: Array<{ name: string; data_type: string; extra?: string; column_default?: string }>,
mongoCollectionGrid = false,
+ quickEntry = false,
) {
let editor: ReturnType<typeof useDataGridEditor>;
const result = ref<{ columns: string[]; rows: CellValue[][] }>({
@@ -77,6 +78,7 @@ function createEditorWithResult(
onExecuteSql: computed(() => undefined),
sql: computed(() => undefined),
searchText: ref(""),
+ dataGridQuickEntryEnabled: computed(() => quickEntry),
whereFilterInput: ref(""),
currentWhereInput: computed(() => undefined),
orderByInput: ref(""),
@@ -136,6 +138,122 @@ function createEditor(...args: Parameters<typeof createEditorWithResult>) {
return createEditorWithResult(...args).editor;
}
+describe("useDataGridEditor searched replacements", () => {
+ beforeEach(() => {
+ mocks.prepareDataGridSave.mockReset();
+ mocks.executeBatch.mockReset();
+ mocks.getConfig.mockReturnValue(undefined);
+ });
+
+ it("stages one undoable batch, keeps empty strings and preserves prior pending edits", () => {
+ const editor = createEditor(undefined, true, undefined, undefined, [["hit", "keep", "hit"]]);
+ editor.newRows.value = [];
+ editor.applyCellValue(0, 1, "draft");
+ expect(
+ editor.stageCellReplacements([
+ { rowId: 0, col: 0, previousValue: "hit", value: "" },
+ { rowId: 0, col: 2, previousValue: "hit", value: "new" },
+ ]),
+ ).toBe(2);
+ expect(editor.dirtyRows.value.get(0)).toEqual(
+ new Map([
+ [1, "draft"],
+ [0, ""],
+ [2, "new"],
+ ]),
+ );
+ expect(editor.manualSaveRequired.value).toBe(true);
+ editor.undoPendingChange();
+ expect(editor.dirtyRows.value.get(0)).toEqual(new Map([[1, "draft"]]));
+ expect(editor.manualSaveRequired.value).toBe(false);
+ editor.redoPendingChange();
+ expect(editor.dirtyRows.value.get(0)?.get(0)).toBe("");
+ expect(editor.manualSaveRequired.value).toBe(true);
+ expect(mocks.executeBatch).not.toHaveBeenCalled();
+ });
+
+ it("rejects readonly, stale, deleted, non-string and out-of-range targets", () => {
+ const editor = createEditor(
+ ["first", undefined, "last"],
+ true,
+ undefined,
+ [2],
+ [
+ ["hit", "hit", "hit"],
+ [123, null, false],
+ ],
+ );
+ editor.newRows.value = [];
+ editor.deletedRows.value.add(0);
+ const changes = [
+ { rowId: 0, col: 0, previousValue: "hit", value: "x" },
+ { rowId: 1, col: 0, previousValue: "123", value: "x" },
+ { rowId: 9, col: 0, previousValue: "hit", value: "x" },
+ ];
+ expect(editor.stageCellReplacements(changes)).toBe(0);
+ editor.deletedRows.value.clear();
+ expect(
+ editor.stageCellReplacements([
+ { rowId: 0, col: 0, previousValue: "stale", value: "x" },
+ { rowId: 0, col: 1, previousValue: "hit", value: "x" },
+ { rowId: 0, col: 2, previousValue: "hit", value: "x" },
+ { rowId: -1, col: 0, previousValue: "hit", value: "x" },
+ ]),
+ ).toBe(0);
+ expect(editor.dirtyRows.value.size).toBe(0);
+ expect(editor.manualSaveRequired.value).toBe(false);
+ });
+
+ it("blocks later quick-entry autosaves until explicit save or discard", async () => {
+ const editor = createEditor(undefined, true, undefined, undefined, [["hit", "keep", "hit"]], undefined, undefined, false, true);
+ editor.newRows.value = [];
+ editor.stageCellReplacements([{ rowId: 0, col: 0, previousValue: "hit", value: "new" }]);
+ editor.applyCellValue(0, 1, "later edit");
+ await editor.saveChanges({ autoSave: true });
+ expect(mocks.prepareDataGridSave).not.toHaveBeenCalled();
+ expect(mocks.executeBatch).not.toHaveBeenCalled();
+ expect(editor.hasPendingChanges.value).toBe(true);
+ mocks.prepareDataGridSave.mockResolvedValue({ statements: ["UPDATE people SET first='new',hidden='later edit' WHERE last='hit'"], rollbackStatements: [] });
+ mocks.executeBatch.mockResolvedValue([]);
+ await editor.saveChanges();
+ expect(mocks.executeBatch).toHaveBeenCalledOnce();
+ expect(editor.manualSaveRequired.value).toBe(false);
+ editor.stageCellReplacements([{ rowId: 0, col: 0, previousValue: "new", value: "other" }]);
+ editor.discardChanges();
+ expect(editor.manualSaveRequired.value).toBe(false);
+ });
+
+ it("persists the manual-save interlock across a tab remount", async () => {
+ const key = "replace-remount";
+ const rows: CellValue[][] = [["hit", "keep", "hit"]];
+ const first = createEditor(undefined, true, key, undefined, rows);
+ first.newRows.value = [];
+ first.stageCellReplacements([{ rowId: 0, col: 0, previousValue: "hit", value: "new" }]);
+ first.savePendingSnapshot();
+ const second = createEditor(undefined, true, key, undefined, rows);
+ second.newRows.value = [];
+ expect(second.manualSaveRequired.value).toBe(true);
+ await second.saveChanges({ autoSave: true });
+ expect(mocks.executeBatch).not.toHaveBeenCalled();
+ second.discardChanges();
+ clearDataGridPendingSnapshot(key);
+ });
+
+ it("clears the manual-save interlock when replacement restores all original values", () => {
+ const editor = createEditor(undefined, true, undefined, undefined, [["hit", "keep", "hit"]]);
+ editor.newRows.value = [];
+ editor.stageCellReplacements([{ rowId: 0, col: 0, previousValue: "hit", value: "new" }]);
+ editor.stageCellReplacements([{ rowId: 0, col: 0, previousValue: "new", value: "hit" }]);
+ expect(editor.hasPendingChanges.value).toBe(false);
+ expect(editor.manualSaveRequired.value).toBe(false);
+ editor.undoPendingChange();
+ expect(editor.dirtyRows.value.get(0)?.get(0)).toBe("new");
+ expect(editor.manualSaveRequired.value).toBe(true);
+ editor.redoPendingChange();
+ expect(editor.manualSaveRequired.value).toBe(false);
+ });
+});
+
function beforeTabSwitchEvent(fromTabId: string, tabId = "next-tab") {
return new CustomEvent("dbx:before-tab-switch", { detail: { tabId, fromTabId } });
}
diff --git a/apps/desktop/src/composables/__tests__/useDataGridSearch.spec.ts b/apps/desktop/src/composables/__tests__/useDataGridSearch.spec.ts
index ab23cd8a93..6340c63dc1 100644
--- a/apps/desktop/src/composables/__tests__/useDataGridSearch.spec.ts
+++ b/apps/desktop/src/composables/__tests__/useDataGridSearch.spec.ts
@@ -15,6 +15,49 @@ async function flushSearchDebounce() {
}
describe("useDataGridSearch", () => {
+ it("supports literal case-sensitive replacement searches without column-name matches", async () => {
+ vi.useFakeTimers();
+ const sensitive = ref(true);
+ const search = useDataGridSearch({
+ columns: ["HIT", "value"],
+ rows: [
+ ["HIT", "hit hit"],
+ [" hit ", "hit"],
+ ],
+ getCellSearchText: (row, col) => row[col].toLowerCase(),
+ getCellRawSearchText: (row, col) => row[col],
+ caseSensitive: sensitive,
+ literalQuery: true,
+ includeColumnMatches: false,
+ isCellSearchable: (_row, col) => col === 0,
+ });
+ search.searchText.value = "HIT";
+ await flushSearchDebounce();
+ expect(search.matches.value).toEqual([{ kind: "cell", displayRow: 0, col: 0 }]);
+ sensitive.value = false;
+ await flushSearchDebounce();
+ expect(search.matchCount.value).toBe(2);
+ search.searchText.value = " hit ";
+ await flushSearchDebounce();
+ expect(search.matches.value).toEqual([{ kind: "cell", displayRow: 1, col: 0 }]);
+ });
+ it("degrades case-sensitive matching to case-insensitive without a raw-text provider", async () => {
+ vi.useFakeTimers();
+ const search = useDataGridSearch({
+ columns: ["name"],
+ rows: [["Alice"]],
+ // No getCellRawSearchText: only the lowercase cache exists, so an
+ // uppercase query must still match instead of never finding the cell.
+ getCellSearchText: (row, col) => row[col].toLowerCase(),
+ caseSensitive: true,
+ literalQuery: false,
+ includeColumnMatches: false,
+ });
+ search.searchText.value = "ALICE";
+ await flushSearchDebounce();
+ expect(search.matchCount.value).toBe(1);
+ });
+
it("debounces matching across columns and cells", async () => {
vi.useFakeTimers();
// getCellSearchText 契约:返回小写文本(调用方负责缓存小写副本)
diff --git a/apps/desktop/src/composables/useDataGridEditor.ts b/apps/desktop/src/composables/useDataGridEditor.ts
index eae5eb1088..88b745e999 100644
--- a/apps/desktop/src/composables/useDataGridEditor.ts
+++ b/apps/desktop/src/composables/useDataGridEditor.ts
@@ -136,6 +136,7 @@ export interface UseDataGridEditorOptions {
}
interface PendingChangesSnapshot {
+ manualSaveRequired?: boolean;
newRows: CellValue[][];
newRowMeta: GridNewRowMeta[];
quickEntryDraftRow?: CellValue[];
@@ -173,7 +174,7 @@ interface QueuedAutoSaveChange {
value: CellValue;
}
-type PendingChangesHistorySnapshot = Pick<PendingChangesSnapshot, "newRows" | "newRowMeta" | "quickEntryDraftRow" | "dirtyRows" | "deletedRows" | "transactionActive">;
+type PendingChangesHistorySnapshot = Pick<PendingChangesSnapshot, "newRows" | "newRowMeta" | "quickEntryDraftRow" | "dirtyRows" | "deletedRows" | "transactionActive" | "manualSaveRequired">;
const pendingChangesCache = new Map<string, PendingChangesSnapshot>();
const closingPendingSnapshotTabs = new Set<string>();
@@ -312,6 +313,7 @@ export function useDataGridEditor(options: UseDataGridEditorOptions) {
const undoStack = ref<PendingChangesHistorySnapshot[]>([]);
const redoStack = ref<PendingChangesHistorySnapshot[]>([]);
const pendingChangesVersion = ref(0);
+ const manualSaveRequired = ref(false);
let restoredEditingCell = false;
let restoredTransactionActive = false;
let suppressNextBlurCommit = false;
@@ -336,6 +338,7 @@ export function useDataGridEditor(options: UseDataGridEditorOptions) {
quickEntryDraftRow.value = cached.quickEntryDraftRow ? [...cached.quickEntryDraftRow] : [];
dirtyRows.value = cached.dirtyRows;
deletedRows.value = cached.deletedRows;
+ manualSaveRequired.value = cached.manualSaveRequired === true;
editingCell.value = cached.editingCell ?? null;
editValue.value = cached.editValue ?? "";
restoredEditingCell = !!cached.editingCell;
@@ -439,6 +442,7 @@ export function useDataGridEditor(options: UseDataGridEditorOptions) {
function pendingChangesSnapshot(): PendingChangesHistorySnapshot {
return {
+ manualSaveRequired: manualSaveRequired.value,
newRows: newRows.value.map((row) => [...row]),
newRowMeta: cloneNewRowMeta(newRowMeta.value),
quickEntryDraftRow: quickEntryDraftRow.value.length > 0 ? [...quickEntryDraftRow.value] : undefined,
@@ -455,6 +459,7 @@ export function useDataGridEditor(options: UseDataGridEditorOptions) {
restoreNewRowMeta(snapshot.newRowMeta ?? []);
quickEntryDraftRow.value = snapshot.quickEntryDraftRow ? [...snapshot.quickEntryDraftRow] : emptyDraftRow();
dirtyRows.value = restoredDirtyRows;
+ manualSaveRequired.value = snapshot.manualSaveRequired === true;
deletedRows.value = new Set(snapshot.deletedRows);
transactionActive.value = snapshot.transactionActive === true && useTransaction.value === true;
queuedAutoSaveChanges.clear();
@@ -957,8 +962,12 @@ export function useDataGridEditor(options: UseDataGridEditorOptions) {
}
function applyCellValue(rowId: number, col: number, value: string | null, options: ApplyCellValueOptions = {}) {
- if (!canEditColumn(col)) return;
const item = getRowItem(rowId);
+ applyCellValueToItem(item, rowId, col, value, options);
+ }
+
+ function applyCellValueToItem(item: RowItem | undefined, rowId: number, col: number, value: string | null, options: ApplyCellValueOptions = {}) {
+ if (!canEditColumn(col)) return;
if (!item || item.isDeleted) return;
if (item.isDraft) {
@@ -1056,6 +1065,34 @@ export function useDataGridEditor(options: UseDataGridEditorOptions) {
onCellValueChanged?.(rowId, col);
}
+ function stageCellReplacements(changes: readonly import("@/lib/dataGrid/dataGridReplace").DataGridCellReplacement[]): number {
+ if (!editable.value || !canEditExistingRows.value || isSaving.value || isConditionalUpdateActive.value) return 0;
+ let changed = 0;
+ beginBatch();
+ try {
+ for (const change of changes) {
+ const { rowId, col, previousValue, value } = change;
+ if (!Number.isInteger(rowId) || rowId < 0 || !Number.isInteger(col) || col < 0 || col >= result.value.columns.length || !canEditColumn(col) || deletedRows.value.has(rowId)) continue;
+ const row = result.value.rows[rowId];
+ if (!row) continue;
+ const data = rowDataWithChanges(row, rowId);
+ if (typeof data[col] !== "string" || data[col] !== previousValue || value === previousValue) continue;
+ const item: RowItem = { id: rowId, sourceIndex: rowId, data, isNew: false, isDeleted: false, isDirtyCol: [], status: "clean" };
+ applyCellValueToItem(item, rowId, col, value, { preserveEmptyString: true });
+ const currentValue = rowDataWithChanges(row, rowId)[col];
+ if (currentValue !== previousValue) {
+ changed++;
+ // Set after the first undo snapshot, so undo restores the prior policy.
+ manualSaveRequired.value = true;
+ }
+ }
+ return changed;
+ } finally {
+ commitBatch();
+ if (!hasPendingChanges.value) manualSaveRequired.value = false;
+ }
+ }
+
function restoreCellValue(rowId: number, col: number) {
if (!canEditColumn(col)) return;
const item = getRowItem(rowId);
@@ -1501,6 +1538,7 @@ export function useDataGridEditor(options: UseDataGridEditorOptions) {
async function finishSaveChanges(savedSnapshot?: PendingSaveSnapshot) {
isSaving.value = false;
+ if (!hasPendingChanges.value) manualSaveRequired.value = false;
if (pendingAutoSaveRequested && dataGridQuickEntryEnabled.value) {
applyQueuedAutoSaveChanges(savedSnapshot);
} else {
@@ -1811,6 +1849,7 @@ export function useDataGridEditor(options: UseDataGridEditorOptions) {
}
async function saveChanges(saveOptions: SaveChangesOptions = {}) {
+ if (saveOptions.autoSave && manualSaveRequired.value) return;
if (isSaving.value) {
if (saveOptions.autoSave) pendingAutoSaveRequested = true;
return;
@@ -2016,6 +2055,7 @@ export function useDataGridEditor(options: UseDataGridEditorOptions) {
function discardChanges() {
if (isConditionalUpdateActive.value) return;
+ manualSaveRequired.value = false;
dirtyRows.value = new Map();
newRows.value = [];
newRowMeta.value = [];
@@ -2060,6 +2100,7 @@ export function useDataGridEditor(options: UseDataGridEditorOptions) {
return;
}
pendingChangesCache.set(k, {
+ manualSaveRequired: manualSaveRequired.value,
newRows: newRows.value.map((r) => [...r]),
newRowMeta: cloneNewRowMeta(newRowMeta.value),
quickEntryDraftRow: quickEntryDraftRowSnapshot,
@@ -2168,6 +2209,8 @@ export function useDataGridEditor(options: UseDataGridEditorOptions) {
newRowCount,
deletedRowCount,
pendingChangesVersion,
+ manualSaveRequired,
+ stageCellReplacements,
pendingChangeCount,
hasPendingChanges,
transactionActive,
diff --git a/apps/desktop/src/composables/useDataGridSearch.ts b/apps/desktop/src/composables/useDataGridSearch.ts
index 5960558341..41176cd23d 100644
--- a/apps/desktop/src/composables/useDataGridSearch.ts
+++ b/apps/desktop/src/composables/useDataGridSearch.ts
@@ -1,6 +1,7 @@
import { computed, getCurrentScope, nextTick, onScopeDispose, ref, toValue, watch, type MaybeRefOrGetter } from "vue";
import { dataGridSearchMatchKey } from "@/lib/dataGrid/canvasDataGridRenderer";
import { loadDataGridSearchState, saveDataGridSearchState } from "@/lib/dataGrid/dataGridSearchStatePersistence";
+import { dataGridReplacementPattern } from "@/lib/dataGrid/dataGridReplace";
export type DataGridSearchMatch = {
kind: "cell" | "column";
@@ -17,6 +18,11 @@ export type UseDataGridSearchOptions<Row> = {
/** 必须返回小写文本(查询词已小写)。调用方可据此缓存小写副本,
* 避免每次按键对全部单元格重新分配 toLowerCase 字符串。 */
getCellSearchText: (row: Row, columnIndex: number) => string;
+ getCellRawSearchText?: (row: Row, columnIndex: number) => string;
+ caseSensitive?: MaybeRefOrGetter<boolean>;
+ literalQuery?: MaybeRefOrGetter<boolean>;
+ includeColumnMatches?: MaybeRefOrGetter<boolean>;
+ isCellSearchable?: (row: Row, columnIndex: number) => boolean;
debounceMs?: number;
onNavigate?: (match: DataGridSearchMatch) => void;
/** 按标签页键控的持久化键;不传则该宿主不参与搜索状态保留。 */
@@ -38,6 +44,11 @@ export function useDataGridSearch<Row>(options: UseDataGridSearchOptions<Row>) {
const suggestionIndex = ref(-1);
let searchTimer: ReturnType<typeof setTimeout> | undefined;
+ // Case-sensitive matching needs the raw (non-lowercased) cell text. Without a
+ // raw-text provider only the lowercase cache exists, so degrade to
+ // case-insensitive instead of never matching uppercase input.
+ const effectiveCaseSensitive = computed(() => !!toValue(options.caseSensitive) && (!!toValue(options.literalQuery) || !!options.getCellRawSearchText));
+
const matchState = computed(() => {
const query = deferredSearchText.value;
const keys: number[] = [];
@@ -50,12 +61,23 @@ export function useDataGridSearch<Row>(options: UseDataGridSearchOptions<Row>) {
matchSet.add(key);
};
const columns = toValue(options.columns);
- columns.forEach((column, col) => {
- if (column.toLowerCase().includes(query)) addMatch(-1, col);
- });
+ const sensitive = effectiveCaseSensitive.value;
+ const pattern = toValue(options.literalQuery) ? dataGridReplacementPattern(query, sensitive) : undefined;
+ const includes = (value: string) => {
+ if (!pattern) return (sensitive ? value : value.toLowerCase()).includes(query);
+ pattern.lastIndex = 0;
+ return pattern.test(value);
+ };
+ if (toValue(options.includeColumnMatches) !== false) {
+ columns.forEach((column, col) => {
+ if (includes(column)) addMatch(-1, col);
+ });
+ }
toValue(options.rows).forEach((row, displayRow) => {
columns.forEach((_, col) => {
- if (options.getCellSearchText(row, col).includes(query)) addMatch(displayRow, col);
+ if (options.isCellSearchable && !options.isCellSearchable(row, col)) return;
+ const text = (pattern || sensitive) && options.getCellRawSearchText ? options.getCellRawSearchText(row, col) : options.getCellSearchText(row, col);
+ if (includes(text)) addMatch(displayRow, col);
});
});
return { keys, matchSet };
@@ -81,9 +103,10 @@ export function useDataGridSearch<Row>(options: UseDataGridSearchOptions<Row>) {
// watcher flush and self-invalidates if the user types during the restore window.
let restoreToken: { searchText: string; matchIndex: number } | null = null;
- watch(searchText, (value) => {
+ watch([searchText, () => toValue(options.caseSensitive), () => toValue(options.literalQuery)], ([value]) => {
clearTimer();
- const query = value.trim().toLowerCase();
+ const text = toValue(options.literalQuery) ? value : value.trim();
+ const query = toValue(options.literalQuery) || effectiveCaseSensitive.value ? text : text.toLowerCase();
const restoring = restoreToken !== null && restoreToken.searchText === value;
if (!query) deferredSearchText.value = "";
// Restoring is not typing: resolve the query now so the row set (and, in
@@ -102,6 +125,12 @@ export function useDataGridSearch<Row>(options: UseDataGridSearchOptions<Row>) {
// are writing keeps the normal debounce, index reset and auto-navigate.
restoreToken = null;
+ if (toValue(options.literalQuery)) {
+ suggestions.value = [];
+ suggestionIndex.value = -1;
+ return;
+ }
+
const lastToken = value.trim().split(SEARCH_TOKEN_SEPARATOR).pop()?.toLowerCase() ?? "";
suggestions.value = lastToken
? toValue(options.suggestionColumns ?? options.columns)
diff --git a/apps/desktop/src/i18n/locales/en.ts b/apps/desktop/src/i18n/locales/en.ts
index 1689086a6a..07bc93f491 100644
--- a/apps/desktop/src/i18n/locales/en.ts
+++ b/apps/desktop/src/i18n/locales/en.ts
@@ -2168,6 +2168,15 @@ export default {
batchAppendPasteTargetNotEmpty: "The selected new row already contains data.",
batchAppendPasteEmpty: "The clipboard does not contain rows to add.",
batchAppendPasteReadonlyColumn: "The pasted data includes a column that cannot be edited.",
+ replaceText: "Replace with",
+ replaceCurrentCell: "Replace all matching text in the current cell",
+ replaceScope: "Replacement scope",
+ replaceLoadedResults: "Loaded results",
+ replaceCurrentColumn: "Current column",
+ replaceSelectedCells: "Selected cells",
+ replaceChooseColumn: "Choose a column",
+ replaceMatchedCells: "{count} matching cells",
+ replaceStagedCells: "Replaced {count} cells; pending save",
search: "Search...",
searchTruncatedValuesHint: "Some long text/JSON values are truncated for display; the search only covers loaded cell text and may miss matches.",
searchOrWhere: "Search, or enter a WHERE clause...",
diff --git a/apps/desktop/src/i18n/locales/es.ts b/apps/desktop/src/i18n/locales/es.ts
index 8c5ccbdb8e..431ec59d3d 100644
--- a/apps/desktop/src/i18n/locales/es.ts
+++ b/apps/desktop/src/i18n/locales/es.ts
@@ -2357,6 +2357,15 @@ export default withEnglishFallback({
batchAppendPasteTargetNotEmpty: "La nueva fila seleccionada ya contiene datos.",
batchAppendPasteEmpty: "No hay filas nuevas en el portapapeles.",
batchAppendPasteReadonlyColumn: "Los datos pegados contienen columnas no editables.",
+ replaceText: "Reemplazar por",
+ replaceCurrentCell: "Reemplazar todo el texto coincidente en la celda actual",
+ replaceScope: "Ámbito de reemplazo",
+ replaceLoadedResults: "Resultados cargados",
+ replaceCurrentColumn: "Columna actual",
+ replaceSelectedCells: "Celdas seleccionadas",
+ replaceChooseColumn: "Elegir una columna",
+ replaceMatchedCells: "{count} celdas coincidentes",
+ replaceStagedCells: "Se reemplazaron {count} celdas; pendiente de guardar",
xlsxHeaderTitle: "Formato de encabezado",
xlsxExportTitle: "Opciones de exportacion",
xlsxHeaderPrompt: "Seleccione el formato de encabezado al exportar a Excel:",
diff --git a/apps/desktop/src/i18n/locales/it.ts b/apps/desktop/src/i18n/locales/it.ts
index f225ad1a6d..85e46bc0ef 100644
--- a/apps/desktop/src/i18n/locales/it.ts
+++ b/apps/desktop/src/i18n/locales/it.ts
@@ -2355,6 +2355,15 @@ export default withEnglishFallback({
batchAppendPasteTargetNotEmpty: "La riga nuova selezionata contiene già dati.",
batchAppendPasteEmpty: "Negli appunti non ci sono righe da aggiungere.",
batchAppendPasteReadonlyColumn: "I dati incollati contengono colonne non modificabili.",
+ replaceText: "Sostituisci con",
+ replaceCurrentCell: "Sostituisci tutto il testo corrispondente nella cella corrente",
+ replaceScope: "Ambito di sostituzione",
+ replaceLoadedResults: "Risultati caricati",
+ replaceCurrentColumn: "Colonna corrente",
+ replaceSelectedCells: "Celle selezionate",
+ replaceChooseColumn: "Scegli una colonna",
+ replaceMatchedCells: "{count} celle corrispondenti",
+ replaceStagedCells: "Sostituite {count} celle; salvataggio in sospeso",
xlsxHeaderTitle: "Formato intestazione",
xlsxExportTitle: "Opzioni di esportazione",
xlsxHeaderPrompt: "Seleziona il formato dell'intestazione da utilizzare per l'esportazione in Excel:",
diff --git a/apps/desktop/src/i18n/locales/ja.ts b/apps/desktop/src/i18n/locales/ja.ts
index e470002df7..20c7302eff 100644
--- a/apps/desktop/src/i18n/locales/ja.ts
+++ b/apps/desktop/src/i18n/locales/ja.ts
@@ -2377,6 +2377,15 @@ export default withEnglishFallback({
batchAppendPasteTargetNotEmpty: "選択した新規行には既にデータが含まれています。",
batchAppendPasteEmpty: "クリップボードに追加可能な行がありません。",
batchAppendPasteReadonlyColumn: "貼り付けたデータに編集不可能な列が含まれています。",
+ replaceText: "置換後の文字列",
+ replaceCurrentCell: "現在のセル内の一致するテキストをすべて置換",
+ replaceScope: "置換範囲",
+ replaceLoadedResults: "読み込み済みの結果",
+ replaceCurrentColumn: "現在の列",
+ replaceSelectedCells: "選択したセル",
+ replaceChooseColumn: "列を選択",
+ replaceMatchedCells: "一致するセル: {count} 件",
+ replaceStagedCells: "{count} 個のセルを置換しました。保存待ちです",
xlsxHeaderTitle: "ヘッダー形式",
xlsxExportTitle: "エクスポートオプション",
xlsxHeaderPrompt: "Excel エクスポート時に使用するヘッダー形式を選択してください:",
diff --git a/apps/desktop/src/i18n/locales/ko.ts b/apps/desktop/src/i18n/locales/ko.ts
index 999f3c8e9b..3c649e0e05 100644
--- a/apps/desktop/src/i18n/locales/ko.ts
+++ b/apps/desktop/src/i18n/locales/ko.ts
@@ -2005,6 +2005,15 @@ export default withEnglishFallback({
hideSelectedColumns: "선택한 컬럼 숨기기 ({count})",
showAllColumnsMenu: "모든 컬럼 표시",
pasted: "붙여넣었습니다!",
+ replaceText: "바꿀 내용",
+ replaceCurrentCell: "현재 셀에서 일치하는 텍스트 모두 바꾸기",
+ replaceScope: "바꾸기 범위",
+ replaceLoadedResults: "로드된 결과",
+ replaceCurrentColumn: "현재 컬럼",
+ replaceSelectedCells: "선택한 셀",
+ replaceChooseColumn: "컬럼 선택",
+ replaceMatchedCells: "일치하는 셀 {count}개",
+ replaceStagedCells: "셀 {count}개를 바꿨습니다. 저장 대기 중",
search: "검색...",
searchTruncatedValuesHint: "일부 긴 텍스트/JSON 값은 표시를 위해 잘렸습니다. 검색은 로드된 표시 내용만 대상으로 하며 SQL 쿼리보다 일치 수가 적을 수 있습니다.",
searchOrWhere: "검색 또는 WHERE 절 입력...",
diff --git a/apps/desktop/src/i18n/locales/pt-BR.ts b/apps/desktop/src/i18n/locales/pt-BR.ts
index 2cfad0e247..4a2e6e22af 100644
--- a/apps/desktop/src/i18n/locales/pt-BR.ts
+++ b/apps/desktop/src/i18n/locales/pt-BR.ts
@@ -2357,6 +2357,15 @@ export default withEnglishFallback({
batchAppendPasteTargetNotEmpty: "A nova linha selecionada já contém dados.",
batchAppendPasteEmpty: "Não há linhas para adicionar na área de transferência.",
batchAppendPasteReadonlyColumn: "Os dados colados contêm colunas não editáveis.",
+ replaceText: "Substituir por",
+ replaceCurrentCell: "Substituir todo o texto correspondente na célula atual",
+ replaceScope: "Escopo da substituição",
+ replaceLoadedResults: "Resultados carregados",
+ replaceCurrentColumn: "Coluna atual",
+ replaceSelectedCells: "Células selecionadas",
+ replaceChooseColumn: "Escolher uma coluna",
+ replaceMatchedCells: "{count} células correspondentes",
+ replaceStagedCells: "{count} células substituídas; aguardando salvamento",
xlsxHeaderTitle: "Formato do cabeçalho",
xlsxExportTitle: "Opcoes de exportacao",
xlsxHeaderPrompt: "Selecione o formato do cabeçalho a ser usado ao exportar Excel:",
diff --git a/apps/desktop/src/i18n/locales/zh-CN.ts b/apps/desktop/src/i18n/locales/zh-CN.ts
index c2f42e62d5..bbca64acc6 100644
--- a/apps/desktop/src/i18n/locales/zh-CN.ts
+++ b/apps/desktop/src/i18n/locales/zh-CN.ts
@@ -2083,6 +2083,15 @@ export default withEnglishFallback({
batchAppendPasteTargetNotEmpty: "选中的新增行已包含数据。",
batchAppendPasteEmpty: "剪贴板中没有可新增的行。",
batchAppendPasteReadonlyColumn: "粘贴的数据包含不可编辑的列。",
+ replaceText: "替换为",
+ replaceCurrentCell: "替换当前命中单元格中的全部匹配文字",
+ replaceScope: "替换范围",
+ replaceLoadedResults: "已加载结果",
+ replaceCurrentColumn: "当前列",
+ replaceSelectedCells: "选中单元格",
+ replaceChooseColumn: "选择列",
+ replaceMatchedCells: "命中 {count} 个单元格",
+ replaceStagedCells: "已替换 {count} 个单元格,待保存",
search: "搜索...",
searchTruncatedValuesHint: "部分长文本/JSON 值已截断显示,搜索仅覆盖已加载的显示内容,匹配数可能少于 SQL 查询。",
searchOrWhere: "搜索,或输入 WHERE 条件...",
diff --git a/apps/desktop/src/i18n/locales/zh-TW.ts b/apps/desktop/src/i18n/locales/zh-TW.ts
index 18d55ddcad..0afab4c566 100644
--- a/apps/desktop/src/i18n/locales/zh-TW.ts
+++ b/apps/desktop/src/i18n/locales/zh-TW.ts
@@ -2360,6 +2360,15 @@ export default withEnglishFallback({
batchAppendPasteTargetNotEmpty: "選取的新增行已包含資料。",
batchAppendPasteEmpty: "剪貼簿中沒有可新增的行。",
batchAppendPasteReadonlyColumn: "貼上的資料包含不可編輯的列。",
+ replaceText: "取代為",
+ replaceCurrentCell: "取代目前符合儲存格中的所有相符文字",
+ replaceScope: "取代範圍",
+ replaceLoadedResults: "已載入結果",
+ replaceCurrentColumn: "目前欄位",
+ replaceSelectedCells: "所選儲存格",
+ replaceChooseColumn: "選擇欄位",
+ replaceMatchedCells: "符合 {count} 個儲存格",
+ replaceStagedCells: "已取代 {count} 個儲存格,待儲存",
xlsxHeaderTitle: "表頭格式",
xlsxExportTitle: "匯出選項",
xlsxHeaderPrompt: "請選擇匯出 Excel 時使用的表頭格式:",
diff --git a/apps/desktop/src/lib/__tests__/dataGrid/dataGridReplace.spec.ts b/apps/desktop/src/lib/__tests__/dataGrid/dataGridReplace.spec.ts
new file mode 100644
index 0000000000..c4a3a57158
--- /dev/null
+++ b/apps/desktop/src/lib/__tests__/dataGrid/dataGridReplace.spec.ts
@@ -0,0 +1,45 @@
+import { describe, expect, it } from "vitest";
+import { findDataGridReplacementMatches, replaceDataGridText } from "@/lib/dataGrid/dataGridReplace";
+
+describe("data grid searched text replacement", () => {
+ it("replaces repeated JSON fragments without changing the rest of the value", () => {
+ const value = '[{"backend":"svc.test-test:80","path":"/api/**"},{"backend":"svc2.test-test:81"}]';
+ expect(replaceDataGridText(value, "test-test", "prod", false)).toBe('[{"backend":"svc.prod:80","path":"/api/**"},{"backend":"svc2.prod:81"}]');
+ });
+
+ it("treats both search and replacement as literals", () => {
+ expect(replaceDataGridText("a.* a.*", ".*", "$&$1", false)).toBe("a$&$1 a$&$1");
+ expect(replaceDataGridText("one\\two", "\\", "$'", false)).toBe("one$'two");
+ });
+
+ it("supports case sensitivity, whitespace searches and empty replacement strings", () => {
+ expect(replaceDataGridText("TEST test", "test", "x", true)).toBe("TEST x");
+ expect(replaceDataGridText("TEST test", "test", "x", false)).toBe("x x");
+ expect(replaceDataGridText(" a ", " ", "", false)).toBe("a");
+ expect(replaceDataGridText("hit", "hit", "", false)).toBe("");
+ expect(replaceDataGridText("hit", "", "x", false)).toBe("hit");
+ });
+
+ const rows = [
+ { rowId: 7, data: ["hit", null, 123, true, "HIT"] },
+ { rowId: 2, data: ["hit", "hit", "none", false, "hit"] },
+ ];
+
+ it("matches only string cells in loaded rows using stable source IDs", () => {
+ expect(findDataGridReplacementMatches({ rows, search: "hit" })).toEqual([
+ { rowId: 7, col: 0, value: "hit" },
+ { rowId: 7, col: 4, value: "HIT" },
+ { rowId: 2, col: 0, value: "hit" },
+ { rowId: 2, col: 1, value: "hit" },
+ { rowId: 2, col: 4, value: "hit" },
+ ]);
+ });
+
+ it("applies column, selection, case, readonly and truncation restrictions before matching", () => {
+ expect(findDataGridReplacementMatches({ rows, search: "hit", caseSensitive: true, column: 4 })).toEqual([{ rowId: 2, col: 4, value: "hit" }]);
+ expect(findDataGridReplacementMatches({ rows, search: "hit", includesCell: (rowId, col) => rowId === 2 && col === 1 })).toEqual([{ rowId: 2, col: 1, value: "hit" }]);
+ expect(findDataGridReplacementMatches({ rows, search: "hit", canReplaceCell: (rowId, col) => rowId !== 7 && col !== 1, isTruncated: (rowId, col) => rowId === 2 && col === 4 })).toEqual([{ rowId: 2, col: 0, value: "hit" }]);
+ expect(findDataGridReplacementMatches({ rows, search: "hit", includesCell: () => false })).toEqual([]);
+ expect(findDataGridReplacementMatches({ rows, search: "" })).toEqual([]);
+ });
+});
diff --git a/apps/desktop/src/lib/dataGrid/dataGridReplace.ts b/apps/desktop/src/lib/dataGrid/dataGridReplace.ts
new file mode 100644
index 0000000000..9b36799bb4
--- /dev/null
+++ b/apps/desktop/src/lib/dataGrid/dataGridReplace.ts
@@ -0,0 +1,42 @@
+import type { CellValue } from "@/lib/dataGrid/cellValue";
+
+export type DataGridReplacementMatch = { rowId: number; col: number; value: string };
+export type DataGridCellReplacement = DataGridReplacementMatch & { previousValue: string };
+export type DataGridReplaceScope = "loaded" | "column" | "selection";
+
+type ReplacementMatchOptions = {
+ rows: readonly { rowId: number; data: readonly CellValue[] }[];
+ search: string;
+ caseSensitive?: boolean;
+ column?: number;
+ includesCell?: (rowId: number, col: number) => boolean;
+ canReplaceCell?: (rowId: number, col: number) => boolean;
+ isTruncated?: (rowId: number, col: number) => boolean;
+};
+
+export function dataGridReplacementPattern(search: string, caseSensitive: boolean): RegExp {
+ return new RegExp(search.replace(/[.*+?^${}()|[\]\\]/g, "\\$&"), caseSensitive ? "gu" : "giu");
+}
+
+export function replaceDataGridText(value: string, search: string, replacement: string, caseSensitive: boolean): string {
+ if (!search) return value;
+ // A callback keeps $&, $1 and other replacement tokens literal.
+ return value.replace(dataGridReplacementPattern(search, caseSensitive), () => replacement);
+}
+
+export function findDataGridReplacementMatches(options: ReplacementMatchOptions): DataGridReplacementMatch[] {
+ if (!options.search) return [];
+ const pattern = dataGridReplacementPattern(options.search, options.caseSensitive ?? false);
+ const matches: DataGridReplacementMatch[] = [];
+ for (const row of options.rows) {
+ row.data.forEach((value, col) => {
+ if (typeof value !== "string" || (options.column !== undefined && col !== options.column)) return;
+ if (options.includesCell && !options.includesCell(row.rowId, col)) return;
+ if (options.canReplaceCell && !options.canReplaceCell(row.rowId, col)) return;
+ if (options.isTruncated?.(row.rowId, col)) return;
+ pattern.lastIndex = 0;
+ if (pattern.test(value)) matches.push({ rowId: row.rowId, col, value });
+ });
+ }
+ return matches;
+}
diff --git a/docs/screenshots/issue-9372-grid-find-replace.png b/docs/screenshots/issue-9372-grid-find-replace.png
new file mode 100644
index 0000000000..3b16f62efc
Binary files /dev/null and b/docs/screenshots/issue-9372-grid-find-replace.png differ