33 * Copyright (c) 2021 - 2022 Vaadin Ltd.
44 * This program is available under Apache License Version 2.0, available at https://vaadin.com/license/
55 */
6- import '@polymer/polymer/lib/elements/dom-repeat.js' ;
76import { html , PolymerElement } from '@polymer/polymer/polymer-element.js' ;
8- import { microTask } from '@vaadin/component-base/src/async.js' ;
97import { ElementMixin } from '@vaadin/component-base/src/element-mixin.js' ;
108import { KeyboardDirectionMixin } from '@vaadin/component-base/src/keyboard-direction-mixin.js' ;
119import { ThemableMixin } from '@vaadin/vaadin-themable-mixin/vaadin-themable-mixin.js' ;
@@ -15,12 +13,15 @@ import { Message } from './vaadin-message.js';
1513 * `<vaadin-message-list>` is a Web Component for showing an ordered list of messages. The messages are rendered as <vaadin-message>
1614 *
1715 * ### Example
16+ *
1817 * To create a new message list, add the component to the page:
18+ *
1919 * ```html
2020 * <vaadin-message-list></vaadin-message-list>
2121 * ```
2222 *
23- * Provide the messages to the message list with the `items` property.
23+ * Provide the messages to the message list with the [`items`](#/elements/vaadin-message-list#property-items) property.
24+ *
2425 * ```js
2526 * document.querySelector('vaadin-message-list').items = [
2627 * { text: 'Hello list', time: 'yesterday', userName: 'Matt Mambo', userAbbr: 'MM', userColorIndex: 1 },
@@ -36,6 +37,9 @@ import { Message } from './vaadin-message.js';
3637 * ----------|----------------
3738 * `list` | The container wrapping messages.
3839 *
40+ * See the [`<vaadin-message>`](#/elements/vaadin-message) documentation for the available
41+ * state attributes and stylable shadow parts of message elements.
42+ *
3943 * See [Styling Components](https://vaadin.com/docs/latest/styling/custom-theme/styling-components) documentation.
4044 *
4145 * @extends HTMLElement
@@ -86,19 +90,7 @@ class MessageList extends KeyboardDirectionMixin(ElementMixin(ThemableMixin(Poly
8690 }
8791 </ style >
8892 < div part ="list " role ="list ">
89- < template is ="dom-repeat " items ="[[items]] ">
90- < vaadin-message
91- time ="[[item.time]] "
92- user-name ="[[item.userName]] "
93- user-abbr ="[[item.userAbbr]] "
94- user-img ="[[item.userImg]] "
95- user-color-index ="[[item.userColorIndex]] "
96- theme$ ="[[item.theme]] "
97- role ="listitem "
98- on-focusin ="_handleFocusEvent "
99- > [[item.text]]</ vaadin-message
100- >
101- </ template >
93+ < slot > </ slot >
10294 </ div >
10395 ` ;
10496 }
@@ -126,24 +118,81 @@ class MessageList extends KeyboardDirectionMixin(ElementMixin(ThemableMixin(Poly
126118
127119 /** @protected */
128120 get _messages ( ) {
129- return Array . from ( this . shadowRoot . querySelectorAll ( 'vaadin-message' ) ) ;
121+ return [ ... this . querySelectorAll ( 'vaadin-message' ) ] ;
130122 }
131123
132124 /** @private */
133125 _itemsChanged ( newVal , oldVal ) {
134- const focusedIndex = this . _getIndexOfFocusableElement ( ) ;
135- if ( newVal && newVal . length ) {
136- const moreItems = ! oldVal || newVal . length > oldVal . length ;
126+ const items = newVal || [ ] ;
127+ const oldItems = oldVal || [ ] ;
128+
129+ if ( items . length || oldItems . length ) {
130+ const focusedIndex = this . _getIndexOfFocusableElement ( ) ;
137131 const closeToBottom = this . scrollHeight < this . clientHeight + this . scrollTop + 50 ;
138- microTask . run ( ( ) => {
139- this . _setTabIndexesByIndex ( focusedIndex ) ;
140- if ( moreItems && closeToBottom ) {
132+
133+ const removed = oldItems . filter ( ( item ) => ! items . includes ( item ) ) ;
134+ const added = [ ...items ] ;
135+
136+ this . _messages . forEach ( ( message ) => {
137+ const item = message . _item ;
138+ if ( removed . includes ( item ) ) {
139+ message . remove ( ) ;
140+ } else if ( added . includes ( item ) ) {
141+ added . splice ( added . indexOf ( item ) , 1 ) ;
142+ }
143+ } ) ;
144+
145+ this . __addMessages ( added , items ) ;
146+
147+ this . _setTabIndexesByIndex ( focusedIndex ) ;
148+
149+ requestAnimationFrame ( ( ) => {
150+ if ( items . length > oldItems . length && closeToBottom ) {
141151 this . _scrollToLastMessage ( ) ;
142152 }
143153 } ) ;
144154 }
145155 }
146156
157+ /** @private */
158+ __addMessages ( itemsToAdd , allItems ) {
159+ itemsToAdd . forEach ( ( item ) => {
160+ const message = this . __createMessage ( item ) ;
161+ const nextItem = allItems [ allItems . indexOf ( item ) + 1 ] ;
162+ const nextMessage = this . _messages . find ( ( msg ) => msg . _item === nextItem ) ;
163+ if ( nextMessage ) {
164+ this . insertBefore ( message , nextMessage ) ;
165+ } else {
166+ this . appendChild ( message ) ;
167+ }
168+ } ) ;
169+ }
170+
171+ /** @private */
172+ __createMessage ( item ) {
173+ const message = document . createElement ( 'vaadin-message' ) ;
174+ message . setAttribute ( 'role' , 'listitem' ) ;
175+
176+ message . textContent = item . text ;
177+ message . time = item . time ;
178+ message . userName = item . userName ;
179+ message . userAbbr = item . userAbbr ;
180+ message . userImg = item . userImg ;
181+ message . userColorIndex = item . userColorIndex ;
182+
183+ message . _item = item ;
184+
185+ if ( item . theme ) {
186+ message . setAttribute ( 'theme' , item . theme ) ;
187+ }
188+
189+ message . addEventListener ( 'focusin' , ( e ) => {
190+ this . _onMessageFocusIn ( e ) ;
191+ } ) ;
192+
193+ return message ;
194+ }
195+
147196 /** @private */
148197 _scrollToLastMessage ( ) {
149198 if ( this . items . length > 0 ) {
@@ -152,7 +201,7 @@ class MessageList extends KeyboardDirectionMixin(ElementMixin(ThemableMixin(Poly
152201 }
153202
154203 /** @private */
155- _handleFocusEvent ( e ) {
204+ _onMessageFocusIn ( e ) {
156205 const target = e . composedPath ( ) . find ( ( node ) => node instanceof Message ) ;
157206 this . _setTabIndexesByMessage ( target ) ;
158207 }
0 commit comments