settingsEditor2.ts 51.4 KB
Newer Older
R
Rob Lourens 已提交
1 2 3 4 5 6
/*---------------------------------------------------------------------------------------------
 *  Copyright (c) Microsoft Corporation. All rights reserved.
 *  Licensed under the MIT License. See License.txt in the project root for license information.
 *--------------------------------------------------------------------------------------------*/

import * as DOM from 'vs/base/browser/dom';
R
Rob Lourens 已提交
7 8
import { StandardKeyboardEvent } from 'vs/base/browser/keyboardEvent';
import { ActionBar } from 'vs/base/browser/ui/actionbar/actionbar';
R
Rob Lourens 已提交
9
import { ITreeElement } from 'vs/base/browser/ui/tree/tree';
R
Rob Lourens 已提交
10
import { Action } from 'vs/base/common/actions';
11
import * as arrays from 'vs/base/common/arrays';
12
import { Delayer, ThrottledDelayer, timeout } from 'vs/base/common/async';
13
import { CancellationToken, CancellationTokenSource } from 'vs/base/common/cancellation';
R
Rob Lourens 已提交
14
import * as collections from 'vs/base/common/collections';
15
import { getErrorMessage, isPromiseCanceledError } from 'vs/base/common/errors';
R
Rob Lourens 已提交
16
import { Iterator } from 'vs/base/common/iterator';
R
Rob Lourens 已提交
17 18
import { KeyCode } from 'vs/base/common/keyCodes';
import * as platform from 'vs/base/common/platform';
P
Peng Lyu 已提交
19
import * as strings from 'vs/base/common/strings';
20
import { isArray, withNullAsUndefined, withUndefinedAsNull } from 'vs/base/common/types';
21
import { URI } from 'vs/base/common/uri';
R
Rob Lourens 已提交
22 23
import 'vs/css!./media/settingsEditor2';
import { localize } from 'vs/nls';
24
import { ConfigurationTarget, IConfigurationOverrides, IConfigurationService } from 'vs/platform/configuration/common/configuration';
R
Rob Lourens 已提交
25
import { IContextKey, IContextKeyService } from 'vs/platform/contextkey/common/contextkey';
R
Rob Lourens 已提交
26
import { IInstantiationService } from 'vs/platform/instantiation/common/instantiation';
R
Rob Lourens 已提交
27
import { IKeybindingService } from 'vs/platform/keybinding/common/keybinding';
28
import { ILogService } from 'vs/platform/log/common/log';
J
Jackson Kearl 已提交
29
import { INotificationService } from 'vs/platform/notification/common/notification';
B
Benjamin Pasero 已提交
30
import { IStorageService, StorageScope } from 'vs/platform/storage/common/storage';
R
Rob Lourens 已提交
31
import { ITelemetryService } from 'vs/platform/telemetry/common/telemetry';
J
Jackson Kearl 已提交
32
import { badgeBackground, badgeForeground, contrastBorder, editorForeground } from 'vs/platform/theme/common/colorRegistry';
33
import { attachStylerCallback } from 'vs/platform/theme/common/styler';
34
import { IThemeService } from 'vs/platform/theme/common/themeService';
R
Rob Lourens 已提交
35
import { BaseEditor } from 'vs/workbench/browser/parts/editor/baseEditor';
36
import { IEditorPane, IEditorMemento } from 'vs/workbench/common/editor';
37
import { attachSuggestEnabledInputBoxStyler, SuggestEnabledInput } from 'vs/workbench/contrib/codeEditor/browser/suggestEnabledInput/suggestEnabledInput';
38 39 40 41 42 43
import { SettingsTarget, SettingsTargetsWidget } from 'vs/workbench/contrib/preferences/browser/preferencesWidgets';
import { commonlyUsedData, tocData } from 'vs/workbench/contrib/preferences/browser/settingsLayout';
import { AbstractSettingRenderer, ISettingLinkClickEvent, ISettingOverrideClickEvent, resolveExtensionsSettings, resolveSettingsTree, SettingsTree, SettingTreeRenderers } from 'vs/workbench/contrib/preferences/browser/settingsTree';
import { ISettingsEditorViewState, parseQuery, SearchResultIdx, SearchResultModel, SettingsTreeElement, SettingsTreeGroupChild, SettingsTreeGroupElement, SettingsTreeModel, SettingsTreeSettingElement } from 'vs/workbench/contrib/preferences/browser/settingsTreeModels';
import { settingsTextInputBorder } from 'vs/workbench/contrib/preferences/browser/settingsWidgets';
import { createTOCIterator, TOCTree, TOCTreeModel } from 'vs/workbench/contrib/preferences/browser/tocTree';
R
Rob Lourens 已提交
44
import { CONTEXT_SETTINGS_EDITOR, CONTEXT_SETTINGS_SEARCH_FOCUS, CONTEXT_TOC_ROW_FOCUS, EXTENSION_SETTING_TAG, IPreferencesSearchService, ISearchProvider, MODIFIED_SETTING_TAG, SETTINGS_EDITOR_COMMAND_CLEAR_SEARCH_RESULTS, SETTINGS_EDITOR_COMMAND_SHOW_CONTEXT_MENU } from 'vs/workbench/contrib/preferences/common/preferences';
45
import { IEditorGroupsService } from 'vs/workbench/services/editor/common/editorGroupsService';
46
import { IPreferencesService, ISearchResult, ISettingsEditorModel, ISettingsEditorOptions, SettingsEditorOptions, SettingValueType } from 'vs/workbench/services/preferences/common/preferences';
47
import { SettingsEditor2Input } from 'vs/workbench/services/preferences/common/preferencesEditorInput';
48
import { Settings2EditorModel } from 'vs/workbench/services/preferences/common/preferencesModels';
M
Matt Bierner 已提交
49
import { IEditorModel } from 'vs/platform/editor/common/editor';
50
import { IStorageKeysSyncRegistryService } from 'vs/platform/userDataSync/common/storageKeys';
R
Rob Lourens 已提交
51

R
Rob Lourens 已提交
52 53 54 55 56 57 58 59 60 61 62 63 64
function createGroupIterator(group: SettingsTreeGroupElement): Iterator<ITreeElement<SettingsTreeGroupChild>> {
	const groupsIt = Iterator.fromArray(group.children);

	return Iterator.map(groupsIt, g => {
		return {
			element: g,
			children: g instanceof SettingsTreeGroupElement ?
				createGroupIterator(g) :
				undefined
		};
	});
}

65 66
const $ = DOM.$;

R
Rob Lourens 已提交
67 68 69 70
interface IFocusEventFromScroll extends KeyboardEvent {
	fromScroll: true;
}

71
const SETTINGS_AUTOSAVE_NOTIFIED_KEY = 'hasNotifiedOfSettingsAutosave';
72
const SETTINGS_EDITOR_STATE_KEY = 'settingsEditorState';
R
Rob Lourens 已提交
73 74
export class SettingsEditor2 extends BaseEditor {

R
Rob Lourens 已提交
75
	static readonly ID: string = 'workbench.editor.settings2';
76
	private static NUM_INSTANCES: number = 0;
G
Guy Waldman 已提交
77 78
	private static SETTING_UPDATE_FAST_DEBOUNCE: number = 200;
	private static SETTING_UPDATE_SLOW_DEBOUNCE: number = 1000;
79
	private static CONFIG_SCHEMA_UPDATE_DELAYER = 500;
R
Rob Lourens 已提交
80

81
	private static readonly SUGGESTIONS: string[] = [
R
Rob Lourens 已提交
82
		`@${MODIFIED_SETTING_TAG}`, '@tag:usesOnlineServices', '@tag:sync', `@${EXTENSION_SETTING_TAG}`
83 84
	];

85 86 87
	private static shouldSettingUpdateFast(type: SettingValueType | SettingValueType[]): boolean {
		if (isArray(type)) {
			// nullable integer/number or complex
G
Guy Waldman 已提交
88
			return false;
89
		}
R
Rob Lourens 已提交
90
		return type === SettingValueType.Enum ||
P
Pine Wu 已提交
91
			type === SettingValueType.ArrayOfString ||
R
Rob Lourens 已提交
92 93 94
			type === SettingValueType.Complex ||
			type === SettingValueType.Boolean ||
			type === SettingValueType.Exclude;
95 96
	}

97 98
	// (!) Lots of props that are set once on the first render
	private defaultSettingsEditorModel!: Settings2EditorModel;
R
Rob Lourens 已提交
99

100 101 102 103
	private rootElement!: HTMLElement;
	private headerContainer!: HTMLElement;
	private searchWidget!: SuggestEnabledInput;
	private countElement!: HTMLElement;
104
	private controlsElement!: HTMLElement;
105
	private settingsTargetsWidget!: SettingsTargetsWidget;
R
Rob Lourens 已提交
106

107 108 109 110 111 112 113
	private settingsTreeContainer!: HTMLElement;
	private settingsTree!: SettingsTree;
	private settingRenderers!: SettingTreeRenderers;
	private tocTreeModel!: TOCTreeModel;
	private settingsTreeModel!: SettingsTreeModel;
	private noResultsMessage!: HTMLElement;
	private clearFilterLinkContainer!: HTMLElement;
R
Rob Lourens 已提交
114

115 116
	private tocTreeContainer!: HTMLElement;
	private tocTree!: TOCTree;
R
Rob Lourens 已提交
117

118
	private settingsAriaExtraLabelsContainer!: HTMLElement;
119

R
Rob Lourens 已提交
120 121 122
	private delayedFilterLogging: Delayer<void>;
	private localSearchDelayer: Delayer<void>;
	private remoteSearchThrottle: ThrottledDelayer<void>;
123
	private searchInProgress: CancellationTokenSource | null = null;
124

125 126
	private updatedConfigSchemaDelayer: Delayer<void>;

127 128
	private settingFastUpdateDelayer: Delayer<void>;
	private settingSlowUpdateDelayer: Delayer<void>;
129
	private pendingSettingUpdate: { key: string, value: any } | null = null;
R
Rob Lourens 已提交
130

131
	private readonly viewState: ISettingsEditorViewState;
132
	private _searchResultModel: SearchResultModel | null = null;
133

134
	private tocRowFocused: IContextKey<boolean>;
135 136
	private inSettingsEditorContextKey: IContextKey<boolean>;
	private searchFocusContextKey: IContextKey<boolean>;
137

138
	private scheduledRefreshes: Map<string, DOM.IFocusTracker>;
139
	private lastFocusedSettingElement: string | null = null;
140

141
	/** Don't spam warnings */
142
	private hasWarnedMissingSettings = false;
143

144 145
	private editorMemento: IEditorMemento<ISettingsEditor2State>;

146
	private tocFocusedElement: SettingsTreeGroupElement | null = null;
147
	private settingsTreeScrollTop = 0;
148
	private dimension!: DOM.Dimension;
149

R
Rob Lourens 已提交
150 151
	constructor(
		@ITelemetryService telemetryService: ITelemetryService,
152
		@IConfigurationService private readonly configurationService: IConfigurationService,
R
Rob Lourens 已提交
153
		@IThemeService themeService: IThemeService,
154 155 156 157
		@IPreferencesService private readonly preferencesService: IPreferencesService,
		@IInstantiationService private readonly instantiationService: IInstantiationService,
		@IPreferencesSearchService private readonly preferencesSearchService: IPreferencesSearchService,
		@ILogService private readonly logService: ILogService,
158
		@IContextKeyService contextKeyService: IContextKeyService,
159 160
		@IStorageService private readonly storageService: IStorageService,
		@INotificationService private readonly notificationService: INotificationService,
161
		@IEditorGroupsService protected editorGroupService: IEditorGroupsService,
162 163
		@IKeybindingService private readonly keybindingService: IKeybindingService,
		@IStorageKeysSyncRegistryService storageKeysSyncRegistryService: IStorageKeysSyncRegistryService,
R
Rob Lourens 已提交
164
	) {
165
		super(SettingsEditor2.ID, telemetryService, themeService, storageService);
R
Rob Lourens 已提交
166
		this.delayedFilterLogging = new Delayer<void>(1000);
167
		this.localSearchDelayer = new Delayer(300);
168
		this.remoteSearchThrottle = new ThrottledDelayer(200);
R
Rob Lourens 已提交
169
		this.viewState = { settingsTarget: ConfigurationTarget.USER_LOCAL };
R
Rob Lourens 已提交
170

171 172
		this.settingFastUpdateDelayer = new Delayer<void>(SettingsEditor2.SETTING_UPDATE_FAST_DEBOUNCE);
		this.settingSlowUpdateDelayer = new Delayer<void>(SettingsEditor2.SETTING_UPDATE_SLOW_DEBOUNCE);
173

174 175
		this.updatedConfigSchemaDelayer = new Delayer<void>(SettingsEditor2.CONFIG_SCHEMA_UPDATE_DELAYER);

176 177
		this.inSettingsEditorContextKey = CONTEXT_SETTINGS_EDITOR.bindTo(contextKeyService);
		this.searchFocusContextKey = CONTEXT_SETTINGS_SEARCH_FOCUS.bindTo(contextKeyService);
178
		this.tocRowFocused = CONTEXT_TOC_ROW_FOCUS.bindTo(contextKeyService);
179

180 181
		this.scheduledRefreshes = new Map<string, DOM.IFocusTracker>();

B
Benjamin Pasero 已提交
182
		this.editorMemento = this.getEditorMemento<ISettingsEditor2State>(editorGroupService, SETTINGS_EDITOR_STATE_KEY);
183

184
		this._register(configurationService.onDidChangeConfiguration(e => {
185 186 187
			if (e.source !== ConfigurationTarget.DEFAULT) {
				this.onConfigUpdate(e.affectedKeys);
			}
188
		}));
189 190

		storageKeysSyncRegistryService.registerStorageKey({ key: SETTINGS_AUTOSAVE_NOTIFIED_KEY, version: 1 });
R
Rob Lourens 已提交
191 192
	}

193 194 195 196 197 198 199
	get minimumWidth(): number { return 375; }
	get maximumWidth(): number { return Number.POSITIVE_INFINITY; }

	// these setters need to exist because this extends from BaseEditor
	set minimumWidth(value: number) { /*noop*/ }
	set maximumWidth(value: number) { /*noop*/ }

R
Rob Lourens 已提交
200 201 202 203
	private get currentSettingsModel() {
		return this.searchResultModel || this.settingsTreeModel;
	}

R
Rob Lourens 已提交
204
	private get searchResultModel(): SearchResultModel | null {
205 206 207
		return this._searchResultModel;
	}

R
Rob Lourens 已提交
208
	private set searchResultModel(value: SearchResultModel | null) {
209 210 211 212 213
		this._searchResultModel = value;

		DOM.toggleClass(this.rootElement, 'search-mode', !!this._searchResultModel);
	}

R
Rob Lourens 已提交
214 215 216
	private get currentSettingsContextMenuKeyBindingLabel(): string {
		const keybinding = this.keybindingService.lookupKeybinding(SETTINGS_EDITOR_COMMAND_SHOW_CONTEXT_MENU);
		return (keybinding && keybinding.getAriaLabel()) || '';
217 218
	}

R
Rob Lourens 已提交
219
	createEditor(parent: HTMLElement): void {
220
		parent.setAttribute('tabindex', '-1');
R
Rob Lourens 已提交
221
		this.rootElement = DOM.append(parent, $('.settings-editor', { tabindex: '-1' }));
R
Rob Lourens 已提交
222

223 224
		this.createHeader(this.rootElement);
		this.createBody(this.rootElement);
R
Rob Lourens 已提交
225
		this.addCtrlAInterceptor(this.rootElement);
226
		this.updateStyles();
R
Rob Lourens 已提交
227 228
	}

229
	setInput(input: SettingsEditor2Input, options: SettingsEditorOptions | undefined, token: CancellationToken): Promise<void> {
230
		this.inSettingsEditorContextKey.set(true);
231
		return super.setInput(input, options, token)
232
			.then(() => timeout(0)) // Force setInput to be async
R
Rob Lourens 已提交
233
			.then(() => {
234 235 236 237 238 239 240 241
				// Don't block setInput on render (which can trigger an async search)
				this.render(token).then(() => {
					options = options || SettingsEditorOptions.create({});

					if (!this.viewState.settingsTarget) {
						if (!options.target) {
							options.target = ConfigurationTarget.USER_LOCAL;
						}
242
					}
R
Rob Lourens 已提交
243

244
					this._setOptions(options);
245

246 247 248
					this._register(input.onDispose(() => {
						this.searchWidget.setValue('');
					}));
249

250 251 252
					// Init TOC selection
					this.updateTreeScrollSync();
				});
R
Rob Lourens 已提交
253
			});
R
Rob Lourens 已提交
254 255
	}

256
	private restoreCachedState(): ISettingsEditor2State | null {
R
Rob Lourens 已提交
257
		const cachedState = this.group && this.input && this.editorMemento.loadEditorState(this.group, this.input);
258
		if (cachedState && typeof cachedState.target === 'object') {
259 260 261 262 263 264
			cachedState.target = URI.revive(cachedState.target);
		}

		if (cachedState) {
			const settingsTarget = cachedState.target;
			this.settingsTargetsWidget.settingsTarget = settingsTarget;
265
			this.viewState.settingsTarget = settingsTarget;
266 267
			this.searchWidget.setValue(cachedState.searchQuery);
		}
268 269 270 271 272 273

		if (this.input) {
			this.editorMemento.clearEditorState(this.input, this.group);
		}

		return withUndefinedAsNull(cachedState);
274 275
	}

276
	setOptions(options: SettingsEditorOptions | undefined): void {
277 278
		super.setOptions(options);

R
Rob Lourens 已提交
279 280 281
		if (options) {
			this._setOptions(options);
		}
282
	}
283

284
	private _setOptions(options: SettingsEditorOptions): void {
285 286 287 288
		if (options.query) {
			this.searchWidget.setValue(options.query);
		}

289
		const target: SettingsTarget = options.folderUri || <SettingsTarget>options.target;
R
Rob Lourens 已提交
290 291 292 293
		if (target) {
			this.settingsTargetsWidget.settingsTarget = target;
			this.viewState.settingsTarget = target;
		}
294 295
	}

296 297 298 299 300
	clearInput(): void {
		this.inSettingsEditorContextKey.set(false);
		super.clearInput();
	}

R
Rob Lourens 已提交
301
	layout(dimension: DOM.Dimension): void {
302
		this.dimension = dimension;
J
Joao Moreno 已提交
303 304 305 306 307

		if (!this.isVisible()) {
			return;
		}

308 309
		this.layoutTrees(dimension);

310
		const innerWidth = Math.min(1000, dimension.width) - 24 * 2; // 24px padding on left and right;
311 312
		// minus padding inside inputbox, countElement width, controls width, extra padding before countElement
		const monacoWidth = innerWidth - 10 - this.countElement.clientWidth - this.controlsElement.clientWidth - 12;
313 314
		this.searchWidget.layout({ height: 20, width: monacoWidth });

315 316
		DOM.toggleClass(this.rootElement, 'mid-width', dimension.width < 1000 && dimension.width >= 600);
		DOM.toggleClass(this.rootElement, 'narrow-width', dimension.width < 600);
R
Rob Lourens 已提交
317 318 319
	}

	focus(): void {
R
Rob Lourens 已提交
320
		if (this.lastFocusedSettingElement) {
R
Rob Lourens 已提交
321
			const elements = this.settingRenderers.getDOMElementsForSettingKey(this.settingsTree.getHTMLElement(), this.lastFocusedSettingElement);
R
Rob Lourens 已提交
322
			if (elements.length) {
R
Rob Lourens 已提交
323
				const control = elements[0].querySelector(AbstractSettingRenderer.CONTROL_SELECTOR);
R
Rob Lourens 已提交
324 325 326 327 328 329 330
				if (control) {
					(<HTMLElement>control).focus();
					return;
				}
			}
		}

331 332 333
		this.focusSearch();
	}

334 335 336 337
	onHide(): void {
		this.searchWidget.onHide();
	}

338
	focusSettings(): void {
339 340 341 342 343
		// Update ARIA global labels
		const labelElement = this.settingsAriaExtraLabelsContainer.querySelector('#settings_aria_more_actions_shortcut_label');
		if (labelElement) {
			const settingsContextMenuShortcut = this.currentSettingsContextMenuKeyBindingLabel;
			if (settingsContextMenuShortcut) {
344
				labelElement.setAttribute('aria-label', localize('settingsContextMenuAriaShortcut', "For more actions, Press {0}.", settingsContextMenuShortcut));
345 346 347
			}
		}

R
Rob Lourens 已提交
348
		const firstFocusable = this.settingsTree.getHTMLElement().querySelector(AbstractSettingRenderer.CONTROL_SELECTOR);
349 350
		if (firstFocusable) {
			(<HTMLElement>firstFocusable).focus();
351 352 353
		}
	}

R
Rob Lourens 已提交
354 355 356 357
	focusTOC(): void {
		this.tocTree.domFocus();
	}

358
	showContextMenu(): void {
R
Rob Lourens 已提交
359 360 361 362 363 364
		const activeElement = this.getActiveElementInSettingsTree();
		if (!activeElement) {
			return;
		}

		const settingDOMElement = this.settingRenderers.getSettingDOMElementForDOMElement(activeElement);
365 366 367 368
		if (!settingDOMElement) {
			return;
		}

R
Rob Lourens 已提交
369
		const focusedKey = this.settingRenderers.getKeyForDOMElementInSetting(settingDOMElement);
370 371 372 373 374 375
		if (!focusedKey) {
			return;
		}

		const elements = this.currentSettingsModel.getElementsByName(focusedKey);
		if (elements && elements[0]) {
R
Rob Lourens 已提交
376
			this.settingRenderers.showContextMenu(elements[0], settingDOMElement);
377 378 379
		}
	}

380
	focusSearch(filter?: string, selectAll = true): void {
381 382 383 384
		if (filter && this.searchWidget) {
			this.searchWidget.setValue(filter);
		}

385
		this.searchWidget.focus(selectAll);
R
Rob Lourens 已提交
386 387
	}

388
	clearSearchResults(): void {
389
		this.searchWidget.setValue('');
390
		this.focusSearch();
391 392
	}

393 394 395 396 397 398 399 400 401 402
	clearSearchFilters(): void {
		let query = this.searchWidget.getValue();

		SettingsEditor2.SUGGESTIONS.forEach(suggestion => {
			query = query.replace(suggestion, '');
		});

		this.searchWidget.setValue(query.trim());
	}

R
Rob Lourens 已提交
403 404 405 406
	private createHeader(parent: HTMLElement): void {
		this.headerContainer = DOM.append(parent, $('.settings-header'));

		const searchContainer = DOM.append(this.headerContainer, $('.search-container'));
407

408
		const clearInputAction = new Action(SETTINGS_EDITOR_COMMAND_CLEAR_SEARCH_RESULTS, localize('clearInput', "Clear Settings Search Input"), 'codicon-clear-all', false, () => { this.clearSearchResults(); return Promise.resolve(null); });
409

R
Rob Lourens 已提交
410
		const searchBoxLabel = localize('SearchSettings.AriaLabel', "Search settings");
411 412 413
		this.searchWidget = this._register(this.instantiationService.createInstance(SuggestEnabledInput, `${SettingsEditor2.ID}.searchbox`, searchContainer, {
			triggerCharacters: ['@'],
			provideResults: (query: string) => {
P
Peng Lyu 已提交
414
				return SettingsEditor2.SUGGESTIONS.filter(tag => query.indexOf(tag) === -1).map(tag => strings.endsWith(tag, ':') ? tag : tag + ' ');
415
			}
416
		}, searchBoxLabel, 'settingseditor:searchinput' + SettingsEditor2.NUM_INSTANCES++, {
M
Matt Bierner 已提交
417 418 419 420
			placeholderText: searchBoxLabel,
			focusContextKey: this.searchFocusContextKey,
			// TODO: Aria-live
		})
J
Jeremy Shore 已提交
421
		);
422

423 424 425 426
		this._register(this.searchWidget.onFocus(() => {
			this.lastFocusedSettingElement = '';
		}));

427 428 429 430
		this._register(attachSuggestEnabledInputBoxStyler(this.searchWidget, this.themeService, {
			inputBorder: settingsTextInputBorder
		}));

431 432
		this.countElement = DOM.append(searchContainer, DOM.$('.settings-count-widget'));
		this._register(attachStylerCallback(this.themeService, { badgeBackground, contrastBorder, badgeForeground }, colors => {
433 434 435
			const background = colors.badgeBackground ? colors.badgeBackground.toString() : '';
			const border = colors.contrastBorder ? colors.contrastBorder.toString() : '';
			const foreground = colors.badgeForeground ? colors.badgeForeground.toString() : '';
436 437

			this.countElement.style.backgroundColor = background;
R
Rob Lourens 已提交
438
			this.countElement.style.color = foreground;
439

440 441
			this.countElement.style.borderWidth = border ? '1px' : '';
			this.countElement.style.borderStyle = border ? 'solid' : '';
442 443 444
			this.countElement.style.borderColor = border;
		}));

445 446 447 448 449
		this._register(this.searchWidget.onInputDidChange(() => {
			const searchVal = this.searchWidget.getValue();
			clearInputAction.enabled = !!searchVal;
			this.onSearchInputChanged();
		}));
R
Rob Lourens 已提交
450

451
		const headerControlsContainer = DOM.append(this.headerContainer, $('.settings-header-controls'));
R
Rob Lourens 已提交
452
		const targetWidgetContainer = DOM.append(headerControlsContainer, $('.settings-target-container'));
R
Rob Lourens 已提交
453 454
		this.settingsTargetsWidget = this._register(this.instantiationService.createInstance(SettingsTargetsWidget, targetWidgetContainer, { enableRemoteSettings: true }));
		this.settingsTargetsWidget.settingsTarget = ConfigurationTarget.USER_LOCAL;
455
		this.settingsTargetsWidget.onDidTargetChange(target => this.onDidSettingsTargetChange(target));
456

457
		this.controlsElement = DOM.append(searchContainer, DOM.$('.settings-clear-widget'));
458

459
		const actionBar = this._register(new ActionBar(this.controlsElement, {
460
			animated: false,
M
Matt Bierner 已提交
461
			actionViewItemProvider: (_action) => { return undefined; }
462 463
		}));

464
		actionBar.push([clearInputAction], { label: false, icon: true });
R
Rob Lourens 已提交
465 466
	}

467 468 469
	private onDidSettingsTargetChange(target: SettingsTarget): void {
		this.viewState.settingsTarget = target;

470 471
		// TODO Instead of rebuilding the whole model, refresh and uncache the inspected setting value
		this.onConfigUpdate(undefined, true);
472 473
	}

474
	private onDidClickSetting(evt: ISettingLinkClickEvent, recursed?: boolean): void {
475
		const elements = this.currentSettingsModel.getElementsByName(evt.targetKey);
476
		if (elements && elements[0]) {
477
			let sourceTop = this.settingsTree.getRelativeTop(evt.source);
R
Rob Lourens 已提交
478 479 480 481
			if (typeof sourceTop !== 'number') {
				return;
			}

482 483
			if (sourceTop < 0) {
				// e.g. clicked a searched element, now the search has been cleared
484
				sourceTop = 0.5;
485 486
			}

487
			this.settingsTree.reveal(elements[0], sourceTop);
488

R
Rob Lourens 已提交
489
			const domElements = this.settingRenderers.getDOMElementsForSettingKey(this.settingsTree.getHTMLElement(), evt.targetKey);
490
			if (domElements && domElements[0]) {
R
Rob Lourens 已提交
491
				const control = domElements[0].querySelector(AbstractSettingRenderer.CONTROL_SELECTOR);
492 493 494 495
				if (control) {
					(<HTMLElement>control).focus();
				}
			}
496 497 498 499 500 501
		} else if (!recursed) {
			const p = this.triggerSearch('');
			p.then(() => {
				this.searchWidget.setValue('');
				this.onDidClickSetting(evt, true);
			});
502 503 504
		}
	}

505
	switchToSettingsFile(): Promise<IEditorPane | undefined> {
506 507
		const query = parseQuery(this.searchWidget.getValue()).query;
		return this.openSettingsFile({ query });
508 509
	}

510
	private async openSettingsFile(options?: ISettingsEditorOptions): Promise<IEditorPane | undefined> {
511 512
		const currentSettingsTarget = this.settingsTargetsWidget.settingsTarget;

R
Rob Lourens 已提交
513
		if (currentSettingsTarget === ConfigurationTarget.USER_LOCAL) {
514
			return this.preferencesService.openGlobalSettings(true, options);
R
Rob Lourens 已提交
515 516
		} else if (currentSettingsTarget === ConfigurationTarget.USER_REMOTE) {
			return this.preferencesService.openRemoteSettings();
517
		} else if (currentSettingsTarget === ConfigurationTarget.WORKSPACE) {
518
			return this.preferencesService.openWorkspaceSettings(true, options);
519
		} else if (URI.isUri(currentSettingsTarget)) {
520
			return this.preferencesService.openFolderSettings(currentSettingsTarget, true, options);
521
		}
522 523

		return undefined;
R
Rob Lourens 已提交
524 525 526 527 528
	}

	private createBody(parent: HTMLElement): void {
		const bodyContainer = DOM.append(parent, $('.settings-body'));

R
Rob Lourens 已提交
529
		this.noResultsMessage = DOM.append(bodyContainer, $('.no-results-message'));
530

531
		this.noResultsMessage.innerText = localize('noResults', "No Settings Found");
532 533 534 535 536

		this.clearFilterLinkContainer = $('span.clear-search-filters');

		this.clearFilterLinkContainer.textContent = ' - ';
		const clearFilterLink = DOM.append(this.clearFilterLinkContainer, $('a.pointer.prominent', { tabindex: 0 }, localize('clearSearchFilters', 'Clear Filters')));
537
		this._register(DOM.addDisposableListener(clearFilterLink, DOM.EventType.CLICK, (e: MouseEvent) => {
538 539 540 541 542 543
			DOM.EventHelper.stop(e, false);
			this.clearSearchFilters();
		}));

		DOM.append(this.noResultsMessage, this.clearFilterLinkContainer);

544
		this._register(attachStylerCallback(this.themeService, { editorForeground }, colors => {
M
Matt Bierner 已提交
545
			this.noResultsMessage.style.color = colors.editorForeground ? colors.editorForeground.toString() : '';
546 547
		}));

R
Rob Lourens 已提交
548 549
		this.createTOC(bodyContainer);

550 551 552
		this.createFocusSink(
			bodyContainer,
			e => {
J
Joao Moreno 已提交
553
				if (DOM.findParentWithClass(e.relatedTarget, 'settings-editor-tree')) {
554
					if (this.settingsTree.scrollTop > 0) {
555
						const firstElement = this.settingsTree.firstVisibleElement;
J
Joao Moreno 已提交
556 557 558 559 560

						if (typeof firstElement !== 'undefined') {
							this.settingsTree.reveal(firstElement, 0.1);
						}

561 562 563 564 565 566 567 568 569 570 571 572
						return true;
					}
				} else {
					const firstControl = this.settingsTree.getHTMLElement().querySelector(AbstractSettingRenderer.CONTROL_SELECTOR);
					if (firstControl) {
						(<HTMLElement>firstControl).focus();
					}
				}

				return false;
			},
			'settings list focus helper');
R
Rob Lourens 已提交
573

R
Rob Lourens 已提交
574
		this.createSettingsTree(bodyContainer);
R
Rob Lourens 已提交
575

576 577 578
		this.createFocusSink(
			bodyContainer,
			e => {
J
Joao Moreno 已提交
579
				if (DOM.findParentWithClass(e.relatedTarget, 'settings-editor-tree')) {
580
					if (this.settingsTree.scrollTop < this.settingsTree.scrollHeight) {
581
						const lastElement = this.settingsTree.lastVisibleElement;
582 583 584 585 586 587 588 589 590 591 592
						this.settingsTree.reveal(lastElement, 0.9);
						return true;
					}
				}

				return false;
			},
			'settings list focus helper'
		);
	}

R
Rob Lourens 已提交
593 594 595 596 597 598 599 600 601 602 603 604 605 606 607
	private addCtrlAInterceptor(container: HTMLElement): void {
		this._register(DOM.addStandardDisposableListener(container, DOM.EventType.KEY_DOWN, (e: StandardKeyboardEvent) => {
			if (
				e.keyCode === KeyCode.KEY_A &&
				(platform.isMacintosh ? e.metaKey : e.ctrlKey) &&
				e.target.tagName !== 'TEXTAREA' &&
				e.target.tagName !== 'INPUT'
			) {
				// Avoid browser ctrl+a
				e.browserEvent.stopPropagation();
				e.browserEvent.preventDefault();
			}
		}));
	}

608 609 610 611 612 613 614 615 616 617 618 619
	private createFocusSink(container: HTMLElement, callback: (e: any) => boolean, label: string): HTMLElement {
		const listFocusSink = DOM.append(container, $('.settings-tree-focus-sink'));
		listFocusSink.setAttribute('aria-label', label);
		listFocusSink.tabIndex = 0;
		this._register(DOM.addDisposableListener(listFocusSink, 'focus', (e: any) => {
			if (e.relatedTarget && callback(e)) {
				e.relatedTarget.focus();
			}
		}));

		return listFocusSink;
	}
620

R
Rob Lourens 已提交
621
	private createTOC(parent: HTMLElement): void {
622
		this.tocTreeModel = this.instantiationService.createInstance(TOCTreeModel, this.viewState);
R
Rob Lourens 已提交
623 624
		this.tocTreeContainer = DOM.append(parent, $('.settings-toc-container'));

625 626
		this.tocTree = this._register(this.instantiationService.createInstance(TOCTree,
			DOM.append(this.tocTreeContainer, $('.settings-toc-wrapper')),
R
Rob Lourens 已提交
627
			this.viewState));
R
Rob Lourens 已提交
628

629
		this._register(this.tocTree.onDidChangeFocus(e => {
R
Rob Lourens 已提交
630
			const element: SettingsTreeGroupElement | null = e.elements[0];
R
Rob Lourens 已提交
631 632 633
			if (this.tocFocusedElement === element) {
				return;
			}
634

R
Rob Lourens 已提交
635 636 637 638
			this.tocFocusedElement = element;
			this.tocTree.setSelection(element ? [element] : []);
			if (this.searchResultModel) {
				if (this.viewState.filterToCategory !== element) {
639
					this.viewState.filterToCategory = withNullAsUndefined(element);
640 641
					this.renderTree();
					this.settingsTree.scrollTop = 0;
R
Rob Lourens 已提交
642
				}
R
Rob Lourens 已提交
643
			} else if (element && (!e.browserEvent || !(<IFocusEventFromScroll>e.browserEvent).fromScroll)) {
R
Rob Lourens 已提交
644 645
				this.settingsTree.reveal(element, 0);
			}
646 647 648 649 650 651 652 653
		}));

		this._register(this.tocTree.onDidFocus(() => {
			this.tocRowFocused.set(true);
		}));

		this._register(this.tocTree.onDidBlur(() => {
			this.tocRowFocused.set(false);
R
Rob Lourens 已提交
654 655 656 657
		}));
	}

	private createSettingsTree(parent: HTMLElement): void {
658
		this.settingsTreeContainer = DOM.append(parent, $('.settings-tree-container'));
R
Rob Lourens 已提交
659

660 661 662 663 664 665 666 667
		// Add  ARIA extra labels div
		this.settingsAriaExtraLabelsContainer = DOM.append(this.settingsTreeContainer, $('.settings-aria-extra-labels'));
		this.settingsAriaExtraLabelsContainer.id = 'settings_aria_extra_labels';
		// Add global labels here
		const labelDiv = DOM.append(this.settingsAriaExtraLabelsContainer, $('.settings-aria-extra-label'));
		labelDiv.id = 'settings_aria_more_actions_shortcut_label';
		labelDiv.setAttribute('aria-label', '');

R
Rob Lourens 已提交
668 669 670
		this.settingRenderers = this.instantiationService.createInstance(SettingTreeRenderers);
		this._register(this.settingRenderers.onDidChangeSetting(e => this.onDidChangeSetting(e.key, e.value, e.type)));
		this._register(this.settingRenderers.onDidOpenSettings(settingKey => {
671
			this.openSettingsFile({ editSetting: settingKey });
672
		}));
R
Rob Lourens 已提交
673 674
		this._register(this.settingRenderers.onDidClickSettingLink(settingName => this.onDidClickSetting(settingName)));
		this._register(this.settingRenderers.onDidFocusSetting(element => {
R
Rob Lourens 已提交
675
			this.lastFocusedSettingElement = element.setting.key;
676 677
			this.settingsTree.reveal(element);
		}));
R
Rob Lourens 已提交
678
		this._register(this.settingRenderers.onDidClickOverrideElement((element: ISettingOverrideClickEvent) => {
679
			if (element.scope.toLowerCase() === 'workspace') {
J
Jeremy Shore 已提交
680
				this.settingsTargetsWidget.updateTarget(ConfigurationTarget.WORKSPACE);
681
			} else if (element.scope.toLowerCase() === 'user') {
R
Rob Lourens 已提交
682
				this.settingsTargetsWidget.updateTarget(ConfigurationTarget.USER_LOCAL);
683
			} else if (element.scope.toLowerCase() === 'remote') {
R
Rob Lourens 已提交
684
				this.settingsTargetsWidget.updateTarget(ConfigurationTarget.USER_REMOTE);
J
Jeremy Shore 已提交
685 686 687 688
			}

			this.searchWidget.setValue(element.targetKey);
		}));
689

690
		this.settingsTree = this._register(this.instantiationService.createInstance(SettingsTree,
691 692
			this.settingsTreeContainer,
			this.viewState,
R
Rob Lourens 已提交
693
			this.settingRenderers.allRenderers));
R
Rob Lourens 已提交
694
		this.settingsTree.getHTMLElement().attributes.removeNamedItem('tabindex');
695

696
		this._register(this.settingsTree.onDidScroll(() => {
697 698 699 700 701 702 703 704 705 706 707
			if (this.settingsTree.scrollTop === this.settingsTreeScrollTop) {
				return;
			}

			this.settingsTreeScrollTop = this.settingsTree.scrollTop;

			// setTimeout because calling setChildren on the settingsTree can trigger onDidScroll, so it fires when
			// setChildren has called on the settings tree but not the toc tree yet, so their rendered elements are out of sync
			setTimeout(() => {
				this.updateTreeScrollSync();
			}, 0);
708
		}));
709 710
	}

B
Benjamin Pasero 已提交
711
	private notifyNoSaveNeeded() {
712 713
		if (!this.storageService.getBoolean(SETTINGS_AUTOSAVE_NOTIFIED_KEY, StorageScope.GLOBAL, false)) {
			this.storageService.store(SETTINGS_AUTOSAVE_NOTIFIED_KEY, true, StorageScope.GLOBAL);
714 715
			this.notificationService.info(localize('settingsNoSaveNeeded', "Your changes are automatically saved as you edit."));
		}
J
Jackson Kearl 已提交
716 717
	}

718
	private onDidChangeSetting(key: string, value: any, type: SettingValueType | SettingValueType[]): void {
B
Benjamin Pasero 已提交
719
		this.notifyNoSaveNeeded();
720

721 722
		if (this.pendingSettingUpdate && this.pendingSettingUpdate.key !== key) {
			this.updateChangedSetting(key, value);
723 724
		}

725
		this.pendingSettingUpdate = { key, value };
726 727 728 729 730
		if (SettingsEditor2.shouldSettingUpdateFast(type)) {
			this.settingFastUpdateDelayer.trigger(() => this.updateChangedSetting(key, value));
		} else {
			this.settingSlowUpdateDelayer.trigger(() => this.updateChangedSetting(key, value));
		}
731 732
	}

733
	private updateTreeScrollSync(): void {
R
Rob Lourens 已提交
734
		this.settingRenderers.cancelSuggesters();
735 736 737 738
		if (this.searchResultModel) {
			return;
		}

R
Rob Lourens 已提交
739
		if (!this.tocTreeModel) {
740 741
			return;
		}
742

743
		const elementToSync = this.settingsTree.firstVisibleElement;
744 745 746 747
		const element = elementToSync instanceof SettingsTreeSettingElement ? elementToSync.parent :
			elementToSync instanceof SettingsTreeGroupElement ? elementToSync :
				null;

R
Rob Lourens 已提交
748 749 750 751 752 753 754 755
		// It's possible for this to be called when the TOC and settings tree are out of sync - e.g. when the settings tree has deferred a refresh because
		// it is focused. So, bail if element doesn't exist in the TOC.
		let nodeExists = true;
		try { this.tocTree.getNode(element); } catch (e) { nodeExists = false; }
		if (!nodeExists) {
			return;
		}

756 757 758 759 760 761
		if (element && this.tocTree.getSelection()[0] !== element) {
			const ancestors = this.getAncestors(element);
			ancestors.forEach(e => this.tocTree.expand(<SettingsTreeGroupElement>e));

			this.tocTree.reveal(element);
			const elementTop = this.tocTree.getRelativeTop(element);
R
Rob Lourens 已提交
762 763 764 765
			if (typeof elementTop !== 'number') {
				return;
			}

766 767 768 769 770 771 772 773 774 775
			this.tocTree.collapseAll();

			ancestors.forEach(e => this.tocTree.expand(<SettingsTreeGroupElement>e));
			if (elementTop < 0 || elementTop > 1) {
				this.tocTree.reveal(element);
			} else {
				this.tocTree.reveal(element, elementTop);
			}

			this.tocTree.expand(element);
R
Rob Lourens 已提交
776

777
			this.tocTree.setSelection([element]);
778

779
			const fakeKeyboardEvent = new KeyboardEvent('keydown');
R
Rob Lourens 已提交
780
			(<IFocusEventFromScroll>fakeKeyboardEvent).fromScroll = true;
781 782 783
			this.tocTree.setFocus([element], fakeKeyboardEvent);
		}
	}
784

785 786 787 788 789 790 791 792 793 794
	private getAncestors(element: SettingsTreeElement): SettingsTreeElement[] {
		const ancestors: any[] = [];

		while (element.parent) {
			if (element.parent.id !== 'root') {
				ancestors.push(element.parent);
			}

			element = element.parent;
		}
795

796
		return ancestors.reverse();
797 798
	}

J
Johannes Rieken 已提交
799
	private updateChangedSetting(key: string, value: any): Promise<void> {
800 801
		// ConfigurationService displays the error if this fails.
		// Force a render afterwards because onDidConfigurationUpdate doesn't fire if the update doesn't result in an effective setting value change
R
Rob Lourens 已提交
802 803
		const settingsTarget = this.settingsTargetsWidget.settingsTarget;
		const resource = URI.isUri(settingsTarget) ? settingsTarget : undefined;
804
		const configurationTarget = <ConfigurationTarget>(resource ? ConfigurationTarget.WORKSPACE_FOLDER : settingsTarget);
R
Rob Lourens 已提交
805 806
		const overrides: IConfigurationOverrides = { resource };

807 808
		const isManualReset = value === undefined;

R
Rob Lourens 已提交
809 810
		// If the user is changing the value back to the default, do a 'reset' instead
		const inspected = this.configurationService.inspect(key, overrides);
S
rename  
Sandeep Somavarapu 已提交
811
		if (inspected.defaultValue === value) {
R
Rob Lourens 已提交
812 813 814 815
			value = undefined;
		}

		return this.configurationService.updateValue(key, value, overrides, configurationTarget)
816
			.then(() => {
817
				this.renderTree(key, isManualReset);
818 819 820 821 822
				const reportModifiedProps = {
					key,
					query: this.searchWidget.getValue(),
					searchResults: this.searchResultModel && this.searchResultModel.getUniqueResults(),
					rawResults: this.searchResultModel && this.searchResultModel.getRawResults(),
823
					showConfiguredOnly: !!this.viewState.tagFilters && this.viewState.tagFilters.has(MODIFIED_SETTING_TAG),
824 825 826 827 828 829
					isReset: typeof value === 'undefined',
					settingsTarget: this.settingsTargetsWidget.settingsTarget as SettingsTarget
				};

				return this.reportModifiedSetting(reportModifiedProps);
			});
830 831
	}

R
Rob Lourens 已提交
832
	private reportModifiedSetting(props: { key: string, query: string, searchResults: ISearchResult[] | null, rawResults: ISearchResult[] | null, showConfiguredOnly: boolean, isReset: boolean, settingsTarget: SettingsTarget }): void {
833
		this.pendingSettingUpdate = null;
834

R
Rob Lourens 已提交
835 836 837
		let groupId: string | undefined = undefined;
		let nlpIndex: number | undefined = undefined;
		let displayIndex: number | undefined = undefined;
838
		if (props.searchResults) {
R
Rob Lourens 已提交
839 840 841 842
			const remoteResult = props.searchResults[SearchResultIdx.Remote];
			const localResult = props.searchResults[SearchResultIdx.Local];

			const localIndex = arrays.firstIndex(localResult!.filterMatches, m => m.setting.key === props.key);
843 844 845 846 847 848 849 850
			groupId = localIndex >= 0 ?
				'local' :
				'remote';

			displayIndex = localIndex >= 0 ?
				localIndex :
				remoteResult && (arrays.firstIndex(remoteResult.filterMatches, m => m.setting.key === props.key) + localResult.filterMatches.length);

851 852 853 854 855 856
			if (this.searchResultModel) {
				const rawResults = this.searchResultModel.getRawResults();
				if (rawResults[SearchResultIdx.Remote]) {
					const _nlpIndex = arrays.firstIndex(rawResults[SearchResultIdx.Remote].filterMatches, m => m.setting.key === props.key);
					nlpIndex = _nlpIndex >= 0 ? _nlpIndex : undefined;
				}
857 858 859
			}
		}

R
Rob Lourens 已提交
860 861 862 863
		const reportedTarget = props.settingsTarget === ConfigurationTarget.USER_LOCAL ? 'user' :
			props.settingsTarget === ConfigurationTarget.USER_REMOTE ? 'user_remote' :
				props.settingsTarget === ConfigurationTarget.WORKSPACE ? 'workspace' :
					'folder';
864 865 866 867 868 869 870 871 872 873 874 875 876

		const data = {
			key: props.key,
			query: props.query,
			groupId,
			nlpIndex,
			displayIndex,
			showConfiguredOnly: props.showConfiguredOnly,
			isReset: props.isReset,
			target: reportedTarget
		};

		/* __GDPR__
877
			"settingsEditor.settingModified" : {
878 879 880 881 882 883 884 885 886 887
				"key" : { "classification": "SystemMetaData", "purpose": "FeatureInsight" },
				"query" : { "classification": "CustomerContent", "purpose": "FeatureInsight" },
				"groupId" : { "classification": "SystemMetaData", "purpose": "FeatureInsight" },
				"nlpIndex" : { "classification": "SystemMetaData", "purpose": "FeatureInsight", "isMeasurement": true },
				"displayIndex" : { "classification": "SystemMetaData", "purpose": "FeatureInsight", "isMeasurement": true },
				"showConfiguredOnly" : { "classification": "SystemMetaData", "purpose": "FeatureInsight" },
				"isReset" : { "classification": "SystemMetaData", "purpose": "FeatureInsight" },
				"target" : { "classification": "SystemMetaData", "purpose": "FeatureInsight" }
			}
		*/
888
		this.telemetryService.publicLog('settingsEditor.settingModified', data);
R
Rob Lourens 已提交
889 890
	}

J
Johannes Rieken 已提交
891
	private render(token: CancellationToken): Promise<any> {
R
Rob Lourens 已提交
892 893
		if (this.input) {
			return this.input.resolve()
M
Matt Bierner 已提交
894 895
				.then((model: IEditorModel | null) => {
					if (token.isCancellationRequested || !(model instanceof Settings2EditorModel)) {
R
Rob Lourens 已提交
896
						return undefined;
897 898
					}

899
					this._register(model.onDidChangeGroups(() => {
900 901 902
						this.updatedConfigSchemaDelayer.trigger(() => {
							this.onConfigUpdate(undefined, undefined, true);
						});
903
					}));
904
					this.defaultSettingsEditorModel = model;
905
					return this.onConfigUpdate(undefined, true);
906
				});
R
Rob Lourens 已提交
907
		}
R
Rob Lourens 已提交
908
		return Promise.resolve(null);
R
Rob Lourens 已提交
909 910
	}

911
	private onSearchModeToggled(): void {
912
		DOM.removeClass(this.rootElement, 'no-toc-search');
913
		if (this.configurationService.getValue('workbench.settings.settingsSearchTocBehavior') === 'hide') {
914
			DOM.toggleClass(this.rootElement, 'no-toc-search', !!this.searchResultModel);
915
		}
916 917
	}

918 919
	private scheduleRefresh(element: HTMLElement, key = ''): void {
		if (key && this.scheduledRefreshes.has(key)) {
920 921 922
			return;
		}

923 924 925 926 927 928 929 930 931 932 933
		if (!key) {
			this.scheduledRefreshes.forEach(r => r.dispose());
			this.scheduledRefreshes.clear();
		}

		const scheduledRefreshTracker = DOM.trackFocus(element);
		this.scheduledRefreshes.set(key, scheduledRefreshTracker);
		scheduledRefreshTracker.onDidBlur(() => {
			scheduledRefreshTracker.dispose();
			this.scheduledRefreshes.delete(key);
			this.onConfigUpdate([key]);
934 935 936
		});
	}

937
	private async onConfigUpdate(keys?: string[], forceRefresh = false, schemaChange = false): Promise<void> {
938
		if (keys && this.settingsTreeModel) {
939 940 941
			return this.updateElementsByKey(keys);
		}

942
		const groups = this.defaultSettingsEditorModel.settingsGroups.slice(1); // Without commonlyUsed
943
		const dividedGroups = collections.groupBy(groups, g => g.contributedByExtension ? 'extension' : 'core');
944 945 946 947 948
		const settingsResult = resolveSettingsTree(tocData, dividedGroups.core);
		const resolvedSettingsRoot = settingsResult.tree;

		// Warn for settings not included in layout
		if (settingsResult.leftoverSettings.size && !this.hasWarnedMissingSettings) {
M
Matt Bierner 已提交
949
			const settingKeyList: string[] = [];
950 951 952 953 954 955 956 957
			settingsResult.leftoverSettings.forEach(s => {
				settingKeyList.push(s.key);
			});

			this.logService.warn(`SettingsEditor2: Settings not included in settingsLayout.ts: ${settingKeyList.join(', ')}`);
			this.hasWarnedMissingSettings = true;
		}

958
		const commonlyUsed = resolveSettingsTree(commonlyUsedData, dividedGroups.core);
R
Rob Lourens 已提交
959
		resolvedSettingsRoot.children!.unshift(commonlyUsed.tree);
960

R
Rob Lourens 已提交
961
		resolvedSettingsRoot.children!.push(resolveExtensionsSettings(dividedGroups.extension || []));
962

963 964 965 966
		if (this.searchResultModel) {
			this.searchResultModel.updateChildren();
		}

967 968
		if (this.settingsTreeModel) {
			this.settingsTreeModel.update(resolvedSettingsRoot);
969

970 971 972
			if (schemaChange && !!this.searchResultModel) {
				// If an extension's settings were just loaded and a search is active, retrigger the search so it shows up
				return await this.onSearchInputChanged();
973
			}
974 975

			this.refreshTOCTree();
976
			this.renderTree(undefined, forceRefresh);
977
		} else {
978 979
			this.settingsTreeModel = this.instantiationService.createInstance(SettingsTreeModel, this.viewState);
			this.settingsTreeModel.update(resolvedSettingsRoot);
980
			this.tocTreeModel.settingsTreeRoot = this.settingsTreeModel.root as SettingsTreeGroupElement;
981

982 983 984 985 986 987 988 989
			const cachedState = this.restoreCachedState();
			if (cachedState && cachedState.searchQuery) {
				await this.onSearchInputChanged();
			} else {
				this.refreshTOCTree();
				this.refreshTree();
				this.tocTree.collapseAll();
			}
990 991 992
		}
	}

U
Ubuntu 已提交
993
	private updateElementsByKey(keys: string[]): void {
994 995
		if (keys.length) {
			if (this.searchResultModel) {
R
Rob Lourens 已提交
996
				keys.forEach(key => this.searchResultModel!.updateElementsByName(key));
997 998 999 1000 1001 1002
			}

			if (this.settingsTreeModel) {
				keys.forEach(key => this.settingsTreeModel.updateElementsByName(key));
			}

U
Ubuntu 已提交
1003
			keys.forEach(key => this.renderTree(key));
1004 1005 1006 1007 1008
		} else {
			return this.renderTree();
		}
	}

1009 1010 1011 1012 1013 1014
	private getActiveElementInSettingsTree(): HTMLElement | null {
		return (document.activeElement && DOM.isAncestor(document.activeElement, this.settingsTree.getHTMLElement())) ?
			<HTMLElement>document.activeElement :
			null;
	}

U
Ubuntu 已提交
1015
	private renderTree(key?: string, force = false): void {
1016
		if (!force && key && this.scheduledRefreshes.has(key)) {
1017
			this.updateModifiedLabelForKey(key);
U
Ubuntu 已提交
1018
			return;
1019 1020
		}

1021 1022
		// If the context view is focused, delay rendering settings
		if (this.contextViewFocused()) {
M
Matt Bierner 已提交
1023 1024 1025 1026
			const element = document.querySelector('.context-view');
			if (element) {
				this.scheduleRefresh(element as HTMLElement, key);
			}
U
Ubuntu 已提交
1027
			return;
1028 1029
		}

1030
		// If a setting control is currently focused, schedule a refresh for later
R
Rob Lourens 已提交
1031 1032
		const activeElement = this.getActiveElementInSettingsTree();
		const focusedSetting = activeElement && this.settingRenderers.getSettingDOMElementForDOMElement(activeElement);
1033
		if (focusedSetting && !force) {
1034 1035
			// If a single setting is being refreshed, it's ok to refresh now if that is not the focused setting
			if (key) {
R
Rob Lourens 已提交
1036
				const focusedKey = focusedSetting.getAttribute(AbstractSettingRenderer.SETTING_KEY_ATTR);
P
Pine Wu 已提交
1037
				if (focusedKey === key &&
P
Pine Wu 已提交
1038 1039 1040
					// update `list`s live, as they have a separate "submit edit" step built in before this
					(focusedSetting.parentElement && !DOM.hasClass(focusedSetting.parentElement, 'setting-item-list'))
				) {
1041

1042
					this.updateModifiedLabelForKey(key);
1043
					this.scheduleRefresh(focusedSetting, key);
U
Ubuntu 已提交
1044
					return;
1045 1046
				}
			} else {
1047
				this.scheduleRefresh(focusedSetting);
U
Ubuntu 已提交
1048
				return;
1049
			}
1050
		}
R
Rob Lourens 已提交
1051

R
Rob Lourens 已提交
1052 1053
		this.renderResultCountMessages();

1054
		if (key) {
1055
			const elements = this.currentSettingsModel.getElementsByName(key);
1056
			if (elements && elements.length) {
1057
				// TODO https://github.com/Microsoft/vscode/issues/57360
R
Rob Lourens 已提交
1058
				this.refreshTree();
1059 1060
			} else {
				// Refresh requested for a key that we don't know about
U
Ubuntu 已提交
1061
				return;
1062
			}
1063
		} else {
R
Rob Lourens 已提交
1064
			this.refreshTree();
1065 1066
		}

U
Ubuntu 已提交
1067
		return;
R
Rob Lourens 已提交
1068 1069
	}

1070 1071 1072 1073
	private contextViewFocused(): boolean {
		return !!DOM.findParentWithClass(<HTMLElement>document.activeElement, 'context-view');
	}

R
Rob Lourens 已提交
1074
	private refreshTree(): void {
1075 1076 1077
		if (this.isVisible()) {
			this.settingsTree.setChildren(null, createGroupIterator(this.currentSettingsModel.root));
		}
1078 1079
	}

R
Rob Lourens 已提交
1080
	private refreshTOCTree(): void {
1081
		if (this.isVisible()) {
R
Rob Lourens 已提交
1082
			this.tocTreeModel.update();
1083 1084
			this.tocTree.setChildren(null, createTOCIterator(this.tocTreeModel, this.tocTree));
		}
R
Rob Lourens 已提交
1085 1086
	}

1087
	private updateModifiedLabelForKey(key: string): void {
1088
		const dataElements = this.currentSettingsModel.getElementsByName(key);
1089
		const isModified = dataElements && dataElements[0] && dataElements[0].isConfigured; // all elements are either configured or not
R
Rob Lourens 已提交
1090
		const elements = this.settingRenderers.getDOMElementsForSettingKey(this.settingsTree.getHTMLElement(), key);
1091
		if (elements && elements[0]) {
R
Rob Lourens 已提交
1092
			DOM.toggleClass(elements[0], 'is-configured', !!isModified);
1093 1094 1095
		}
	}

1096
	private async onSearchInputChanged(): Promise<void> {
R
Rob Lourens 已提交
1097 1098
		const query = this.searchWidget.getValue().trim();
		this.delayedFilterLogging.cancel();
1099 1100 1101 1102 1103
		await this.triggerSearch(query.replace(/›/g, ' '));

		if (query && this.searchResultModel) {
			this.delayedFilterLogging.trigger(() => this.reportFilteringUsed(query, this.searchResultModel!.getUniqueResults()));
		}
R
Rob Lourens 已提交
1104 1105
	}

R
Rob Lourens 已提交
1106
	private parseSettingFromJSON(query: string): string | null {
1107 1108 1109 1110
		const match = query.match(/"([a-zA-Z.]+)": /);
		return match && match[1];
	}

J
Johannes Rieken 已提交
1111
	private triggerSearch(query: string): Promise<void> {
1112
		this.viewState.tagFilters = new Set<string>();
P
Peng Lyu 已提交
1113
		this.viewState.extensionFilters = new Set<string>();
1114
		if (query) {
1115
			const parsedQuery = parseQuery(query);
R
Rob Lourens 已提交
1116
			query = parsedQuery.query;
R
Rob Lourens 已提交
1117
			parsedQuery.tags.forEach(tag => this.viewState.tagFilters!.add(tag));
P
Peng Lyu 已提交
1118
			parsedQuery.extensionFilters.forEach(extensionId => this.viewState.extensionFilters!.add(extensionId));
1119
		}
1120 1121

		if (query && query !== '@') {
1122
			query = this.parseSettingFromJSON(query) || query;
1123
			return this.triggerFilterPreferences(query);
R
Rob Lourens 已提交
1124
		} else {
P
Peng Lyu 已提交
1125
			if ((this.viewState.tagFilters && this.viewState.tagFilters.size) || (this.viewState.extensionFilters && this.viewState.extensionFilters.size)) {
1126 1127 1128 1129 1130
				this.searchResultModel = this.createFilterModel();
			} else {
				this.searchResultModel = null;
			}

R
Rob Lourens 已提交
1131 1132
			this.localSearchDelayer.cancel();
			this.remoteSearchThrottle.cancel();
1133 1134 1135 1136
			if (this.searchInProgress) {
				this.searchInProgress.cancel();
				this.searchInProgress.dispose();
				this.searchInProgress = null;
R
Rob Lourens 已提交
1137
			}
R
Rob Lourens 已提交
1138

1139
			this.tocTree.setFocus([]);
R
Rob Lourens 已提交
1140
			this.viewState.filterToCategory = undefined;
1141
			this.tocTreeModel.currentSearchModel = this.searchResultModel;
1142
			this.onSearchModeToggled();
1143 1144

			if (this.searchResultModel) {
1145 1146
				// Added a filter model
				this.tocTree.setSelection([]);
R
Rob Lourens 已提交
1147
				this.tocTree.expandAll();
1148
				this.refreshTOCTree();
R
Rob Lourens 已提交
1149
				this.renderResultCountMessages();
R
Rob Lourens 已提交
1150
				this.refreshTree();
1151
			} else {
1152
				// Leaving search mode
R
Rob Lourens 已提交
1153
				this.tocTree.collapseAll();
1154
				this.refreshTOCTree();
R
Rob Lourens 已提交
1155
				this.renderResultCountMessages();
R
Rob Lourens 已提交
1156
				this.refreshTree();
1157
			}
R
Rob Lourens 已提交
1158
		}
R
Rob Lourens 已提交
1159

R
Rob Lourens 已提交
1160
		return Promise.resolve();
R
Rob Lourens 已提交
1161 1162
	}

1163 1164 1165 1166 1167 1168 1169 1170 1171
	/**
	 * Return a fake SearchResultModel which can hold a flat list of all settings, to be filtered (@modified etc)
	 */
	private createFilterModel(): SearchResultModel {
		const filterModel = this.instantiationService.createInstance(SearchResultModel, this.viewState);

		const fullResult: ISearchResult = {
			filterMatches: []
		};
R
Rob Lourens 已提交
1172 1173 1174
		for (const g of this.defaultSettingsEditorModel.settingsGroups.slice(1)) {
			for (const sect of g.sections) {
				for (const setting of sect.settings) {
1175 1176 1177 1178 1179 1180 1181 1182 1183 1184
					fullResult.filterMatches.push({ setting, matches: [], score: 0 });
				}
			}
		}

		filterModel.setResult(0, fullResult);

		return filterModel;
	}

1185 1186 1187 1188
	private reportFilteringUsed(query: string, results: ISearchResult[]): void {
		const nlpResult = results[SearchResultIdx.Remote];
		const nlpMetadata = nlpResult && nlpResult.metadata;

1189 1190 1191
		const durations = {
			nlpResult: nlpMetadata && nlpMetadata.duration
		};
1192 1193

		// Count unique results
1194
		const counts: { nlpResult?: number, filterResult?: number } = {};
1195
		const filterResult = results[SearchResultIdx.Local];
1196 1197 1198 1199
		if (filterResult) {
			counts['filterResult'] = filterResult.filterMatches.length;
		}

1200 1201
		if (nlpResult) {
			counts['nlpResult'] = nlpResult.filterMatches.length;
1202 1203 1204 1205 1206 1207 1208 1209 1210 1211 1212 1213 1214 1215 1216 1217 1218 1219 1220 1221
		}

		const requestCount = nlpMetadata && nlpMetadata.requestCount;

		const data = {
			query,
			durations,
			counts,
			requestCount
		};

		/* __GDPR__
			"settingsEditor.filter" : {
				"query": { "classification": "CustomerContent", "purpose": "FeatureInsight" },
				"durations.nlpResult" : { "classification": "SystemMetaData", "purpose": "FeatureInsight", "isMeasurement": true },
				"counts.nlpResult" : { "classification": "SystemMetaData", "purpose": "FeatureInsight", "isMeasurement": true },
				"counts.filterResult" : { "classification": "SystemMetaData", "purpose": "FeatureInsight", "isMeasurement": true },
				"requestCount" : { "classification": "SystemMetaData", "purpose": "FeatureInsight", "isMeasurement": true }
			}
		*/
1222
		this.telemetryService.publicLog('settingsEditor.filter', data);
1223 1224
	}

J
Johannes Rieken 已提交
1225
	private triggerFilterPreferences(query: string): Promise<void> {
1226 1227 1228 1229 1230 1231 1232 1233 1234 1235
		if (this.searchInProgress) {
			this.searchInProgress.cancel();
			this.searchInProgress = null;
		}

		// Trigger the local search. If it didn't find an exact match, trigger the remote search.
		const searchInProgress = this.searchInProgress = new CancellationTokenSource();
		return this.localSearchDelayer.trigger(() => {
			if (searchInProgress && !searchInProgress.token.isCancellationRequested) {
				return this.localFilterPreferences(query).then(result => {
1236
					if (result && !result.exactMatch) {
1237 1238
						this.remoteSearchThrottle.trigger(() => {
							return searchInProgress && !searchInProgress.token.isCancellationRequested ?
R
Rob Lourens 已提交
1239 1240
								this.remoteSearchPreferences(query, this.searchInProgress!.token) :
								Promise.resolve();
1241 1242
						});
					}
1243
				});
1244
			} else {
R
Rob Lourens 已提交
1245
				return Promise.resolve();
1246 1247 1248 1249
			}
		});
	}

R
Rob Lourens 已提交
1250
	private localFilterPreferences(query: string, token?: CancellationToken): Promise<ISearchResult | null> {
1251
		const localSearchProvider = this.preferencesSearchService.getLocalSearchProvider(query);
1252
		return this.filterOrSearchPreferences(query, SearchResultIdx.Local, localSearchProvider, token);
R
Rob Lourens 已提交
1253 1254
	}

J
Johannes Rieken 已提交
1255
	private remoteSearchPreferences(query: string, token?: CancellationToken): Promise<void> {
1256
		const remoteSearchProvider = this.preferencesSearchService.getRemoteSearchProvider(query);
1257 1258
		const newExtSearchProvider = this.preferencesSearchService.getRemoteSearchProvider(query, true);

R
Rob Lourens 已提交
1259
		return Promise.all([
1260 1261
			this.filterOrSearchPreferences(query, SearchResultIdx.Remote, remoteSearchProvider, token),
			this.filterOrSearchPreferences(query, SearchResultIdx.NewExtensions, newExtSearchProvider, token)
R
Rob Lourens 已提交
1262
		]).then(() => { });
R
Rob Lourens 已提交
1263 1264
	}

R
Rob Lourens 已提交
1265
	private filterOrSearchPreferences(query: string, type: SearchResultIdx, searchProvider?: ISearchProvider, token?: CancellationToken): Promise<ISearchResult | null> {
1266 1267 1268 1269 1270
		return this._filterOrSearchPreferencesModel(query, this.defaultSettingsEditorModel, searchProvider, token).then(result => {
			if (token && token.isCancellationRequested) {
				// Handle cancellation like this because cancellation is lost inside the search provider due to async/await
				return null;
			}
1271

1272 1273 1274 1275
			if (!this.searchResultModel) {
				this.searchResultModel = this.instantiationService.createInstance(SearchResultModel, this.viewState);
				this.searchResultModel.setResult(type, result);
				this.tocTreeModel.currentSearchModel = this.searchResultModel;
1276
				this.onSearchModeToggled();
1277 1278
			} else {
				this.searchResultModel.setResult(type, result);
1279
				this.tocTreeModel.update();
1280
			}
R
Rob Lourens 已提交
1281

1282
			this.tocTree.setFocus([]);
R
Rob Lourens 已提交
1283
			this.viewState.filterToCategory = undefined;
R
Rob Lourens 已提交
1284
			this.tocTree.expandAll();
1285

1286
			this.refreshTOCTree();
1287
			this.renderTree(undefined, true);
U
Ubuntu 已提交
1288
			return result;
R
Rob Lourens 已提交
1289 1290 1291
		});
	}

1292
	private renderResultCountMessages() {
1293
		if (!this.currentSettingsModel) {
1294 1295 1296
			return;
		}

R
Rob Lourens 已提交
1297 1298 1299 1300
		this.clearFilterLinkContainer.style.display = this.viewState.tagFilters && this.viewState.tagFilters.size > 0
			? 'initial'
			: 'none';

1301
		if (!this.searchResultModel) {
1302 1303 1304 1305 1306
			if (this.countElement.style.display !== 'none') {
				this.countElement.style.display = 'none';
				this.layout(this.dimension);
			}

R
Rob Lourens 已提交
1307 1308
			DOM.removeClass(this.rootElement, 'no-results');
			return;
1309 1310
		}

1311 1312 1313 1314 1315 1316 1317
		if (this.tocTreeModel && this.tocTreeModel.settingsTreeRoot) {
			const count = this.tocTreeModel.settingsTreeRoot.count;
			switch (count) {
				case 0: this.countElement.innerText = localize('noResults', "No Settings Found"); break;
				case 1: this.countElement.innerText = localize('oneResult', "1 Setting Found"); break;
				default: this.countElement.innerText = localize('moreThanOneResult', "{0} Settings Found", count);
			}
1318

1319 1320 1321 1322
			if (this.countElement.style.display !== 'block') {
				this.countElement.style.display = 'block';
				this.layout(this.dimension);
			}
R
Rob Lourens 已提交
1323
			DOM.toggleClass(this.rootElement, 'no-results', count === 0);
1324
		}
1325 1326
	}

R
Rob Lourens 已提交
1327
	private _filterOrSearchPreferencesModel(filter: string, model: ISettingsEditorModel, provider?: ISearchProvider, token?: CancellationToken): Promise<ISearchResult | null> {
R
Rob Lourens 已提交
1328
		const searchP = provider ? provider.searchModel(model, token) : Promise.resolve(null);
R
Rob Lourens 已提交
1329
		return searchP
M
Matt Bierner 已提交
1330
			.then<ISearchResult, ISearchResult | null>(undefined, err => {
R
Rob Lourens 已提交
1331
				if (isPromiseCanceledError(err)) {
R
Rob Lourens 已提交
1332
					return Promise.reject(err);
R
Rob Lourens 已提交
1333 1334
				} else {
					/* __GDPR__
1335
						"settingsEditor.searchError" : {
R
Rob Lourens 已提交
1336
							"message": { "classification": "CallstackOrException", "purpose": "FeatureInsight" }
R
Rob Lourens 已提交
1337 1338 1339 1340 1341
						}
					*/
					const message = getErrorMessage(err).trim();
					if (message && message !== 'Error') {
						// "Error" = any generic network error
R
Rob Lourens 已提交
1342
						this.telemetryService.publicLog('settingsEditor.searchError', { message });
R
Rob Lourens 已提交
1343 1344
						this.logService.info('Setting search error: ' + message);
					}
M
Matt Bierner 已提交
1345
					return null;
R
Rob Lourens 已提交
1346 1347 1348 1349
				}
			});
	}

1350
	private layoutTrees(dimension: DOM.Dimension): void {
1351
		const listHeight = dimension.height - (76 + 11 /* header height + padding*/);
1352 1353
		const settingsTreeHeight = listHeight - 14;
		this.settingsTreeContainer.style.height = `${settingsTreeHeight}px`;
1354
		this.settingsTree.layout(settingsTreeHeight, dimension.width);
1355

1356 1357
		const tocTreeHeight = listHeight - 16;
		this.tocTreeContainer.style.height = `${tocTreeHeight}px`;
R
Rob Lourens 已提交
1358
		this.tocTree.layout(tocTreeHeight);
1359
	}
1360

B
Benjamin Pasero 已提交
1361
	protected saveState(): void {
1362 1363 1364
		if (this.isVisible()) {
			const searchQuery = this.searchWidget.getValue().trim();
			const target = this.settingsTargetsWidget.settingsTarget as SettingsTarget;
R
Rob Lourens 已提交
1365 1366 1367
			if (this.group && this.input) {
				this.editorMemento.saveEditorState(this.group, this.input, { searchQuery, target });
			}
1368
		}
B
Benjamin Pasero 已提交
1369 1370

		super.saveState();
1371
	}
R
Rob Lourens 已提交
1372
}
1373

1374 1375 1376 1377
interface ISettingsEditor2State {
	searchQuery: string;
	target: SettingsTarget;
}