TrackpadSwipeMixin

Map trackpad events to swipe gestures

Overview

Purpose: maps trackpad events (or horizontal mouse wheel events) to swipe gestures. This allows, for example, users of laptops with trackpads to manipulate a view or selection with a trackpad swipe. (The exact user interface gesture depends on the OS and its configuration. A common OS configuration requires the user to drag on the trackpad with two fingers to perform a swipe.)

This mixin works at the beginning of the Elix render pipeline. In response to touch events, the mixin may call methods on the component or call setState directly.

eventsmethods → setState → render DOM → post-render

Expects the component to provide:

  • setState method compatible with ReactiveMixin's setState.
  • swipeLeft and swipeRight methods. If the component defines these, the mixin will call them if the user makes a full-width drag to the left or right, respectively.

Provides the component with:

  • [internal.state].swipeFraction member expressing how far through a swipe the user is currently is. See below.

Usage

import TrackpadSwipeMixin from "elix/src/base/TrackpadSwipeMixin.js";
class MyElement extends TrackpadSwipeMixin(HTMLElement) {}

See also the related TouchSwipeMixin, which is like TrackpadSwipeMixin, but for touch devices instead of trackpads. Both TouchSwipeMixin and TrackpadSwipeMixin are designed to work with SwipeCommandsMixin to reveal commands behind list items when the user swipes.

Examples

This demo shows how a component can use TouchSwipeMixin and TrackpadSwipeMixin to listen to horizontal touch swipes and trackpad swipes, respectively. Swiping will show the current swipe distance as a fraction of the demo width. It will also translate the gray block by that fraction so the user feels like they are directly moving the block.
Demo: Swiping shows the fraction of the demo's width you have swiped
We would love to host you out here in the Sonoma Valley. The guest house is done on our Sonoma farm and we would love to see you. Dear Members, We're looking for a "top-notch" administrative assistant. Any leads you can give us would certainly be appreciated. I met with Peter Veruki at the Jones School of Administration at Rice last week and we had a great meeting. Our timing is a little off (they want someone next spring and I want a position by Jan), but we are still talking. Thank you for your presentation yesterday. As always, you handled very well some tough questions Well done. I want you to know that I am on board and 100% committed to do my best for the company. We'll get pointed questions related to Europe and broadband. Suggest we answer that we feel confident that the first mover advantage will give us superior returns in the long run. I would be happy to participate in the conference and workshop. Could we arrange a time to discuss the details later this week? Flowers have been ordered and will be delivered to Sharon's office on Tuesday morning. I spent a week on the project and my subcontractor was out his mobilization cost, and after more than a year, they finally paid a part of our cost. Per your request, I have attached a photo of the ornament. Please see attached revised travel advisory. I think it does a better job of balancing the competing interests. Below is an organization chart which displays the changes described here. We are confident this new organization will focus our talent and capital appropriately. Please join me in supporting this management team as it strives to maximize return. Stan will call in. I am emailing in the hopes of having an opportunity to talk if you are interested in the following possibility If there's anything you'd like to talk about, at any point, please do get in touch. Today I am receiving my 15 Years of Service Award and having my Anniversary lunch. Would you like to attend? Don't forget... Our Board of Trustees Meeting has been cancelled. (Please call me if you have questions regarding this matter.) With your permission, Harry and I will plan to bring our golf clubs on the airplane on Tuesday. I plan to buy one of those little traveling golf bags (very small) and carry only about 5 or 6 of my clubs with me. Attached is the second part of the email for the Development Committee. Please note that these documents should be opened in Word. Please call if you should have questions. The NYSE has standard criteria for listing stocks, which can be found on their website at www.nyse.com.
Demo: TrackpadSwipeMixin reveals commands behind these list items on a trackpad swipe

[internal.state].swipeFraction

This mixin calculates a state member [internal.state].swipeFraction to track the state of a trackpad swipe operation. If no swipe is in progress, this value is null. If a swipe is in progress, then swipeFraction holds a real number expressing the distance the user has swiped, divided by the width of the element being swiped (which, by default is the element itself). This value is negative for swipes to the left, and positive for swipes to the right.

Example: If the user touches an element with TrackpadSwipeMixin, and drags to the left one half of the element's width, then swipeFraction will be equal to -0.5.

The related TouchSwipeMixin may also set [internal.state].swipeFraction, adhering to an identical definition.

Full-width drag operations

Trackpad operations may complete while the user is still dragging. If the user drags an item a full element width to the left (swipeFraction is less or equal to -1) or to the right (swipeFraction is greater than or equal to 1), the mixin interprets this as completing a drag. The mixin will invoke the component's swipeLeft or swipeRight method (if defined).

You can use TrackpadSwipeMixin with SwipeDirectionMixin to map these swipeLeft and swipeRight calls to directional navigations. You can additionally map directional navigation operations to selection calls using DirectionCursorMixin. Elix's carousel components like SlidingPages use this chain of mixins to turn flick gestures into changes in the carousel's selection:

  • swipeLeftinternal.goRightselectNext
  • swipeRightinternal.goLeftselectPrevious

Trackpad timeouts

If the user slows or stops their trackpad drag operation, the operation will timeout. If the swipe is over halfway to the left or right, the mixin will invoke swipeLeft or swipeRight respectively. Otherwise, the mixin will cancel the drag and set [internal.state].swipeFraction to null.