x4js 2.0.35 → 2.1.0-manual

package/src/components/listbox/listbox.ts

@@ -1,596 +1,596 @@
-/** 
- *  ___  ___ __
- *  \  \/  /  / _
- *   \    /  /_| |_
- *   /    \____   _|  
- *  /__/\__\   |_|
- * 
- * @file listbox.ts
- * @author Etienne Cochard 
- * 
- * @copyright (c) 2024 R-libre ingenierie
- *
- * Use of this source code is governed by an MIT-style license 
- * that can be found in the LICENSE file or at https://opensource.org/licenses/MIT.
- **/
-
-import { Component, ComponentEvent, ComponentEvents, componentFromDOM, ComponentProps, EvChange, EvClick, EvContextMenu, EvDblClick, EvSelectionChange } from '../../core/component';
-import { EventCallback } from '../../core/core_events';
-import { kbNav, class_ns, isArray, UnsafeHtml, asap } from '../../core/core_tools';
-
-import { ScrollView, Viewport } from '../viewport/viewport';
-import { Header } from '../header/header';
-
-import { HBox } from '../boxes/boxes';
-import { Label } from '../label/label';
-
-import "./listbox.module.scss"
-
-export type ListboxID = number | string;
-
-export interface ListItem {
-	id: ListboxID;
-	text: string | UnsafeHtml;
-
-	iconId?: string;
-	data?: any;
-	cls?: string;
-	checked?: boolean;
-}
-
-/**
- * 
- */
-
-export interface ListboxEvents extends ComponentEvents {
-	click?: EvClick;
-	dblClick?: EvDblClick;
-	contextMenu?: EvContextMenu;
-	selectionChange?: EvSelectionChange;
-}
-
-/**
- * 
- */
-
-export interface ListboxProps extends Omit<ComponentProps,'content'> {
-	items?: ListItem[];
-	renderer?: ( item: ListItem ) => Component;
-	title?: string;
-	icon?: string;
-	header?: Header;
-	footer?: Component,
-	checkable?: true,
-	multisel?: true,
-
-	dblClick?: EventCallback<EvDblClick>;
-	selectionChange?: EventCallback<EvSelectionChange>;
-	contextMenu?: EventCallback<EvContextMenu>;
-}
-
-/**
- * 
- */
-
-@class_ns( "x4" )
-export class Listbox extends Component<ListboxProps,ListboxEvents> {
-
-	private _view: Viewport;
-	//private _selection: ListboxID;
-	//private _selitem: Component;
-	
-	private _lastsel: ListboxID;
-	
-	private _multisel: Set<ListboxID>;
-	private _items: ListItem[];
-
-	preventFocus = false;
-
-	constructor( props: ListboxProps ) {
-		super( { ...props } );
-
-		this.setAttribute( "tabindex", 0 );
-		this.mapPropEvents( props, "dblClick", "selectionChange", "contextMenu" );
-		
-		const scroller = new ScrollView( { cls: "body" } );
-		this._view = scroller.getViewport( );
-		this._multisel = new Set( );
-		this._items = [];
-
-		if( props.footer ) {
-			props.footer.setAttribute( "id", "footer" );
-		}
-
-		if( props.header ) {
-			props.header.setAttribute( "id", "header" );
-		}
-
-		this.setContent( [
-			(props.title || props.icon) ? new Label( { cls: 'title', text: props.title, icon: props.icon }) : null,
-			props.header ? props.header : null,
-			scroller,
-			props.footer,
-		] );
-		
-		this.setDOMEvents( {
-			click: 	 (ev) => this._on_click( ev ),
-			keydown: ( ev ) => this._on_key( ev ),
-			dblclick: (e) => this._on_click(e),
-			contextmenu: (e) => this._on_ctx_menu(e),
-		} );
-
-		if( props.items ) {
-			this.setItems( props.items, false );
-		}
-	}
-
-	/**
-	 * 
-	 */
-
-	private _on_key( ev: KeyboardEvent ) {
-		if( this.isDisabled() ) {
-			return;
-		}
-
-		switch( ev.key ) {
-			case "ArrowDown": {
-				this.navigate( kbNav.next );
-				break;
-			}
-
-			case "ArrowUp": {
-				this.navigate( kbNav.prev );
-				break;
-			}
-
-			case "Home": {
-				this.navigate( kbNav.first );
-				break;
-			}
-
-			case "End": {
-				this.navigate( kbNav.last );
-				break;
-			}
-
-			default:
-				return;
-		}
-
-		ev.preventDefault( );
-		ev.stopPropagation( );
-	}
-
-	/**
-	 * 
-	 */
-
-	navigate( sens: kbNav ) {
-		
-		if( !this._lastsel ) {
-			if( sens==kbNav.next )  sens = kbNav.first;
-			else sens = kbNav.last;
-		}
-
-		const next_visible = ( el: Component, down: boolean ) => {
-			
-			while( el && !el.isVisible() ) {
-				el = down ? el.nextElement() : el.prevElement();
-			}
-
-			return el;
-		}
-
-		if( sens==kbNav.first || sens==kbNav.last ) {
-			let fel = sens==kbNav.first ? this._view.firstChild() : this._view.lastChild( );
-			fel = next_visible( fel, sens==kbNav.first );
-
-			if( fel ) {
-				const id = fel.getInternalData( "id" );
-				this._selectItem( id, fel, 'single' );
-				return true;
-			}
-		}
-		else {
-			const selitem = this._itemWithID( this._lastsel );
-
-			let nel;
-			if( selitem ) {
-				nel = sens==kbNav.next ? selitem.nextElement() : selitem.prevElement();
-				nel = next_visible( nel, sens==kbNav.next );
-			}
-			else {
-				nel = sens==kbNav.next ? this._view.firstChild() : this._view.lastChild( );
-			}
-
-			if( nel ) {
-				const id = nel.getInternalData( "id" );
-				this._selectItem( id, nel, 'single' );
-				return true;
-			}
-		}
-
-		return false;
-	}
-
-	/**
-	 * 
-	 */
-
-	private _itemWithID( id: ListboxID ) {
-		//const itm = this.query( `[data-id="${id}"]` );
-		const all = this._view.enumChildComponents( false );
-		return all.find( x => x.getInternalData("id")===id )
-	}
-
-	/**
-	 * 
-	 */
-	
-	private _on_click( ev: MouseEvent ) {
-		let target = ev.target as HTMLElement;
-
-		while( target && target!=this.dom ) {
-			const c = componentFromDOM( target );
-
-			// avoid trapping child ckick
-			if( c.dom.tagName==='INPUT' ) {
-				return;
-			}
-
-			if( c && c.hasClass("x4item") ) {
-				const id = c.getInternalData( "id" );
-				const fev: ComponentEvent = { context:id };
-				if (ev.type == 'click') {
-					this.fire('click', fev );
-				}
-				else {
-					this.fire('dblClick', fev );
-				}
-
-				if (!fev.defaultPrevented) {
-					this._selectItem( id, c, ev.ctrlKey ? 'toggle' : 'single' );
-				}
-				
-				return;
-			}
-
-			target = target.parentElement;
-		}
-
-		this.clearSelection( );
-
-		ev.stopImmediatePropagation();
-		ev.preventDefault( );
-	}
-
-	/**
-	 * 
-	 */
-
-	private _on_ctx_menu(ev: MouseEvent) {
-
-		ev.preventDefault();		
-
-		let target = ev.target as HTMLElement;
-		while( target && target!=this.dom ) {
-			const c = componentFromDOM( target );
-			if( c && c.hasClass("x4item") ) {
-				const id = c.getInternalData( "id" );
-				
-				this._selectItem(id, c, 'single' );
-				this.fire('contextMenu', {uievent: ev, context: id } );
-			
-				return;
-			}
-
-			target = target.parentElement;
-		}
-
-		this.fire('contextMenu', { uievent:ev, context: null } );
-	}
-
-	/**
-	 * 
-	 */
-
-	private _selectItem( id: ListboxID, item: Component, mode: "single" | "toggle" ) {
-		
-		if( !this.props.multisel ) {
-			mode = 'single';
-		}
-
-		this._lastsel = id;
-
-		if( mode=='single' ) {
-			if( this._multisel.has(id) ) {
-				return;
-			}
-
-			this._clearSelection( );
-			if( item ) {
-				this._multisel.add( id );
-				item.addClass( "selected" );
-			}
-		}
-		else {	// toggle
-			if( item ) {
-				if( this._multisel.has(id) ) {
-					item.removeClass( "selected" );
-					this._multisel.delete( id );
-				}
-				else {
-					this._multisel.add( id );
-					item.addClass( "selected" );
-				}
-			}
-		}
-		
-		if( item ) {
-			item.scrollIntoView( {
-				behavior: "smooth",
-				block: "nearest"
-			} );
-		}
-
-		this.fire( "selectionChange", { selection: this.getSelection(), empty: this._multisel.size==0 } );
-	}
-
-	/**
-	 * 
-	 */
-
-	getItem( id: ListboxID ): ListItem {
-		return this._items.find( x => x.id===id );
-	}
-
-	/**
-	 * select an item by it's id
-	 */
-
-	select( ids: ListboxID | ListboxID[], notify = true ) {
-
-		if( !isArray(ids) ) {
-			ids = [ids];
-		}
-
-		if( !ids.length ) {
-			if( this._multisel.size ) {
-				if( notify ) {
-					this.clearSelection( );
-				}
-				else {
-					this._clearSelection( );
-				}
-			}
-
-			return;
-		}
-
-		// if one of new selection not in old selection...
-		if( ids.some( x => !this._multisel.has(x)) ) {
-			this._clearSelection( );
-			const all = this._view.enumChildComponents( false );
-
-			ids.forEach( id => {
-				const itm = all.find( x => x.getInternalData("id")===id );	//this.query( `[data-id="${id}"]` );
-				if( itm ) {
-					this._multisel.add( id );
-					itm.addClass( "selected" );
-				}
-			});
-
-			if( notify ) {
-				this.fire( "selectionChange", { selection: this.getSelection(), empty: this._multisel.size==0 } );
-			}
-		}
-	}
-	
-	/**
-	 * 
-	 */
-	
-	private _findItemIndex( id: ListboxID ) {
-		return this._items.findIndex( x => x.id==id );
-	}
-
-	/**
-	 * 
-	 */
-
-	private _clearSelection( ) {
-
-		const all = this._view.enumChildComponents( false );
-
-		if( this._multisel.size ) {
-			const ids = Array.from( this._multisel );
-			ids.forEach( id => {
-				const itm = all.find( x => x.getInternalData("id")===id );	//this.query( `[data-id="${id}"]` );
-				if( itm ) {
-					itm.removeClass( "selected" );	
-				}
-			} );
-		}
-		
-		this._multisel.clear( );
-	}
-
-	clearSelection( fireEvent = true ) {
-		if( this._multisel.size ) {
-			this._clearSelection( );
-			if( fireEvent ) {
-				this.fire( "selectionChange", { selection: [], empty: true } );
-			}
-		}
-	}
-	
-	/**
-	 * 
-	 */
-
-	setItems( items: ListItem[], keepSel = false ) {
-
-		const oldSel = this.getSelection( );
-
-		this.clearSelection( );
-		this._view.clearContent( );
-		this._items = items ?? [];
-
-		let update_sel = false;
-
-		if( this._items.length ) {
-			const content = items.map( x => this.renderItem(x) );
-			this._view.setContent( content );
-
-			if( keepSel && oldSel.length>0 ) {
-				this.select( oldSel );
-			}
-		}
-		else {
-			update_sel = oldSel.length>0;
-		}
-		
-		if( update_sel ) {
-			this.setTimeout( "sel", 100, ( ) => {
-				this.fire( "selectionChange", { selection: [], empty: true } );
-			} );
-		}
-	}
-
-	/**
-	 * 
-	 */
-
-	renderItem( item: ListItem ) {
-		const renderer = this.props.renderer ?? this.defaultRenderer;
-		const line = renderer( item );
-	
-		line.addClass( "x4item" );
-		line.setInternalData( "id", item.id );
-		
-		return line;
-	}
-
-	/**
-	 * 
-	 */
-
-	defaultRenderer( item: ListItem ): Component {
-		return new HBox( {
-			cls: item.cls,
-			content: new Label( { icon: item.iconId, text: item.text }) 
-		} )
-	}
-
-	/**
-	 * 
-	 */
-
-	filter( filter: string | RegExp ) {
-		const childs = this._view.enumChildComponents( false );
-		
-		if( !filter ) {
-			childs.forEach( x => x.show( true ) );
-		}
-		else {
-			// get list of visible items
-			let filtred: Set<ListboxID>;
-
-			if( filter instanceof RegExp ) {
-				const f = filter as RegExp;
-				filtred = new Set( this._items
-						.filter( x => f.test(x.text as string) )
-						.map( x => x.id ) ); 
-			}
-			else {
-				const f = filter.toUpperCase( );
-				filtred = new Set( this._items
-					.filter( x => x.text.toUpperCase().includes(f) )
-					.map( x => x.id ) );
-			}
-
-			// now hide all elements not in list
-			childs.forEach( x => {
-				x.show( filtred.has( x.getInternalData( "id" ) ) );
-			});
-		}
-	}
-
-	/**
-	 * append or prepend a new item
-	 * @param item 
-	 * @param prepend 
-	 * @param select 
-	 */
-
-	appendItem( item: ListItem, prepend = false, select = true ) {
-		
-		if( select ) {
-			this._clearSelection( );
-		}
-
-		let el = this.renderItem( item );
-
-		if( prepend ) {
-			this._items.unshift( item );
-			this._view.prependContent( el );
-		}
-		else {
-			this._items.push( item );
-			this._view.appendContent( el );
-		}
-
-		if( select ) {
-			this._selectItem( item.id, el, 'single' );
-		}
-	}
-
-	/**
-	 * update an item
-	 */
-
-	 updateItem( id: any, item: ListItem ) {
-
-		// find item
-		const idx = this._findItemIndex( id );
-		if( idx<0 ) {
-			return;
-		}
-		
-		// take care of selection
-		let was_sel = false;
-		if( this._multisel.has(id) ) {
-			was_sel = true;
-		}
-
-		// replace it in the list
-		this._items[idx] = item;
-
-		// rebuild & replace it's line
-		const old = this._itemWithID( item.id );
-		if( old?.dom ) {
-			const _new = this.renderItem( item );
-			if( was_sel ) {
-				_new.addClass( "selected" );
-			}
-
-			this._view.dom.replaceChild( _new.dom, old.dom );
-		}
-	}
-
-	getSelection( ) {
-		return Array.from( this._multisel );
-	}
-
-	ensureSelectionVisible( ) {
-		const sels = Array.from( this._multisel.values() );
-		if( sels.length) {
-			const item = this._itemWithID( sels[0] );
-			item?.scrollIntoView( {
-				behavior: "instant",
-				block: "nearest"
-			} )
-		}
-	}
-}
+/** 
+ *  ___  ___ __
+ *  \  \/  /  / _
+ *   \    /  /_| |_
+ *   /    \____   _|  
+ *  /__/\__\   |_|
+ * 
+ * @file listbox.ts
+ * @author Etienne Cochard 
+ * 
+ * @copyright (c) 2024 R-libre ingenierie
+ *
+ * Use of this source code is governed by an MIT-style license 
+ * that can be found in the LICENSE file or at https://opensource.org/licenses/MIT.
+ **/
+
+import { Component, ComponentEvent, ComponentEvents, componentFromDOM, ComponentProps, EvChange, EvClick, EvContextMenu, EvDblClick, EvSelectionChange } from '../../core/component';
+import { EventCallback } from '../../core/core_events';
+import { kbNav, class_ns, isArray, UnsafeHtml, asap } from '../../core/core_tools';
+
+import { ScrollView, Viewport } from '../viewport/viewport';
+import { Header } from '../header/header';
+
+import { HBox } from '../boxes/boxes';
+import { Label } from '../label/label';
+
+import "./listbox.module.scss"
+
+export type ListboxID = number | string;
+
+export interface ListItem {
+	id: ListboxID;
+	text: string | UnsafeHtml;
+
+	iconId?: string;
+	data?: any;
+	cls?: string;
+	checked?: boolean;
+}
+
+/**
+ * 
+ */
+
+export interface ListboxEvents extends ComponentEvents {
+	click?: EvClick;
+	dblClick?: EvDblClick;
+	contextMenu?: EvContextMenu;
+	selectionChange?: EvSelectionChange;
+}
+
+/**
+ * 
+ */
+
+export interface ListboxProps extends Omit<ComponentProps,'content'> {
+	items?: ListItem[];
+	renderer?: ( item: ListItem ) => Component;
+	title?: string;
+	icon?: string;
+	header?: Header;
+	footer?: Component,
+	checkable?: true,
+	multisel?: true,
+
+	dblClick?: EventCallback<EvDblClick>;
+	selectionChange?: EventCallback<EvSelectionChange>;
+	contextMenu?: EventCallback<EvContextMenu>;
+}
+
+/**
+ * 
+ */
+
+@class_ns( "x4" )
+export class Listbox extends Component<ListboxProps,ListboxEvents> {
+
+	private _view: Viewport;
+	//private _selection: ListboxID;
+	//private _selitem: Component;
+	
+	private _lastsel: ListboxID;
+	
+	private _multisel: Set<ListboxID>;
+	private _items: ListItem[];
+
+	preventFocus = false;
+
+	constructor( props: ListboxProps ) {
+		super( { ...props } );
+
+		this.setAttribute( "tabindex", 0 );
+		this.mapPropEvents( props, "dblClick", "selectionChange", "contextMenu" );
+		
+		const scroller = new ScrollView( { cls: "body" } );
+		this._view = scroller.getViewport( );
+		this._multisel = new Set( );
+		this._items = [];
+
+		if( props.footer ) {
+			props.footer.setAttribute( "id", "footer" );
+		}
+
+		if( props.header ) {
+			props.header.setAttribute( "id", "header" );
+		}
+
+		this.setContent( [
+			(props.title || props.icon) ? new Label( { cls: 'title', text: props.title, icon: props.icon }) : null,
+			props.header ? props.header : null,
+			scroller,
+			props.footer,
+		] );
+		
+		this.setDOMEvents( {
+			click: 	 (ev) => this._on_click( ev ),
+			keydown: ( ev ) => this._on_key( ev ),
+			dblclick: (e) => this._on_click(e),
+			contextmenu: (e) => this._on_ctx_menu(e),
+		} );
+
+		if( props.items ) {
+			this.setItems( props.items, false );
+		}
+	}
+
+	/**
+	 * 
+	 */
+
+	private _on_key( ev: KeyboardEvent ) {
+		if( this.isDisabled() ) {
+			return;
+		}
+
+		switch( ev.key ) {
+			case "ArrowDown": {
+				this.navigate( kbNav.next );
+				break;
+			}
+
+			case "ArrowUp": {
+				this.navigate( kbNav.prev );
+				break;
+			}
+
+			case "Home": {
+				this.navigate( kbNav.first );
+				break;
+			}
+
+			case "End": {
+				this.navigate( kbNav.last );
+				break;
+			}
+
+			default:
+				return;
+		}
+
+		ev.preventDefault( );
+		ev.stopPropagation( );
+	}
+
+	/**
+	 * 
+	 */
+
+	navigate( sens: kbNav ) {
+		
+		if( !this._lastsel ) {
+			if( sens==kbNav.next )  sens = kbNav.first;
+			else sens = kbNav.last;
+		}
+
+		const next_visible = ( el: Component, down: boolean ) => {
+			
+			while( el && !el.isVisible() ) {
+				el = down ? el.nextElement() : el.prevElement();
+			}
+
+			return el;
+		}
+
+		if( sens==kbNav.first || sens==kbNav.last ) {
+			let fel = sens==kbNav.first ? this._view.firstChild() : this._view.lastChild( );
+			fel = next_visible( fel, sens==kbNav.first );
+
+			if( fel ) {
+				const id = fel.getInternalData( "id" );
+				this._selectItem( id, fel, 'single' );
+				return true;
+			}
+		}
+		else {
+			const selitem = this._itemWithID( this._lastsel );
+
+			let nel;
+			if( selitem ) {
+				nel = sens==kbNav.next ? selitem.nextElement() : selitem.prevElement();
+				nel = next_visible( nel, sens==kbNav.next );
+			}
+			else {
+				nel = sens==kbNav.next ? this._view.firstChild() : this._view.lastChild( );
+			}
+
+			if( nel ) {
+				const id = nel.getInternalData( "id" );
+				this._selectItem( id, nel, 'single' );
+				return true;
+			}
+		}
+
+		return false;
+	}
+
+	/**
+	 * 
+	 */
+
+	private _itemWithID( id: ListboxID ) {
+		//const itm = this.query( `[data-id="${id}"]` );
+		const all = this._view.enumChildComponents( false );
+		return all.find( x => x.getInternalData("id")===id )
+	}
+
+	/**
+	 * 
+	 */
+	
+	private _on_click( ev: MouseEvent ) {
+		let target = ev.target as HTMLElement;
+
+		while( target && target!=this.dom ) {
+			const c = componentFromDOM( target );
+
+			// avoid trapping child ckick
+			if( c.dom.tagName==='INPUT' ) {
+				return;
+			}
+
+			if( c && c.hasClass("x4item") ) {
+				const id = c.getInternalData( "id" );
+				const fev: ComponentEvent = { context:id };
+				if (ev.type == 'click') {
+					this.fire('click', fev );
+				}
+				else {
+					this.fire('dblClick', fev );
+				}
+
+				if (!fev.defaultPrevented) {
+					this._selectItem( id, c, ev.ctrlKey ? 'toggle' : 'single' );
+				}
+				
+				return;
+			}
+
+			target = target.parentElement;
+		}
+
+		this.clearSelection( );
+
+		ev.stopImmediatePropagation();
+		ev.preventDefault( );
+	}
+
+	/**
+	 * 
+	 */
+
+	private _on_ctx_menu(ev: MouseEvent) {
+
+		ev.preventDefault();		
+
+		let target = ev.target as HTMLElement;
+		while( target && target!=this.dom ) {
+			const c = componentFromDOM( target );
+			if( c && c.hasClass("x4item") ) {
+				const id = c.getInternalData( "id" );
+				
+				this._selectItem(id, c, 'single' );
+				this.fire('contextMenu', {uievent: ev, context: id } );
+			
+				return;
+			}
+
+			target = target.parentElement;
+		}
+
+		this.fire('contextMenu', { uievent:ev, context: null } );
+	}
+
+	/**
+	 * 
+	 */
+
+	private _selectItem( id: ListboxID, item: Component, mode: "single" | "toggle" ) {
+		
+		if( !this.props.multisel ) {
+			mode = 'single';
+		}
+
+		this._lastsel = id;
+
+		if( mode=='single' ) {
+			if( this._multisel.has(id) ) {
+				return;
+			}
+
+			this._clearSelection( );
+			if( item ) {
+				this._multisel.add( id );
+				item.addClass( "selected" );
+			}
+		}
+		else {	// toggle
+			if( item ) {
+				if( this._multisel.has(id) ) {
+					item.removeClass( "selected" );
+					this._multisel.delete( id );
+				}
+				else {
+					this._multisel.add( id );
+					item.addClass( "selected" );
+				}
+			}
+		}
+		
+		if( item ) {
+			item.scrollIntoView( {
+				behavior: "smooth",
+				block: "nearest"
+			} );
+		}
+
+		this.fire( "selectionChange", { selection: this.getSelection(), empty: this._multisel.size==0 } );
+	}
+
+	/**
+	 * 
+	 */
+
+	getItem( id: ListboxID ): ListItem {
+		return this._items.find( x => x.id===id );
+	}
+
+	/**
+	 * select an item by it's id
+	 */
+
+	select( ids: ListboxID | ListboxID[], notify = true ) {
+
+		if( !isArray(ids) ) {
+			ids = [ids];
+		}
+
+		if( !ids.length ) {
+			if( this._multisel.size ) {
+				if( notify ) {
+					this.clearSelection( );
+				}
+				else {
+					this._clearSelection( );
+				}
+			}
+
+			return;
+		}
+
+		// if one of new selection not in old selection...
+		if( ids.some( x => !this._multisel.has(x)) ) {
+			this._clearSelection( );
+			const all = this._view.enumChildComponents( false );
+
+			ids.forEach( id => {
+				const itm = all.find( x => x.getInternalData("id")===id );	//this.query( `[data-id="${id}"]` );
+				if( itm ) {
+					this._multisel.add( id );
+					itm.addClass( "selected" );
+				}
+			});
+
+			if( notify ) {
+				this.fire( "selectionChange", { selection: this.getSelection(), empty: this._multisel.size==0 } );
+			}
+		}
+	}
+	
+	/**
+	 * 
+	 */
+	
+	private _findItemIndex( id: ListboxID ) {
+		return this._items.findIndex( x => x.id==id );
+	}
+
+	/**
+	 * 
+	 */
+
+	private _clearSelection( ) {
+
+		const all = this._view.enumChildComponents( false );
+
+		if( this._multisel.size ) {
+			const ids = Array.from( this._multisel );
+			ids.forEach( id => {
+				const itm = all.find( x => x.getInternalData("id")===id );	//this.query( `[data-id="${id}"]` );
+				if( itm ) {
+					itm.removeClass( "selected" );	
+				}
+			} );
+		}
+		
+		this._multisel.clear( );
+	}
+
+	clearSelection( fireEvent = true ) {
+		if( this._multisel.size ) {
+			this._clearSelection( );
+			if( fireEvent ) {
+				this.fire( "selectionChange", { selection: [], empty: true } );
+			}
+		}
+	}
+	
+	/**
+	 * 
+	 */
+
+	setItems( items: ListItem[], keepSel = false ) {
+
+		const oldSel = this.getSelection( );
+
+		this.clearSelection( );
+		this._view.clearContent( );
+		this._items = items ?? [];
+
+		let update_sel = false;
+
+		if( this._items.length ) {
+			const content = items.map( x => this.renderItem(x) );
+			this._view.setContent( content );
+
+			if( keepSel && oldSel.length>0 ) {
+				this.select( oldSel );
+			}
+		}
+		else {
+			update_sel = oldSel.length>0;
+		}
+		
+		if( update_sel ) {
+			this.setTimeout( "sel", 100, ( ) => {
+				this.fire( "selectionChange", { selection: [], empty: true } );
+			} );
+		}
+	}
+
+	/**
+	 * 
+	 */
+
+	renderItem( item: ListItem ) {
+		const renderer = this.props.renderer ?? this.defaultRenderer;
+		const line = renderer( item );
+	
+		line.addClass( "x4item" );
+		line.setInternalData( "id", item.id );
+		
+		return line;
+	}
+
+	/**
+	 * 
+	 */
+
+	defaultRenderer( item: ListItem ): Component {
+		return new HBox( {
+			cls: item.cls,
+			content: new Label( { icon: item.iconId, text: item.text }) 
+		} )
+	}
+
+	/**
+	 * 
+	 */
+
+	filter( filter: string | RegExp ) {
+		const childs = this._view.enumChildComponents( false );
+		
+		if( !filter ) {
+			childs.forEach( x => x.show( true ) );
+		}
+		else {
+			// get list of visible items
+			let filtred: Set<ListboxID>;
+
+			if( filter instanceof RegExp ) {
+				const f = filter as RegExp;
+				filtred = new Set( this._items
+						.filter( x => f.test(x.text as string) )
+						.map( x => x.id ) ); 
+			}
+			else {
+				const f = filter.toUpperCase( );
+				filtred = new Set( this._items
+					.filter( x => x.text.toUpperCase().includes(f) )
+					.map( x => x.id ) );
+			}
+
+			// now hide all elements not in list
+			childs.forEach( x => {
+				x.show( filtred.has( x.getInternalData( "id" ) ) );
+			});
+		}
+	}
+
+	/**
+	 * append or prepend a new item
+	 * @param item 
+	 * @param prepend 
+	 * @param select 
+	 */
+
+	appendItem( item: ListItem, prepend = false, select = true ) {
+		
+		if( select ) {
+			this._clearSelection( );
+		}
+
+		let el = this.renderItem( item );
+
+		if( prepend ) {
+			this._items.unshift( item );
+			this._view.prependContent( el );
+		}
+		else {
+			this._items.push( item );
+			this._view.appendContent( el );
+		}
+
+		if( select ) {
+			this._selectItem( item.id, el, 'single' );
+		}
+	}
+
+	/**
+	 * update an item
+	 */
+
+	 updateItem( id: any, item: ListItem ) {
+
+		// find item
+		const idx = this._findItemIndex( id );
+		if( idx<0 ) {
+			return;
+		}
+		
+		// take care of selection
+		let was_sel = false;
+		if( this._multisel.has(id) ) {
+			was_sel = true;
+		}
+
+		// replace it in the list
+		this._items[idx] = item;
+
+		// rebuild & replace it's line
+		const old = this._itemWithID( item.id );
+		if( old?.dom ) {
+			const _new = this.renderItem( item );
+			if( was_sel ) {
+				_new.addClass( "selected" );
+			}
+
+			this._view.dom.replaceChild( _new.dom, old.dom );
+		}
+	}
+
+	getSelection( ) {
+		return Array.from( this._multisel );
+	}
+
+	ensureSelectionVisible( ) {
+		const sels = Array.from( this._multisel.values() );
+		if( sels.length) {
+			const item = this._itemWithID( sels[0] );
+			item?.scrollIntoView( {
+				behavior: "instant",
+				block: "nearest"
+			} )
+		}
+	}
+}