Files
Netcatty/components/settings/tabs/TerminalBehaviorSettings.tsx
T
陈大猫 1d5cef09ec fix(settings): index later-added settings in search catalog (Fixes #4230) (#4232)
* fix(settings): index later-added settings in search catalog

Fixes #4230

Follow-up after #4231. Settings search still missed later-added
rows such as Appearance "Code font" (代码字体) and System session
log "Add timestamps" (时间戳), which already rendered in their
tabs. Index those destinations and other visible setting rows
that had the same catalog/anchor omission.

* fix(settings): fall back to visible parent when search target is gated
2026-11-14 21:30:27 +08:00

470 lines
20 KiB
TypeScript

import React from "react";
import { DEFAULT_TERMINAL_WORD_SEPARATORS } from "../../../domain/models";
import type { DisconnectedNoticeMode, DynamicTabTitleMode, LinkModifier, MiddleClickBehavior, OscNotificationMode, RightClickBehavior, TerminalSettings, TerminalTabDoubleClickBehavior } from "../../../domain/models";
import { Input } from "../../ui/input";
import { Label } from "../../ui/label";
import { SectionHeader, Select, SettingsAnchor, SettingRow, Toggle } from "../settings-ui";
type Translate = (key: string) => string;
interface TerminalBehaviorSettingsProps {
t: Translate;
terminalSettings: TerminalSettings;
updateTerminalSetting: <K extends keyof TerminalSettings>(key: K, value: TerminalSettings[K]) => void;
}
export const MIDDLE_CLICK_BEHAVIOR_OPTIONS: Array<{
value: MiddleClickBehavior;
labelKey: string;
}> = [
{ value: "context-menu", labelKey: "settings.terminal.behavior.middleClick.menu" },
{ value: "paste", labelKey: "settings.terminal.behavior.middleClick.paste" },
{ value: "disabled", labelKey: "settings.terminal.behavior.middleClick.disabled" },
];
export const DYNAMIC_TAB_TITLE_MODE_OPTIONS: Array<{
value: DynamicTabTitleMode;
labelKey: string;
}> = [
{ value: "off", labelKey: "settings.terminal.behavior.dynamicTabTitle.off" },
{ value: "agent", labelKey: "settings.terminal.behavior.dynamicTabTitle.agent" },
{ value: "all", labelKey: "settings.terminal.behavior.dynamicTabTitle.all" },
];
export const TAB_DOUBLE_CLICK_BEHAVIOR_OPTIONS: Array<{
value: TerminalTabDoubleClickBehavior;
labelKey: string;
}> = [
{ value: "duplicate", labelKey: "settings.terminal.behavior.tabDoubleClick.duplicate" },
{ value: "copy", labelKey: "settings.terminal.behavior.tabDoubleClick.copy" },
{ value: "disabled", labelKey: "settings.terminal.behavior.tabDoubleClick.disabled" },
];
export const TerminalBehaviorSettings: React.FC<TerminalBehaviorSettingsProps> = ({
t,
terminalSettings,
updateTerminalSetting,
}) => (
<>
<SectionHeader title={t("settings.terminal.section.behavior")} />
<div className="space-y-0 divide-y divide-border rounded-lg border bg-card px-4">
<SettingRow
anchorId="terminal-context-chips"
label={t("settings.terminal.behavior.contextChips")}
description={t("settings.terminal.behavior.contextChips.desc")}
>
<Toggle checked={terminalSettings.contextChipsEnabled !== false} onChange={(v) => updateTerminalSetting("contextChipsEnabled", v)} />
</SettingRow>
<SettingRow
anchorId="terminal-auto-close-on-exit"
label={t("settings.terminal.behavior.autoCloseOnExit")}
description={t("settings.terminal.behavior.autoCloseOnExit.desc")}
>
<Toggle
checked={terminalSettings.autoCloseOnExit}
onChange={(v) => updateTerminalSetting("autoCloseOnExit", v)}
/>
</SettingRow>
<SettingRow
anchorId="terminal-disconnected-notice"
label={t("settings.terminal.behavior.disconnectedNotice")}
description={t("settings.terminal.behavior.disconnectedNotice.desc")}
>
<Select
value={terminalSettings.disconnectedNoticeMode}
options={[
{ value: "terminal", label: t("settings.terminal.behavior.disconnectedNotice.terminal") },
{ value: "dialog", label: t("settings.terminal.behavior.disconnectedNotice.dialog") },
]}
onChange={(v) => updateTerminalSetting("disconnectedNoticeMode", v as DisconnectedNoticeMode)}
className="w-40"
/>
</SettingRow>
<SettingRow
anchorId="terminal-right-click"
label={t("settings.terminal.behavior.rightClick")}
description={t("settings.terminal.behavior.rightClick.desc")}
>
<Select
value={terminalSettings.rightClickBehavior}
options={[
{ value: "context-menu", label: t("settings.terminal.behavior.rightClick.menu") },
{ value: "paste", label: t("settings.terminal.behavior.rightClick.paste") },
{ value: "select-word", label: t("settings.terminal.behavior.rightClick.selectWord") },
]}
onChange={(v) => updateTerminalSetting("rightClickBehavior", v as RightClickBehavior)}
className="w-36"
/>
</SettingRow>
<SettingRow
anchorId="terminal-right-click-long-press-menu"
label={t("settings.terminal.behavior.rightClick.longPressMenu")}
description={t("settings.terminal.behavior.rightClick.longPressMenu.desc")}
>
<Toggle
checked={terminalSettings.rightClickLongPressMenu ?? false}
onChange={(v) => updateTerminalSetting("rightClickLongPressMenu", v)}
/>
</SettingRow>
<SettingRow
anchorId="terminal-right-click-fullscreen-menu"
label={t("settings.terminal.behavior.rightClick.fullscreenMenu")}
description={t("settings.terminal.behavior.rightClick.fullscreenMenu.desc")}
>
<Toggle
checked={terminalSettings.showContextMenuOverFullscreenApps}
onChange={(v) => updateTerminalSetting("showContextMenuOverFullscreenApps", v)}
/>
</SettingRow>
<SettingRow
anchorId="terminal-copy-on-select"
label={t("settings.terminal.behavior.copyOnSelect")}
description={t("settings.terminal.behavior.copyOnSelect.desc")}
>
<Toggle checked={terminalSettings.copyOnSelect} onChange={(v) => updateTerminalSetting("copyOnSelect", v)} />
</SettingRow>
<SettingRow
anchorId="terminal-normalize-text-on-copy"
label={t("settings.terminal.behavior.normalizeTextOnCopy")}
description={t("settings.terminal.behavior.normalizeTextOnCopy.desc")}
>
<Toggle
checked={terminalSettings.normalizeTextOnCopy ?? true}
onChange={(v) => updateTerminalSetting("normalizeTextOnCopy", v)}
/>
</SettingRow>
<SettingRow
anchorId="terminal-middle-click"
label={t("settings.terminal.behavior.middleClick")}
description={t("settings.terminal.behavior.middleClick.desc")}
>
<Select
value={terminalSettings.middleClickBehavior}
options={MIDDLE_CLICK_BEHAVIOR_OPTIONS.map((option) => ({
value: option.value,
label: t(option.labelKey),
}))}
onChange={(v) => updateTerminalSetting("middleClickBehavior", v as MiddleClickBehavior)}
className="w-36"
/>
</SettingRow>
<SettingRow
anchorId="terminal-word-separators"
label={t("settings.terminal.behavior.wordSeparators")}
description={t("settings.terminal.behavior.wordSeparators.desc")}
>
<Input
value={terminalSettings.wordSeparators}
onChange={(e) => updateTerminalSetting("wordSeparators", e.target.value)}
placeholder={`${DEFAULT_TERMINAL_WORD_SEPARATORS}=,:`}
className="w-56 font-mono"
spellCheck={false}
/>
</SettingRow>
<SettingRow
anchorId="terminal-bracketed-paste"
label={t("settings.terminal.behavior.bracketedPaste")}
description={t("settings.terminal.behavior.bracketedPaste.desc")}
>
<Toggle checked={!terminalSettings.disableBracketedPaste} onChange={(v) => updateTerminalSetting("disableBracketedPaste", !v)} />
</SettingRow>
<SettingRow
anchorId="terminal-auto-upload-clipboard-image"
label={t("settings.terminal.behavior.autoUploadClipboardImage")}
description={t("settings.terminal.behavior.autoUploadClipboardImage.desc")}
>
<Toggle
checked={terminalSettings.autoUploadClipboardImageOnPaste ?? false}
onChange={(v) => updateTerminalSetting("autoUploadClipboardImageOnPaste", v)}
/>
</SettingRow>
<SettingRow
anchorId="terminal-confirm-multiline-paste"
label={t("settings.terminal.behavior.confirmMultilinePaste")}
description={t("settings.terminal.behavior.confirmMultilinePaste.desc")}
>
<Toggle
checked={terminalSettings.confirmBeforeMultilinePaste ?? false}
onChange={(v) => updateTerminalSetting("confirmBeforeMultilinePaste", v)}
/>
</SettingRow>
<SettingRow
anchorId="terminal-confirm-multiline-paste-min-lines"
label={t("settings.terminal.behavior.confirmMultilinePasteMinLines")}
description={t("settings.terminal.behavior.confirmMultilinePasteMinLines.desc")}
>
<Input
type="number"
min={1}
max={1000}
value={terminalSettings.multilinePasteConfirmMinLines ?? 2}
onChange={(e) => {
const val = parseInt(e.target.value);
if (!isNaN(val) && val >= 1 && val <= 1000) {
updateTerminalSetting("multilinePasteConfirmMinLines", val);
}
}}
className="w-24"
/>
</SettingRow>
<SettingRow
anchorId="terminal-shift-enter-newline"
label={t("settings.terminal.behavior.shiftEnterNewline")}
description={t("settings.terminal.behavior.shiftEnterNewline.desc")}
>
<Toggle checked={terminalSettings.shiftEnterNewlineEnabled ?? true} onChange={(v) => updateTerminalSetting("shiftEnterNewlineEnabled", v)} />
</SettingRow>
<SettingRow
anchorId="terminal-shift-enter-newline-text"
label={t("settings.terminal.behavior.shiftEnterNewlineText")}
description={t("settings.terminal.behavior.shiftEnterNewlineText.desc")}
>
<Input
value={terminalSettings.shiftEnterNewlineText ?? "\\e\\r"}
onChange={(e) => updateTerminalSetting("shiftEnterNewlineText", e.target.value)}
placeholder="\\e\\r"
className="w-56 font-mono"
spellCheck={false}
/>
</SettingRow>
<SettingRow
anchorId="terminal-shift-enter-force-text"
label={t("settings.terminal.behavior.shiftEnterForceText")}
description={t("settings.terminal.behavior.shiftEnterForceText.desc")}
>
<Toggle
checked={terminalSettings.shiftEnterForceText ?? false}
onChange={(v) => updateTerminalSetting("shiftEnterForceText", v)}
/>
</SettingRow>
<SettingRow
anchorId="terminal-clear-wipes-scrollback"
label={t("settings.terminal.behavior.clearWipesScrollback")}
description={t("settings.terminal.behavior.clearWipesScrollback.desc")}
>
<Toggle checked={terminalSettings.clearWipesScrollback ?? true} onChange={(v) => updateTerminalSetting("clearWipesScrollback", v)} />
</SettingRow>
<SettingRow
anchorId="terminal-preserve-selection-on-input"
label={t("settings.terminal.behavior.preserveSelectionOnInput")}
description={t("settings.terminal.behavior.preserveSelectionOnInput.desc")}
>
<Toggle checked={terminalSettings.preserveSelectionOnInput ?? false} onChange={(v) => updateTerminalSetting("preserveSelectionOnInput", v)} />
</SettingRow>
<SettingRow
anchorId="terminal-force-prompt-new-line"
label={t("settings.terminal.behavior.forcePromptNewLine")}
description={t("settings.terminal.behavior.forcePromptNewLine.desc")}
>
<Toggle checked={terminalSettings.forcePromptNewLine ?? false} onChange={(v) => updateTerminalSetting("forcePromptNewLine", v)} />
</SettingRow>
<SettingRow
anchorId="terminal-tab-double-click"
label={t("settings.terminal.behavior.tabDoubleClick")}
description={t("settings.terminal.behavior.tabDoubleClick.desc")}
>
<Select
value={terminalSettings.tabDoubleClickBehavior}
options={TAB_DOUBLE_CLICK_BEHAVIOR_OPTIONS.map((option) => ({
value: option.value,
label: t(option.labelKey),
}))}
onChange={(v) => updateTerminalSetting("tabDoubleClickBehavior", v as TerminalTabDoubleClickBehavior)}
className="w-44"
/>
</SettingRow>
<SettingRow
anchorId="terminal-dynamic-tab-title"
label={t("settings.terminal.behavior.dynamicTabTitle")}
description={t("settings.terminal.behavior.dynamicTabTitle.desc")}
>
<Select
value={terminalSettings.dynamicTabTitleMode ?? "agent"}
options={DYNAMIC_TAB_TITLE_MODE_OPTIONS.map((option) => ({
value: option.value,
label: t(option.labelKey),
}))}
onChange={(v) => updateTerminalSetting("dynamicTabTitleMode", v as DynamicTabTitleMode)}
className="w-44"
/>
</SettingRow>
<SettingRow
anchorId="terminal-osc-notifications"
label={t("settings.terminal.behavior.oscNotifications")}
description={t("settings.terminal.behavior.oscNotifications.desc")}
>
<Select
value={terminalSettings.oscNotifications ?? "always"}
options={[
{ value: "always", label: t("settings.terminal.behavior.oscNotifications.always") },
{ value: "unfocused", label: t("settings.terminal.behavior.oscNotifications.unfocused") },
{ value: "off", label: t("settings.terminal.behavior.oscNotifications.off") },
]}
onChange={(v) => updateTerminalSetting("oscNotifications", v as OscNotificationMode)}
className="w-40"
/>
</SettingRow>
<SettingRow
anchorId="terminal-osc52-clipboard"
label={t("settings.terminal.behavior.osc52Clipboard")}
description={t("settings.terminal.behavior.osc52Clipboard.desc")}
>
<Select
value={terminalSettings.osc52Clipboard ?? 'write-only'}
options={[
{ value: "off", label: t("settings.terminal.behavior.osc52Clipboard.off") },
{ value: "write-only", label: t("settings.terminal.behavior.osc52Clipboard.writeOnly") },
{ value: "read-write", label: t("settings.terminal.behavior.osc52Clipboard.readWrite") },
{ value: "prompt", label: t("settings.terminal.behavior.osc52Clipboard.prompt") },
]}
onChange={(v) => updateTerminalSetting("osc52Clipboard", v as "off" | "write-only" | "read-write" | "prompt")}
className="w-40"
/>
</SettingRow>
<SettingRow
anchorId="terminal-scroll-on-input"
label={t("settings.terminal.behavior.scrollOnInput")}
description={t("settings.terminal.behavior.scrollOnInput.desc")}
>
<Toggle checked={terminalSettings.scrollOnInput} onChange={(v) => updateTerminalSetting("scrollOnInput", v)} />
</SettingRow>
<SettingRow
anchorId="terminal-scroll-on-output"
label={t("settings.terminal.behavior.scrollOnOutput")}
description={t("settings.terminal.behavior.scrollOnOutput.desc")}
>
<Toggle checked={terminalSettings.scrollOnOutput} onChange={(v) => updateTerminalSetting("scrollOnOutput", v)} />
</SettingRow>
<SettingRow
anchorId="terminal-scroll-on-key-press"
label={t("settings.terminal.behavior.scrollOnKeyPress")}
description={t("settings.terminal.behavior.scrollOnKeyPress.desc")}
>
<Toggle checked={terminalSettings.scrollOnKeyPress} onChange={(v) => updateTerminalSetting("scrollOnKeyPress", v)} />
</SettingRow>
<SettingRow
anchorId="terminal-scroll-on-paste"
label={t("settings.terminal.behavior.scrollOnPaste")}
description={t("settings.terminal.behavior.scrollOnPaste.desc")}
>
<Toggle checked={terminalSettings.scrollOnPaste} onChange={(v) => updateTerminalSetting("scrollOnPaste", v)} />
</SettingRow>
<SettingRow
anchorId="terminal-smooth-scrolling"
label={t("settings.terminal.behavior.smoothScrolling")}
description={t("settings.terminal.behavior.smoothScrolling.desc")}
>
<Toggle checked={terminalSettings.smoothScrolling} onChange={(v) => updateTerminalSetting("smoothScrolling", v)} />
</SettingRow>
<SettingRow
anchorId="terminal-link-browser"
label={t("settings.terminal.behavior.linkBrowser")}
description={t("settings.terminal.behavior.linkBrowser.desc")}
>
<Select
value={terminalSettings.linkBrowser ?? 'netcatty'}
options={[
{ value: 'netcatty', label: t('settings.terminal.behavior.linkBrowser.netcatty') },
{ value: 'system', label: t('settings.terminal.behavior.linkBrowser.system') },
]}
onChange={(v) => updateTerminalSetting('linkBrowser', v as 'netcatty' | 'system')}
className="w-48"
/>
</SettingRow>
<SettingRow
anchorId="terminal-link-modifier"
label={t("settings.terminal.behavior.linkModifier")}
description={t("settings.terminal.behavior.linkModifier.desc")}
>
<Select
value={terminalSettings.linkModifier}
options={[
{ value: "none", label: t("settings.terminal.behavior.linkModifier.none") },
{ value: "ctrl", label: t("settings.terminal.behavior.linkModifier.ctrl") },
{ value: "alt", label: t("settings.terminal.behavior.linkModifier.alt") },
{ value: "meta", label: t("settings.terminal.behavior.linkModifier.meta") },
]}
onChange={(v) => updateTerminalSetting("linkModifier", v as LinkModifier)}
className="w-48"
/>
</SettingRow>
</div>
<SectionHeader title={t("settings.terminal.section.scrollback")} />
<SettingsAnchor anchorId="terminal-scrollback-rows" className="rounded-lg border bg-card p-4">
<p className="text-sm text-muted-foreground mb-3">
{t("settings.terminal.scrollback.desc")}
</p>
<div className="space-y-1">
<Label className="text-xs">{t("settings.terminal.scrollback.rows")}</Label>
<Input
type="number"
min={0}
max={100000}
value={terminalSettings.scrollback}
onChange={(e) => {
const val = parseInt(e.target.value);
if (!isNaN(val) && val >= 0 && val <= 100000) {
updateTerminalSetting("scrollback", val);
}
}}
className="w-full"
/>
</div>
</SettingsAnchor>
<SectionHeader title={t("settings.terminal.section.startupCommand")} />
<SettingsAnchor anchorId="terminal-startup-command-delay" className="rounded-lg border bg-card p-4">
<p className="text-sm text-muted-foreground mb-3">
{t("settings.terminal.startupCommandDelay.desc")}
</p>
<div className="space-y-1">
<Label className="text-xs">{t("settings.terminal.startupCommandDelay.label")}</Label>
<Input
type="number"
min={0}
max={10000}
value={terminalSettings.startupCommandDelayMs}
onChange={(e) => {
const val = parseInt(e.target.value);
if (!isNaN(val) && val >= 0 && val <= 10000) {
updateTerminalSetting("startupCommandDelayMs", val);
}
}}
className="w-full"
/>
</div>
</SettingsAnchor>
</>
);