refactor(editor): extract filterable list component (#9278)

This commit is contained in:
Saul-Mirone
2024-12-24 05:14:22 +00:00
parent ea0a345533
commit 4ce5cf20c3
17 changed files with 64 additions and 69 deletions

View File

@@ -0,0 +1,257 @@
import { PAGE_HEADER_HEIGHT } from '@blocksuite/affine-shared/consts';
import { WithDisposable } from '@blocksuite/global/utils';
import { DoneIcon, SearchIcon } from '@blocksuite/icons/lit';
import { autoPlacement, offset, type Placement, size } from '@floating-ui/dom';
import { html, LitElement, nothing } from 'lit';
import { property, query, state } from 'lit/decorators.js';
import { classMap } from 'lit/directives/class-map.js';
import { type AdvancedPortalOptions, createLitPortal } from '../portal';
import { filterableListStyles } from './styles.js';
import type { FilterableListItem, FilterableListOptions } from './types.js';
export * from './types.js';
export class FilterableListComponent<Props = unknown> extends WithDisposable(
LitElement
) {
static override styles = filterableListStyles;
private _buildContent(items: FilterableListItem<Props>[]) {
return items.map((item, idx) => {
const focussed = this._curFocusIndex === idx;
return html`
<icon-button
class=${classMap({
'filterable-item': true,
focussed,
})}
@mouseover=${() => (this._curFocusIndex = idx)}
@click=${() => this._select(item)}
hover=${focussed}
width="100%"
height="32px"
>
${item.icon ?? nothing} ${item.label ?? item.name}
<div slot="suffix">
${this.options.active?.(item) ? DoneIcon() : nothing}
</div>
</icon-button>
`;
});
}
private _filterItems() {
const searchFilter = !this._filterText
? this.options.items
: this.options.items.filter(
item =>
item.name.startsWith(this._filterText.toLowerCase()) ||
item.aliases?.some(alias =>
alias.startsWith(this._filterText.toLowerCase())
)
);
return searchFilter.sort((a, b) => {
const isActiveA = this.options.active?.(a);
const isActiveB = this.options.active?.(b);
if (isActiveA && !isActiveB) return -1;
if (!isActiveA && isActiveB) return 1;
return this.listFilter?.(a, b) ?? 0;
});
}
private _scrollFocusedItemIntoView() {
this.updateComplete
.then(() => {
this._focussedItem?.scrollIntoView({
block: 'nearest',
inline: 'start',
});
})
.catch(console.error);
}
private _select(item: FilterableListItem) {
this.abortController?.abort();
this.options.onSelect(item);
}
override connectedCallback() {
super.connectedCallback();
requestAnimationFrame(() => {
this._filterInput.focus();
});
}
override render() {
const filteredItems = this._filterItems();
const content = this._buildContent(filteredItems);
const isFlip = !!this.placement?.startsWith('top');
const _handleInputKeydown = (ev: KeyboardEvent) => {
switch (ev.key) {
case 'ArrowUp': {
ev.preventDefault();
this._curFocusIndex =
(this._curFocusIndex + content.length - 1) % content.length;
this._scrollFocusedItemIntoView();
break;
}
case 'ArrowDown': {
ev.preventDefault();
this._curFocusIndex = (this._curFocusIndex + 1) % content.length;
this._scrollFocusedItemIntoView();
break;
}
case 'Enter': {
if (ev.isComposing) break;
ev.preventDefault();
const item = filteredItems[this._curFocusIndex];
this._select(item);
break;
}
case 'Escape': {
ev.preventDefault();
this.abortController?.abort();
break;
}
}
};
return html`
<div
class=${classMap({ 'affine-filterable-list': true, flipped: isFlip })}
>
<div class="input-wrapper">
${SearchIcon()}
<input
id="filter-input"
type="text"
placeholder=${this.options?.placeholder ?? 'Search'}
@input="${() => {
this._filterText = this._filterInput?.value;
this._curFocusIndex = 0;
}}"
@keydown="${_handleInputKeydown}"
/>
</div>
<editor-toolbar-separator
data-orientation="horizontal"
></editor-toolbar-separator>
<div class="items-container">${content}</div>
</div>
`;
}
@state()
private accessor _curFocusIndex = 0;
@query('#filter-input')
private accessor _filterInput!: HTMLInputElement;
@state()
private accessor _filterText = '';
@query('.filterable-item.focussed')
private accessor _focussedItem!: HTMLElement | null;
@property({ attribute: false })
accessor abortController: AbortController | null = null;
@property({ attribute: false })
accessor listFilter:
| ((a: FilterableListItem<Props>, b: FilterableListItem<Props>) => number)
| undefined = undefined;
@property({ attribute: false })
accessor options!: FilterableListOptions<Props>;
@property({ attribute: false })
accessor placement: Placement | undefined = undefined;
}
export function showPopFilterableList({
options,
filter,
abortController = new AbortController(),
referenceElement,
container,
maxHeight = 440,
portalStyles,
}: {
options: FilterableListComponent['options'];
referenceElement: Element;
container?: Element;
abortController?: AbortController;
filter?: FilterableListComponent['listFilter'];
maxHeight?: number;
portalStyles?: AdvancedPortalOptions['portalStyles'];
}) {
const portalPadding = {
top: PAGE_HEADER_HEIGHT + 12,
bottom: 12,
} as const;
const list = new FilterableListComponent();
list.options = options;
list.listFilter = filter;
list.abortController = abortController;
createLitPortal({
closeOnClickAway: true,
template: ({ positionSlot }) => {
positionSlot.on(({ placement }) => {
list.placement = placement;
});
return list;
},
container,
portalStyles,
computePosition: {
referenceElement,
placement: 'bottom-start',
middleware: [
offset(4),
autoPlacement({
allowedPlacements: ['top-start', 'bottom-start'],
padding: portalPadding,
}),
size({
padding: portalPadding,
apply({ availableHeight, elements, placement }) {
Object.assign(elements.floating.style, {
height: '100%',
maxHeight: `${Math.min(maxHeight, availableHeight)}px`,
pointerEvents: 'none',
...(placement.startsWith('top')
? {
display: 'flex',
alignItems: 'flex-end',
}
: {
display: null,
alignItems: null,
}),
});
},
}),
],
autoUpdate: {
// fix the lang list position incorrectly when scrolling
animationFrame: true,
},
},
abortController,
});
}
declare global {
interface HTMLElementTagNameMap {
'affine-filterable-list': FilterableListComponent;
}
}

View File

@@ -0,0 +1,107 @@
import { PANEL_BASE, scrollbarStyle } from '@blocksuite/affine-shared/styles';
import { css } from 'lit';
export const filterableListStyles = css`
:host {
${PANEL_BASE};
flex-direction: column;
padding: 0;
max-height: 100%;
pointer-events: auto;
overflow: hidden;
z-index: var(--affine-z-index-popover);
}
.affine-filterable-list {
display: flex;
flex-direction: column;
align-items: stretch;
justify-content: center;
width: 230px;
padding: 8px;
box-sizing: border-box;
overflow: hidden;
}
.affine-filterable-list.flipped {
flex-direction: column-reverse;
}
.items-container {
display: flex;
flex-direction: column;
gap: 4px;
flex: 1;
overflow-y: scroll;
padding-top: 5px;
padding-left: 4px;
padding-right: 4px;
}
editor-toolbar-separator {
margin: 8px 0;
}
.input-wrapper {
display: flex;
align-items: center;
border-radius: 4px;
padding: 4px 10px;
gap: 4px;
border-width: 1px;
border-style: solid;
border-color: transparent;
}
.input-wrapper:focus-within {
border-color: var(--affine-blue-700);
box-shadow: var(--affine-active-shadow);
}
${scrollbarStyle('.items-container')}
.filterable-item {
display: flex;
justify-content: space-between;
gap: 4px;
padding: 12px;
}
.filterable-item > div[slot='suffix'] {
display: flex;
align-items: center;
}
.filterable-item svg {
width: 20px;
height: 20px;
}
.filterable-item.focussed {
color: var(--affine-blue-700);
background: var(--affine-hover-color-filled);
}
#filter-input {
flex: 1;
align-items: center;
height: 20px;
width: 140px;
border-radius: 8px;
padding-top: 2px;
border: transparent;
background: transparent;
color: inherit;
}
#filter-input:focus {
outline: none;
}
#filter-input::placeholder {
color: var(--affine-placeholder-color);
font-size: var(--affine-font-sm);
}
`;

View File

@@ -0,0 +1,16 @@
import type { TemplateResult } from 'lit';
export interface FilterableListItem<Props = unknown> {
name: string;
label?: string;
icon?: TemplateResult;
aliases?: string[];
props?: Props;
}
export interface FilterableListOptions<Props = unknown> {
placeholder?: string;
items: FilterableListItem<Props>[];
active?: (item: FilterableListItem) => boolean;
onSelect: (item: FilterableListItem) => void;
}