Files
AFFiNE-Mirror/blocksuite/affine/block-root/src/edgeless/edgeless-root-block.ts
doodlewind bd1b26a230 feat(editor): support zooming placeholder in turbo renderer (#10504)
[Screen Recording 2025-02-28 at 4.32.20 PM.mov <span class="graphite__hidden">(uploaded via Graphite)</span> <img class="graphite__hidden" src="https://app.graphite.dev/api/v1/graphite/video/thumbnail/lEGcysB4lFTEbCwZ8jMv/6c08b827-8428-42f3-aa7a-a2366756bd16.mov" />](https://app.graphite.dev/media/video/lEGcysB4lFTEbCwZ8jMv/6c08b827-8428-42f3-aa7a-a2366756bd16.mov)

This prevents painting task backlog during zooming by adding a fast placeholder painter, with a `zooming` state in renderer state machine.
2025-03-03 02:07:46 +00:00

629 lines
16 KiB
TypeScript

import type {
SurfaceBlockComponent,
SurfaceBlockModel,
} from '@blocksuite/affine-block-surface';
import {
EdgelessLegacySlotIdentifier,
getBgGridGap,
normalizeWheelDeltaY,
} from '@blocksuite/affine-block-surface';
import {
NoteBlockModel,
NoteDisplayMode,
type RootBlockModel,
type ShapeElementModel,
} from '@blocksuite/affine-model';
import { EDGELESS_BLOCK_CHILD_PADDING } from '@blocksuite/affine-shared/consts';
import {
DocModeProvider,
EditorSettingProvider,
EditPropsStore,
FontLoaderService,
ThemeProvider,
} from '@blocksuite/affine-shared/services';
import type { Viewport } from '@blocksuite/affine-shared/types';
import {
isTouchPadPinchEvent,
matchModels,
requestConnectedFrame,
requestThrottledConnectedFrame,
} from '@blocksuite/affine-shared/utils';
import {
BlockComponent,
type GfxBlockComponent,
SurfaceSelection,
type UIEventHandler,
} from '@blocksuite/block-std';
import {
GfxControllerIdentifier,
type GfxViewportElement,
} from '@blocksuite/block-std/gfx';
import { IS_WINDOWS } from '@blocksuite/global/env';
import { assertExists, Bound, Point, Vec } from '@blocksuite/global/utils';
import { effect } from '@preact/signals-core';
import { css, html } from 'lit';
import { query } from 'lit/decorators.js';
import { repeat } from 'lit/directives/repeat.js';
import type { EdgelessRootBlockWidgetName } from '../types.js';
import { EdgelessClipboardController } from './clipboard/clipboard.js';
import type { EdgelessSelectedRectWidget } from './components/rects/edgeless-selected-rect.js';
import { EdgelessPageKeyboardManager } from './edgeless-keyboard.js';
import type { EdgelessRootService } from './edgeless-root-service.js';
import { isSingleMindMapNode } from './utils/mindmap.js';
import { isCanvasElement } from './utils/query.js';
import { mountShapeTextEditor } from './utils/text.js';
export class EdgelessRootBlockComponent extends BlockComponent<
RootBlockModel,
EdgelessRootService,
EdgelessRootBlockWidgetName
> {
static override styles = css`
affine-edgeless-root {
-webkit-user-select: none;
user-select: none;
display: block;
height: 100%;
touch-action: none;
}
.widgets-container {
position: absolute;
left: 0;
top: 0;
pointer-events: none;
contain: size layout;
height: 100%;
width: 100%;
}
.widgets-container > * {
pointer-events: auto;
}
.edgeless-background {
height: 100%;
background-color: var(--affine-background-primary-color);
background-image: radial-gradient(
var(--affine-edgeless-grid-color) 1px,
var(--affine-background-primary-color) 1px
);
}
.edgeless-container {
color: var(--affine-text-primary-color);
position: relative;
}
@media print {
.selected {
background-color: transparent !important;
}
}
`;
private readonly _refreshLayerViewport = requestThrottledConnectedFrame(
() => {
const { zoom, translateX, translateY } = this.gfx.viewport;
const gap = getBgGridGap(zoom);
if (this.backgroundElm) {
this.backgroundElm.style.setProperty(
'background-position',
`${translateX}px ${translateY}px`
);
this.backgroundElm.style.setProperty(
'background-size',
`${gap}px ${gap}px`
);
}
},
this
);
private _resizeObserver: ResizeObserver | null = null;
private _viewportElement: HTMLElement | null = null;
clipboardController = new EdgelessClipboardController(this);
keyboardManager: EdgelessPageKeyboardManager | null = null;
get dispatcher() {
return this.std.event;
}
get fontLoader() {
return this.std.get(FontLoaderService);
}
get gfx() {
return this.std.get(GfxControllerIdentifier);
}
get selectedRectWidget() {
return this.host.view.getWidget(
'edgeless-selected-rect',
this.host.id
) as EdgelessSelectedRectWidget;
}
get slots() {
return this.std.get(EdgelessLegacySlotIdentifier);
}
get surfaceBlockModel() {
return this.model.children.find(
child => child.flavour === 'affine:surface'
) as SurfaceBlockModel;
}
/**
* Don't confuse with `gfx.viewport` which is edgeless-only concept.
* This refers to the wrapper element of the EditorHost.
*/
get viewport(): Viewport {
const {
scrollLeft,
scrollTop,
scrollWidth,
scrollHeight,
clientWidth,
clientHeight,
} = this.viewportElement;
const { top, left } = this.viewportElement.getBoundingClientRect();
return {
top,
left,
scrollLeft,
scrollTop,
scrollWidth,
scrollHeight,
clientWidth,
clientHeight,
};
}
get viewportElement(): HTMLElement {
if (this._viewportElement) return this._viewportElement;
this._viewportElement = this.host.closest(
'.affine-edgeless-viewport'
) as HTMLElement | null;
assertExists(this._viewportElement);
return this._viewportElement;
}
private _initFontLoader() {
this.std
.get(FontLoaderService)
.ready.then(() => {
this.surface.refresh();
})
.catch(console.error);
}
private _initLayerUpdateEffect() {
const updateLayers = requestThrottledConnectedFrame(() => {
const blocks = Array.from(
this.gfxViewportElm.children as HTMLCollectionOf<GfxBlockComponent>
);
blocks.forEach((block: GfxBlockComponent) => {
block.updateZIndex?.();
});
});
this._disposables.add(
this.gfx.layer.slots.layerUpdated.on(() => updateLayers())
);
}
private _initPanEvent() {
this.disposables.add(
this.dispatcher.add('pan', ctx => {
const { viewport } = this.gfx;
if (viewport.locked) return;
const multiPointersState = ctx.get('multiPointerState');
const [p1, p2] = multiPointersState.pointers;
const dx =
(0.25 * (p1.delta.x + p2.delta.x)) /
viewport.zoom /
viewport.viewScale;
const dy =
(0.25 * (p1.delta.y + p2.delta.y)) /
viewport.zoom /
viewport.viewScale;
// direction is opposite
viewport.applyDeltaCenter(-dx, -dy);
})
);
}
private _initPinchEvent() {
this.disposables.add(
this.dispatcher.add('pinch', ctx => {
const { viewport } = this.gfx;
if (viewport.locked) return;
const multiPointersState = ctx.get('multiPointerState');
const [p1, p2] = multiPointersState.pointers;
const currentCenter = new Point(
0.5 * (p1.x + p2.x),
0.5 * (p1.y + p2.y)
);
const lastDistance = Vec.dist(
[p1.x - p1.delta.x, p1.y - p1.delta.y],
[p2.x - p2.delta.x, p2.y - p2.delta.y]
);
const currentDistance = Vec.dist([p1.x, p1.y], [p2.x, p2.y]);
const zoom = (currentDistance / lastDistance) * viewport.zoom;
const [baseX, baseY] = viewport.toModelCoord(
currentCenter.x,
currentCenter.y
);
viewport.setZoom(zoom, new Point(baseX, baseY));
return false;
})
);
}
private _initPixelRatioChangeEffect() {
let media: MediaQueryList;
const onPixelRatioChange = () => {
if (media) {
this.gfx.viewport.onResize();
media.removeEventListener('change', onPixelRatioChange);
}
media = matchMedia(`(resolution: ${window.devicePixelRatio}dppx)`);
media.addEventListener('change', onPixelRatioChange);
};
onPixelRatioChange();
this._disposables.add(() => {
media?.removeEventListener('change', onPixelRatioChange);
});
}
private _initRemoteCursor() {
let rafId: number | null = null;
const setRemoteCursor = (pos: { x: number; y: number }) => {
if (rafId) cancelAnimationFrame(rafId);
rafId = requestConnectedFrame(() => {
if (!this.gfx.viewport) return;
const cursorPosition = this.gfx.viewport.toModelCoord(pos.x, pos.y);
this.gfx.selection.setCursor({
x: cursorPosition[0],
y: cursorPosition[1],
});
rafId = null;
}, this);
};
this.handleEvent('pointerMove', e => {
const pointerEvent = e.get('pointerState');
setRemoteCursor(pointerEvent);
});
}
private _initResizeEffect() {
const resizeObserver = new ResizeObserver((_: ResizeObserverEntry[]) => {
this.gfx.selection.set(this.gfx.selection.surfaceSelections);
this.gfx.viewport.onResize();
});
resizeObserver.observe(this.viewportElement);
this._resizeObserver = resizeObserver;
}
private _initSlotEffects() {
const { disposables } = this;
this.disposables.add(
this.std.get(ThemeProvider).theme$.subscribe(() => this.surface.refresh())
);
disposables.add(
effect(() => {
this.style.cursor = this.gfx.cursor$.value;
})
);
}
private _initViewport() {
const { std, gfx } = this;
const pageBlockViewportFitAnimation = () => {
const primaryMode = std.get(DocModeProvider).getPrimaryMode(this.doc.id);
const note = this.model.children.find(
(child): child is NoteBlockModel =>
matchModels(child, [NoteBlockModel]) &&
child.displayMode !== NoteDisplayMode.EdgelessOnly
);
if (primaryMode !== 'page' || !note || note.edgeless.collapse)
return false;
const leftPadding = parseInt(
window
.getComputedStyle(this)
.getPropertyValue('--affine-editor-side-padding')
.replace('px', '')
);
if (isNaN(leftPadding)) return false;
let editorWidth = parseInt(
window
.getComputedStyle(this)
.getPropertyValue('--affine-editor-width')
.replace('px', '')
);
if (isNaN(editorWidth)) return false;
const containerWidth = this.getBoundingClientRect().width;
const leftMargin =
containerWidth > editorWidth ? (containerWidth - editorWidth) / 2 : 0;
const pageTitleAnchor = gfx.viewport.toModelCoord(
leftPadding + leftMargin,
0
);
const noteBound = Bound.deserialize(note.xywh);
const edgelessTitleAnchor = Vec.add(noteBound.tl, [
EDGELESS_BLOCK_CHILD_PADDING,
12,
]);
const center = Vec.sub(edgelessTitleAnchor, pageTitleAnchor);
gfx.viewport.setCenter(center[0], center[1]);
gfx.viewport.smoothZoom(0.65, undefined, 15);
return true;
};
const run = () => {
const storedViewport = std.get(EditPropsStore).getStorage('viewport');
if (!storedViewport) {
if (!pageBlockViewportFitAnimation()) {
this.gfx.fitToScreen();
}
return;
}
if ('xywh' in storedViewport) {
const bound = Bound.deserialize(storedViewport.xywh);
gfx.viewport.setViewportByBound(bound, storedViewport.padding);
} else {
const { zoom, centerX, centerY } = storedViewport;
gfx.viewport.setViewport(zoom, [centerX, centerY]);
}
};
run();
this._disposables.add(() => {
std.get(EditPropsStore).setStorage('viewport', {
centerX: gfx.viewport.centerX,
centerY: gfx.viewport.centerY,
zoom: gfx.viewport.zoom,
});
});
}
private _initWheelEvent() {
this._disposables.add(
this.dispatcher.add('wheel', ctx => {
const config = this.std.getOptional(EditorSettingProvider);
const state = ctx.get('defaultState');
const e = state.event as WheelEvent;
const edgelessScrollZoom = config?.peek().edgelessScrollZoom ?? false;
e.preventDefault();
const { viewport } = this.gfx;
if (viewport.locked) return;
// zoom
if (isTouchPadPinchEvent(e) || edgelessScrollZoom) {
const rect = this.getBoundingClientRect();
// Perform zooming relative to the mouse position
const [baseX, baseY] = this.gfx.viewport.toModelCoord(
e.clientX - rect.x,
e.clientY - rect.y
);
const zoom = normalizeWheelDeltaY(e.deltaY, viewport.zoom);
viewport.setZoom(zoom, new Point(baseX, baseY), true);
e.stopPropagation();
}
// pan
else {
const simulateHorizontalScroll = IS_WINDOWS && e.shiftKey;
const dx = simulateHorizontalScroll
? e.deltaY / viewport.zoom
: e.deltaX / viewport.zoom;
const dy = simulateHorizontalScroll ? 0 : e.deltaY / viewport.zoom;
viewport.applyDeltaCenter(dx, dy);
viewport.viewportMoved.emit([dx, dy]);
e.stopPropagation();
}
})
);
}
override bindHotKey(
keymap: Record<string, UIEventHandler>,
options?: { global?: boolean; flavour?: boolean }
): () => void {
const { gfx } = this;
const selection = gfx.selection;
Object.keys(keymap).forEach(key => {
if (key.length === 1 && key >= 'A' && key <= 'z') {
const handler = keymap[key];
keymap[key] = ctx => {
const elements = selection.selectedElements;
if (isSingleMindMapNode(elements) && !selection.editing) {
const target = gfx.getElementById(
elements[0].id
) as ShapeElementModel;
if (target.text) {
this.doc.transact(() => {
target.text!.delete(0, target.text!.length);
target.text!.insert(0, key);
});
}
mountShapeTextEditor(target, this);
} else {
handler(ctx);
}
};
}
});
return super.bindHotKey(keymap, options);
}
override connectedCallback() {
super.connectedCallback();
this._initViewport();
this.clipboardController.hostConnected();
this.keyboardManager = new EdgelessPageKeyboardManager(this);
this.handleEvent('selectionChange', () => {
const surface = this.host.selection.value.find(
(sel): sel is SurfaceSelection => sel.is(SurfaceSelection)
);
if (!surface) return;
const el = this.gfx.getElementById(surface.elements[0]);
if (isCanvasElement(el)) {
return true;
}
return;
});
}
override disconnectedCallback() {
super.disconnectedCallback();
this.clipboardController.hostDisconnected();
if (this._resizeObserver) {
this._resizeObserver.disconnect();
this._resizeObserver = null;
}
this.keyboardManager = null;
}
override firstUpdated() {
this._initSlotEffects();
this._initResizeEffect();
this._initPixelRatioChangeEffect();
this._initFontLoader();
this._initRemoteCursor();
this._initLayerUpdateEffect();
this._initWheelEvent();
this._initPanEvent();
this._initPinchEvent();
if (this.doc.readonly) {
this.gfx.tool.setTool('pan', { panning: true });
} else {
this.gfx.tool.setTool('default');
}
this.gfx.viewport.elementReady.emit(this.gfxViewportElm);
requestConnectedFrame(() => {
this.requestUpdate();
}, this);
this._disposables.add(
this.gfx.viewport.viewportUpdated.on(() => {
this._refreshLayerViewport();
})
);
this._refreshLayerViewport();
}
override renderBlock() {
const widgets = repeat(
Object.entries(this.widgets),
([id]) => id,
([_, widget]) => widget
);
return html`
<div class="edgeless-background edgeless-container">
<gfx-viewport
.maxConcurrentRenders=${6}
.viewport=${this.gfx.viewport}
.getModelsInViewport=${() => {
const blocks = this.gfx.grid.search(
this.gfx.viewport.viewportBounds,
{
useSet: true,
filter: ['block'],
}
);
return blocks;
}}
.host=${this.host}
>
${this.renderChildren(this.model)}
${this.renderChildren(this.surfaceBlockModel)}
</gfx-viewport>
</div>
<!--
Used to mount component before widgets
Eg., canvas text editor
-->
<div class="edgeless-mount-point"></div>
<div class="widgets-container">${widgets}</div>
`;
}
@query('.edgeless-background')
accessor backgroundElm: HTMLDivElement | null = null;
@query('gfx-viewport')
accessor gfxViewportElm!: GfxViewportElement;
@query('.edgeless-mount-point')
accessor mountElm: HTMLDivElement | null = null;
@query('affine-surface')
accessor surface!: SurfaceBlockComponent;
}
declare global {
interface HTMLElementTagNameMap {
'affine-edgeless-root': EdgelessRootBlockComponent;
}
}