pinafore/routes/_components/timeline/Timeline.html

<h1 class="sr-only">{{label}}</h1>
<div class="timeline"
     role="feed"
     on:focusWithCapture="saveFocus(event)"
     on:blurWithCapture="clearFocus(event)"
>
  {{#if virtual}}
    <VirtualList component="{{VirtualListComponent}}"
                 realm="{{$currentInstance + '/' + timeline}}"
                 containerQuery=".container"
                 :makeProps
                 items="{{$timelineItemIds}}"
                 showFooter="{{$timelineInitialized && $runningUpdate}}"
                 footerComponent="{{LoadingFooter}}"
                 showHeader="{{$showHeader}}"
                 headerComponent="{{MoreHeaderVirtualWrapper}}"
                 :headerProps
                 on:scrollToBottom="onScrollToBottom()"
                 on:scrollToTop="onScrollToTop()"
                 on:scrollTopChanged="onScrollTopChanged(event)"
                 on:initialized="initialize()"
                 on:noNeedToScroll="onNoNeedToScroll()"
    />
  {{else}}
    <!-- if this is a status thread, it's easier to just render the
         whole thing rather than use a virtual list -->
    <PseudoVirtualList
               component="{{VirtualListComponent}}"
               realm="{{$currentInstance + '/' + timeline}}"
               containerQuery=".container"
               :makeProps
               items="{{$timelineItemIds}}"
               scrollToItem="{{scrollToItem}}"
               on:initialized="initialize()"
    />
  {{/if}}
</div>
<script>
  import { store } from '../../_store/store'
  import StatusVirtualListItem from './StatusVirtualListItem.html'
  import NotificationVirtualListItem from './NotificationVirtualListItem.html'
  import Status from '../status/Status.html'
  import LoadingFooter from './LoadingFooter.html'
  import MoreHeaderVirtualWrapper from './MoreHeaderVirtualWrapper.html'
  import VirtualList from '../virtualList/VirtualList.html'
  import PseudoVirtualList from '../pseudoVirtualList/PseudoVirtualList.html'
  import { timelines } from '../../_static/timelines'
  import {
    getStatus as getStatusFromDatabase,
    getNotification as getNotificationFromDatabase
  } from '../../_database/timelines/getStatusOrNotification'
  import {
    fetchTimelineItemsOnScrollToBottom,
    setupTimeline,
    showMoreItemsForTimeline,
    showMoreItemsForThread,
    showMoreItemsForCurrentTimeline
  } from '../../_actions/timeline'
  import { focusWithCapture, blurWithCapture } from '../../_utils/events'
  import { scheduleIdleTask } from '../../_utils/scheduleIdleTask'
  import { mark, stop } from '../../_utils/marks'
  import isEqual from 'lodash-es/isEqual'
  import { doubleRAF } from '../../_utils/doubleRAF'

  export default {
    oncreate() {
      console.log('timeline oncreate()')
      this.setupFocus()
      setupTimeline()
      this.restoreFocus()
      this.setupStreaming()
    },
    ondestroy() {
      console.log('ondestroy')
      this.teardownFocus()
    },
    data: () => ({
      LoadingFooter,
      MoreHeaderVirtualWrapper,
      Status,
      scrollTop: 0
    }),
    computed: {
      VirtualListComponent: (timelineType) => {
        return timelineType === 'notifications' ? NotificationVirtualListItem : StatusVirtualListItem
      },
      makeProps: ($currentInstance, timelineType, timelineValue) => async (itemId) => {
        let res = {
          timelineType,
          timelineValue
        }
        if (timelineType === 'notifications') {
          res.notification = await getNotificationFromDatabase($currentInstance, itemId)
        } else {
          res.status = await getStatusFromDatabase($currentInstance, itemId)
        }
        return res
      },
      label: (timeline, $currentInstance, timelineType, timelineValue) => {
        if (timelines[timeline]) {
          return `${timelines[timeline].label} timeline for ${$currentInstance}`
        }

        switch (timelineType) {
          case 'tag':
            return `#${timelineValue} timeline for ${$currentInstance}`
          case 'status':
            return 'Status context'
          case 'account':
            return `Account #${timelineValue} on ${$currentInstance}`
          case 'list':
            return `List #${timelineValue} on ${$currentInstance}`
          case 'notifications':
            return `Notifications for ${$currentInstance}`
        }
      },
      timelineType: (timeline) => {
        return timeline.split('/')[0]
      },
      timelineValue: (timeline) => {
        return timeline.split('/').slice(-1)[0]
      },
      // for threads, it's simpler to just render all items as a pseudo-virtual list
      // due to need to scroll to the right item and thus calculate all item heights up-front
      virtual: (timelineType) => timelineType !=='status',
      scrollToItem: (timelineType, timelineValue, $firstTimelineItemId) => {
        // Scroll to the first item if this is a "status in own thread" timeline.
        // Don't scroll to the first item because it obscures the "back" button.
        return timelineType === 'status'
          && $firstTimelineItemId
          && timelineValue !== $firstTimelineItemId
          && timelineValue
      },
      itemIdsToAdd: ($itemIdsToAdd) => $itemIdsToAdd,
      headerProps: (itemIdsToAdd) => {
        return {
          count: itemIdsToAdd ? itemIdsToAdd.length : 0,
          onClick: showMoreItemsForCurrentTimeline
        }
      }
    },
    store: () => store,
    components: {
      VirtualList,
      PseudoVirtualList
    },
    events: {
      focusWithCapture,
      blurWithCapture
    },
    methods: {
      initialize() {
        let { initializeStarted } = this.get()
        if (initializeStarted) {
          return
        }
        this.set({initializeStarted: true})
        mark('initializeTimeline')
        doubleRAF(() => {
          console.log('timeline initialized')
          this.store.set({timelineInitialized: true})
          stop('initializeTimeline')
        })
      },
      onScrollTopChanged(scrollTop) {
        this.set({scrollTop: scrollTop})
      },
      onScrollToBottom() {
        let {
          timelineInitialized,
          runningUpdate
        } = this.store.get()
        let {
          timelineType
        } = this.get()
        if (!timelineInitialized ||
            runningUpdate ||
            timelineType === 'status') { // for status contexts, we've already fetched the whole thread
          return
        }
        let { currentInstance } = this.store.get()
        let { timeline } = this.get()
        fetchTimelineItemsOnScrollToBottom(
          currentInstance,
          timeline
        )
      },
      onScrollToTop() {
        let { shouldShowHeader } = this.store.get()
        if (shouldShowHeader) {
          this.store.setForCurrentTimeline({
            showHeader: true,
            shouldShowHeader: false
          })
        }
      },
      setupStreaming() {
        let { currentInstance } = this.store.get()
        let { timeline } = this.get()
        let handleItemIdsToAdd = () => {
          let { itemIdsToAdd } = this.get() || {} // TODO: wtf svelte?
          if (!itemIdsToAdd || !itemIdsToAdd.length) {
            return
          }
          mark('handleItemIdsToAdd')
          let { scrollTop } = this.get()
          let {
            shouldShowHeader,
            showHeader
          } = this.store.get()
          if (timeline.startsWith('status/')) {
            // this is a thread, just insert the statuses already
            showMoreItemsForThread(currentInstance, timeline)
          } else if (scrollTop === 0 && !shouldShowHeader && !showHeader) {
            // if the user is scrolled to the top and we're not showing the header, then
            // just insert the statuses. this is "chat room mode"
            showMoreItemsForTimeline(currentInstance, timeline)
          } else {
            // user hasn't scrolled to the top, show a header instead
            this.store.setForTimeline(currentInstance, timeline, {shouldShowHeader: true})
          }
          stop('handleItemIdsToAdd')
        }
        this.observe('itemIdsToAdd', (newItemIdsToAdd, oldItemIdsToAdd) => {
          if (!newItemIdsToAdd ||
              !newItemIdsToAdd.length ||
              isEqual(newItemIdsToAdd, oldItemIdsToAdd)) {
            return
          }
          scheduleIdleTask(handleItemIdsToAdd)
        })
      },
      setupFocus() {
        this.onPushState = this.onPushState.bind(this)
        this.store.setForCurrentTimeline({
          ignoreBlurEvents: false
        })
        window.addEventListener('pushState', this.onPushState)
      },
      teardownFocus() {
        window.removeEventListener('pushState', this.onPushState)
      },
      onPushState() {
        this.store.setForCurrentTimeline({ ignoreBlurEvents: true })
      },
      saveFocus(e) {
        try {
          let { currentInstance } = this.store.get()
          let { timeline } = this.get()
          let lastFocusedElementSelector
          let activeElement = e.target
          if (activeElement) {
            let focusKey = activeElement.getAttribute('focus-key')
            if (focusKey) {
              lastFocusedElementSelector = `[focus-key=${JSON.stringify(focusKey)}]`
            }
          }
          console.log('saving focus to ', lastFocusedElementSelector)
          this.store.setForTimeline(currentInstance, timeline, {
            lastFocusedElementSelector
          })
        } catch (err) {
          console.error('unable to save focus', err)
        }
      },
      clearFocus() {
        try {
          let { ignoreBlurEvents } = this.store.get()
          if (ignoreBlurEvents) {
            return
          }
          console.log('clearing focus')
          let { currentInstance } = this.store.get()
          let { timeline } = this.get()
          this.store.setForTimeline(currentInstance, timeline, {
            lastFocusedElementSelector: null
          })
        } catch (err) {
          console.error('unable to clear focus', err)
        }
      },
      restoreFocus() {
        let { lastFocusedElementSelector } = this.store.get()
        if (!lastFocusedElementSelector) {
          return
        }
        console.log('restoreFocus', lastFocusedElementSelector)
        requestAnimationFrame(() => {
          requestAnimationFrame(() => {
            let element = document.querySelector(lastFocusedElementSelector)
            if (element) {
              element.focus()
            }
          })
        })
      },
      onNoNeedToScroll() {
        // If the timeline doesn't need to scroll, then we can safely "preinitialize,"
        // i.e. render anything above the fold of the timeline. This avoids the affect
        // where the scrollable content appears to jump around if we need to scroll it.
        console.log('timeline preinitialized')
        this.store.set({timelinePreinitialized: true})
      }
    }
  }
</script>