mirror of
https://github.com/toeverything/AFFiNE.git
synced 2026-02-14 05:14:54 +00:00
### What's Changed! #### Added Manage various types of toolbars uniformly in one place. * `affine-toolbar-widget` * `ToolbarRegistryExtension` The toolbar currently supports and handles several scenarios: 1. Select blocks: `BlockSelection` 2. Select text: `TextSelection` or `NativeSelection` 3. Hover a link: `affine-link` and `affine-reference` #### Removed Remove redundant toolbar implementations. * `attachment` toolbar * `bookmark` toolbar * `embed` toolbar * `formatting` toolbar * `affine-link` toolbar * `affine-reference` toolbar ### How to migrate? Here is an example that can help us migrate some unrefactored toolbars: Check out the more detailed types of [`ToolbarModuleConfig`](c178debf2d/blocksuite/affine/shared/src/services/toolbar-service/config.ts). 1. Add toolbar configuration file to a block type, such as bookmark block: [`config.ts`](c178debf2d/blocksuite/affine/block-bookmark/src/configs/toolbar.ts) ```ts export const builtinToolbarConfig = { actions: [ { id: 'a.preview', content(ctx) { const model = ctx.getCurrentModelBy(BlockSelection, BookmarkBlockModel); if (!model) return null; const { url } = model; return html`<affine-link-preview .url=${url}></affine-link-preview>`; }, }, { id: 'b.conversions', actions: [ { id: 'inline', label: 'Inline view', run(ctx) { }, }, { id: 'card', label: 'Card view', disabled: true, }, { id: 'embed', label: 'Embed view', disabled(ctx) { }, run(ctx) { }, }, ], content(ctx) { }, } satisfies ToolbarActionGroup<ToolbarAction>, { id: 'c.style', actions: [ { id: 'horizontal', label: 'Large horizontal style', }, { id: 'list', label: 'Small horizontal style', }, ], content(ctx) { }, } satisfies ToolbarActionGroup<ToolbarAction>, { id: 'd.caption', tooltip: 'Caption', icon: CaptionIcon(), run(ctx) { }, }, { placement: ActionPlacement.More, id: 'a.clipboard', actions: [ { id: 'copy', label: 'Copy', icon: CopyIcon(), run(ctx) { }, }, { id: 'duplicate', label: 'Duplicate', icon: DuplicateIcon(), run(ctx) { }, }, ], }, { placement: ActionPlacement.More, id: 'b.refresh', label: 'Reload', icon: ResetIcon(), run(ctx) { }, }, { placement: ActionPlacement.More, id: 'c.delete', label: 'Delete', icon: DeleteIcon(), variant: 'destructive', run(ctx) { }, }, ], } as const satisfies ToolbarModuleConfig; ``` 2. Add configuration extension to a block spec: [bookmark's spec](c178debf2d/blocksuite/affine/block-bookmark/src/bookmark-spec.ts) ```ts const flavour = BookmarkBlockSchema.model.flavour; export const BookmarkBlockSpec: ExtensionType[] = [ ..., ToolbarModuleExtension({ id: BlockFlavourIdentifier(flavour), config: builtinToolbarConfig, }), ].flat(); ``` 3. If the bock type already has a toolbar configuration built in, we can customize it in the following ways: Check out the [editor's config](c178debf2d/packages/frontend/core/src/blocksuite/extensions/editor-config/index.ts (L51C4-L54C8)) file. ```ts // Defines a toolbar configuration for the bookmark block type const customBookmarkToolbarConfig = { actions: [ ... ] } as const satisfies ToolbarModuleConfig; // Adds it into the editor's config ToolbarModuleExtension({ id: BlockFlavourIdentifier('custom:affine:bookmark'), config: customBookmarkToolbarConfig, }), ``` 4. If we want to extend the global: ```ts // Defines a toolbar configuration const customWildcardToolbarConfig = { actions: [ ... ] } as const satisfies ToolbarModuleConfig; // Adds it into the editor's config ToolbarModuleExtension({ id: BlockFlavourIdentifier('custom:affine:*'), config: customWildcardToolbarConfig, }), ``` Currently, only most toolbars in page mode have been refactored. Next is edgeless mode.
116 lines
3.0 KiB
TypeScript
116 lines
3.0 KiB
TypeScript
import type { ColorScheme } from '@blocksuite/affine-model';
|
|
import {
|
|
type ToolbarAction,
|
|
ToolbarContext,
|
|
} from '@blocksuite/affine-shared/services';
|
|
import {
|
|
PropTypes,
|
|
requiredProperties,
|
|
ShadowlessElement,
|
|
} from '@blocksuite/block-std';
|
|
import { SignalWatcher } from '@blocksuite/global/utils';
|
|
import { PaletteIcon } from '@blocksuite/icons/lit';
|
|
import {
|
|
computed,
|
|
type ReadonlySignal,
|
|
type Signal,
|
|
} from '@preact/signals-core';
|
|
import { property } from 'lit/decorators.js';
|
|
import { html, type TemplateResult } from 'lit-html';
|
|
import { ifDefined } from 'lit-html/directives/if-defined.js';
|
|
import { repeat } from 'lit-html/directives/repeat.js';
|
|
|
|
import {
|
|
EmbedCardDarkHorizontalIcon,
|
|
EmbedCardDarkListIcon,
|
|
EmbedCardLightHorizontalIcon,
|
|
EmbedCardLightListIcon,
|
|
} from '../icons';
|
|
|
|
const cardStyleMap: Record<ColorScheme, Record<string, TemplateResult>> = {
|
|
light: {
|
|
horizontal: EmbedCardLightHorizontalIcon,
|
|
list: EmbedCardLightListIcon,
|
|
},
|
|
dark: {
|
|
horizontal: EmbedCardDarkHorizontalIcon,
|
|
list: EmbedCardDarkListIcon,
|
|
},
|
|
};
|
|
|
|
@requiredProperties({
|
|
actions: PropTypes.array,
|
|
context: PropTypes.instanceOf(ToolbarContext),
|
|
style$: PropTypes.object,
|
|
})
|
|
export class CardStyleDropdownMenu extends SignalWatcher(ShadowlessElement) {
|
|
@property({ attribute: false })
|
|
accessor actions!: ToolbarAction[];
|
|
|
|
@property({ attribute: false })
|
|
accessor context!: ToolbarContext;
|
|
|
|
@property({ attribute: false })
|
|
accessor style$!: Signal<string> | ReadonlySignal<string>;
|
|
|
|
@property({ attribute: false })
|
|
accessor toggle: ((e: CustomEvent<boolean>) => void) | undefined;
|
|
|
|
icons$ = computed(
|
|
() => cardStyleMap[this.context.themeProvider.theme$.value]
|
|
);
|
|
|
|
override render() {
|
|
const {
|
|
actions,
|
|
context,
|
|
toggle,
|
|
style$: { value: style },
|
|
icons$: { value: icons },
|
|
} = this;
|
|
|
|
return html`
|
|
<editor-menu-button
|
|
@toggle=${toggle}
|
|
.contentPadding="${'8px'}"
|
|
.button=${html`
|
|
<editor-icon-button
|
|
aria-label="Card style"
|
|
.tooltip="${'Card style'}"
|
|
>
|
|
${PaletteIcon()}
|
|
</editor-icon-button>
|
|
`}
|
|
>
|
|
<div>
|
|
${repeat(
|
|
actions,
|
|
action => action.id,
|
|
({ id, label, icon, disabled, run }) => html`
|
|
<editor-icon-button
|
|
aria-label="${label}"
|
|
data-testid="${id}"
|
|
.tooltip="${label}"
|
|
.activeMode="${'border'}"
|
|
.iconContainerWidth="${'76px'}"
|
|
.iconContainerHeight="${'76px'}"
|
|
?active="${id === style}"
|
|
?disabled="${ifDefined(disabled)}"
|
|
@click=${() => run?.(context)}
|
|
>
|
|
${icon || icons[id]}
|
|
</editor-icon-button>
|
|
`
|
|
)}
|
|
</div>
|
|
</editor-menu-button>
|
|
`;
|
|
}
|
|
}
|
|
|
|
declare global {
|
|
interface HTMLElementTagNameMap {
|
|
'affine-card-style-dropdown-menu': CardStyleDropdownMenu;
|
|
}
|
|
}
|