mirror of
https://codeberg.org/forgejo/forgejo.git
synced 2026-01-11 20:56:29 +00:00
Some checks are pending
testing-integration / test-sqlite (push) Waiting to run
testing-integration / test-mariadb (v10.6) (push) Waiting to run
testing-integration / test-mariadb (v11.8) (push) Waiting to run
testing / test-unit (push) Blocked by required conditions
testing / backend-checks (push) Waiting to run
testing / frontend-checks (push) Waiting to run
testing / test-e2e (push) Blocked by required conditions
testing / test-remote-cacher (redis) (push) Blocked by required conditions
testing / test-remote-cacher (valkey) (push) Blocked by required conditions
testing / test-remote-cacher (garnet) (push) Blocked by required conditions
testing / test-remote-cacher (redict) (push) Blocked by required conditions
testing / test-mysql (push) Blocked by required conditions
testing / test-pgsql (push) Blocked by required conditions
testing / test-sqlite (push) Blocked by required conditions
/ release (push) Waiting to run
testing-integration / test-unit (push) Waiting to run
testing / security-check (push) Blocked by required conditions
- Replace the [Monaco Editor](https://microsoft.github.io/monaco-editor/) with [CodeMirror 6](https://codemirror.net/). This editor is used to facilitate the 'Add file' and 'Edit file' functionality. - Rationale: - Monaco editor is a great and powerful editor, however for Forgejo's purpose it acts more like a small IDE than a code editor and is doing too much. In my limited user research the usage of editing files via the web UI is largely for small changes that does not need the features that Monaco editor provides. - Monaco editor has no mobile support, Codemirror is very usable on mobile. - Monaco editor pulls in large dependencies (for language support) and by replacing it with Codemirror the amount of time that webpack needs to build the frontend is reduced by 50% (~30s -> ~15s). - The binary of Forgejo (build with `bindata` tag) is reduced by 2MiB. - Codemirror is much more lightweight and should be more usable on less powerful hardware, most notably the lazy loading is much faster as codemirror uses less javascript. - Because Codemirror is modular it is much easier to change the behavior of the code editor if we wish to. - Drawbacks: - Codemirror is quite modular and as seen in `package.json` and in `codeeditor.ts` we have to supply a lot more of its features to have feature parity with Monaco editor. - Monaco editor has great integrated language support (features that an lsp would provide), Codemirror only has such language support to an extend. - Monaco editor has its famous command palette (known by many as its also available in VSCode), this is not available in code mirror. - Good to note: - All features that was added on top of the monaco editor (such as dynamically changing language support depending on the filename) still works and the theme is based on the VSCode colors which largely resembles the monaco editor. - The code editor is still lazy-loaded (this is painfully clear by reading how imports are passed around in `codeeditor.ts`). - This change was privately tested by a few people, a few bugs were found (and fixed) but no major drawbacks were noted for their usage of the web editor. - There's a "search" button in the top bar, so that search can be used on mobile. It is otherwise only accessible via <kbd>Ctrl</kbd>+<kbd>f</kbd>. Co-authored-by: Beowulf <beowulf@beocode.eu> Co-authored-by: Gusted <postmaster@gusted.xyz> Reviewed-on: https://codeberg.org/forgejo/forgejo/pulls/10559 Reviewed-by: Gusted <gusted@noreply.codeberg.org> Reviewed-by: 0ko <0ko@noreply.codeberg.org> Co-committed-by: Beowulf <beowulf@beocode.eu>
124 lines
4.8 KiB
TypeScript
124 lines
4.8 KiB
TypeScript
import {basename, extname} from '../utils.js';
|
|
import {hideElem, onInputDebounce, showElem} from '../utils/dom.js';
|
|
import {createCodemirror, type CodemirrorEditor, type EditorOptions} from './codemirror.ts';
|
|
import {EditorView} from '@codemirror/view';
|
|
import type {LanguageSupport} from '@codemirror/language';
|
|
|
|
interface EditorConfig {
|
|
indent_style: string;
|
|
indent_size: string;
|
|
}
|
|
|
|
export class SettableEditorView extends EditorView {
|
|
public setValue(value: string) {
|
|
// Replace \n with the actual newline character and unescape escaped \n
|
|
value = value.replaceAll(/(?<!\\)\\n/g, '\n').replaceAll(/\\\\n/g, '\\n');
|
|
this.dispatch({changes: {from: 0, to: this.state.doc.length, insert: value}});
|
|
}
|
|
}
|
|
|
|
function getEditorconfig(input: HTMLInputElement): null | EditorConfig {
|
|
try {
|
|
return JSON.parse(input.getAttribute('data-editorconfig'));
|
|
} catch {
|
|
return null;
|
|
}
|
|
}
|
|
|
|
async function updateEditor(editor: CodemirrorEditor, filename: string, lineWrapExts: string[]) {
|
|
const fileOption = getFileBasedOptions(filename, lineWrapExts);
|
|
editor.view.dispatch({
|
|
effects: editor.compartments.wordWrap.reconfigure(fileOption.wordWrap ? editor.codemirrorView.EditorView.lineWrapping : []),
|
|
});
|
|
|
|
const currentLanguage = editor.compartments.language.get(editor.view.state) as Array<unknown> | LanguageSupport;
|
|
const newLanguage = editor.codemirrorLanguage.LanguageDescription.matchFilename(editor.languages, filename);
|
|
if (!currentLanguage || (currentLanguage as Array<unknown>).length === 0 || !newLanguage || (currentLanguage as LanguageSupport).language.name.toLowerCase() !== newLanguage.name.toLowerCase()) {
|
|
editor.view.dispatch({
|
|
effects: editor.compartments.language.reconfigure(newLanguage ? await newLanguage.load() : []),
|
|
});
|
|
}
|
|
}
|
|
|
|
function getFileBasedOptions(filename: string, lineWrapExts: string[]): Pick<EditorOptions, 'wordWrap'> {
|
|
return {
|
|
wordWrap: (lineWrapExts || []).includes(extname(filename)),
|
|
};
|
|
}
|
|
|
|
function togglePreviewDisplay(previewable: boolean) {
|
|
const previewTab = document.querySelector('.item[data-tab="preview"]') as HTMLAnchorElement;
|
|
if (!previewTab) return;
|
|
|
|
if (previewable) {
|
|
const newUrl = (previewTab.getAttribute('data-url') || '').replace(/(.*)\/.*/, `$1/markup`);
|
|
previewTab.setAttribute('data-url', newUrl);
|
|
previewTab.style.display = '';
|
|
} else {
|
|
previewTab.style.display = 'none';
|
|
// If the "preview" tab was active, user changes the filename to a non-previewable one,
|
|
// then the "preview" tab becomes inactive (hidden), so the "write" tab should become active
|
|
if (previewTab.classList.contains('active')) {
|
|
const writeTab = document.querySelector('.item[data-tab="write"]') as HTMLAnchorElement;
|
|
writeTab.click();
|
|
}
|
|
}
|
|
}
|
|
|
|
export async function createCodeEditor(textarea: HTMLTextAreaElement, filenameInput: HTMLInputElement): Promise<SettableEditorView> {
|
|
const filename = basename(filenameInput.value);
|
|
const previewableExts = new Set((textarea.getAttribute('data-previewable-extensions') || '').split(','));
|
|
const lineWrapExts = (textarea.getAttribute('data-line-wrap-extensions') || '').split(',');
|
|
const previewable = previewableExts.has(extname(filename));
|
|
const editorConfig = getEditorconfig(filenameInput);
|
|
|
|
togglePreviewDisplay(previewable);
|
|
|
|
const editor = await createCodemirror(textarea, filename, {
|
|
...getFileBasedOptions(filenameInput.value, lineWrapExts),
|
|
...getEditorConfigOptions(editorConfig),
|
|
});
|
|
|
|
filenameInput.addEventListener('input', onInputDebounce(async () => {
|
|
const filename = filenameInput.value;
|
|
const previewable = previewableExts.has(extname(filename));
|
|
togglePreviewDisplay(previewable);
|
|
await updateEditor(editor, filename, lineWrapExts);
|
|
}));
|
|
|
|
const searchButton = document.querySelector('#editor-find');
|
|
searchButton.addEventListener('click', () => {
|
|
const search = editor.codemirrorSearch;
|
|
const view = editor.view;
|
|
|
|
if (search.searchPanelOpen(view.state)) {
|
|
search.closeSearchPanel(view);
|
|
} else {
|
|
search.openSearchPanel(view);
|
|
}
|
|
});
|
|
|
|
const writeTab = document.querySelector('#editor-bar .switch .item[data-tab="write"]');
|
|
document.querySelector('#editor-bar .switch').addEventListener('click', () => {
|
|
if (writeTab.classList.contains('active')) {
|
|
showElem(searchButton);
|
|
} else {
|
|
hideElem(searchButton);
|
|
}
|
|
});
|
|
|
|
return Object.setPrototypeOf(editor.view, SettableEditorView.prototype);
|
|
}
|
|
|
|
function getEditorConfigOptions(ec: null | EditorConfig): Pick<EditorOptions, 'indentSize' | 'tabSize' | 'indentStyle'> {
|
|
if (ec === null) {
|
|
return {indentStyle: 'space'};
|
|
}
|
|
|
|
const opts: ReturnType<typeof getEditorConfigOptions> = {
|
|
indentStyle: ec.indent_style,
|
|
};
|
|
if ('indent_size' in ec) opts.indentSize = Number(ec.indent_size);
|
|
if ('tab_width' in ec) opts.tabSize = Number(ec.tab_width) || opts.indentSize;
|
|
return opts;
|
|
}
|