IBM/motion

Name: motion

Owner: International Business Machines

Description: Reusable functions for IBM's motion standards.

Created: 2017-10-02 14:24:10.0

Updated: 2018-05-13 01:53:07.0

Pushed: 2018-05-13 01:53:05.0

Homepage: null

Size: 18101

Language: JavaScript

GitHub Committers

UserMost Recent Commit# Commits

Other Committers

UserEmailMost Recent Commit# Commits

README

IBM motion

This package includes various tools to help with applying motion to user interfaces.

Introduction

Designing and applying consistent motion for a system of components, pages or interfaces, and / or across multiple platforms can be challenging. What makes things even more challenging is the fact that most of these experiences are also dynamic and responsive.

Motion in interface design is defined by many things such as the property that is being animated, path, choreography - this package primarily addresses two very fundamental elements that directly impacts the quality of a motion - the acceleration curve (AKA easing, timing), and the duration of the motion.

Core concepts
Motion modes

This package recognizes that there is a need for multiple types of motion for different moments. Currently it supports two type of motions for different moments - the productive motion that is efficient and quick, ideal for micro interactions, and the expressive motion for more conversational experience. Much attention has been given to maintaining consistency between these two modes - even though they use different acceleration curves and different duration, they feel the same.

Dynamic duration

The duration should change depending on the distance (or the amount of scaling or fading). The duration also should be influenced by the size of the element - a larger element should slow down a bit. This package supports both. Furthermore, this package uses a non-linear algorithm when calculating the duration that makes an element move slightly faster when the distance is larger to maintain perceived consistency.


Warning: IBM Motion is in development and things may change. Look out for a stable release later this year (2018).

Installation and build
m install @ibm/motion
Demo site

This package includes a simple demo site.

m install
lp
m start
Guidelines

Note: detailed motion guide will be published with the aforementioned stable release.

Transition timing function classes (easing)

This package provides classes that sets the transition-timing-function and transition-duration rules on your element.

Motion generator

A tool to make it easy to use IBM Motion is available at: https://ibm.github.io/motion/

|—|—|—|

JavaScript Components of this package
getDuration() method

Calculate recommended duration based on various factors including distance, size.

rt getDuration from '@ibm/motion/getDuration.js';
ole.log(getDuration(
200, // distance of motion in pixels
20, // size (area) of the element being animated. set to 20 for the standard size
'move', // property. 'move', 'scale', 'fade'
'mechanical', // motion mode. 'natural', 'mechanical'
'easeInOut', // easing. 'easeInOut', 'easeIn', 'easeOut'
'rem', // unit. supports 'rem' and 'px'. default is 'rem'
16 // unit size in pixel. default is 16.


eturns a float value, duration in ms.
getCurve() method

Calculate recommended bezier curve based on various factors including distance, size.

rt getCurve from '@ibm/motion/getCurve.js';
ole.log(getCurve(
200, // distance of motion in pixels
20, // size (area) of the element being animated. set to 20 for the standard size
'move', // property. 'move', 'scale', 'fade'
'mechanical', // motion mode. 'natural', 'mechanical'
'easeInOut', // easing. 'easeInOut', 'easeIn', 'easeOut'
'rem', // unit. supports 'rem' and 'px'. default is 'rem'
16 // unit size in pixel. default is 16.


eturns a string value - the cubic-bezier curve definition for the CSS `transition-timing-function` rule.
Motion Classes

This package includes classes for easier implementation of IBM motions.

Transition timing function classes (easing)

These classes follow this pattern:

ibm-motion-[motion mode:expr|prod]-[property:move|scale|rotate|fade]-[ease-in-out|ease-in|ease-out]

Examples:

ibm-motion-expr-move-ease-in-out

Transition duration classes

These classes allow you to simply use classes to approximate the dynamic duration instead of using the JavaScript function to calculate on the fly.

The classes for move use distance of the travel and follow this pattern:

ibm-motion-[motion mode:expr|prod]-[property:move|scale|fade|rotate]-dur-[distance steps:10|25|50|75|100|200|400|800|1600|3200]

The classes for fade use amount of opacity change and follow this pattern:

ibm-motion-[motion mode:expr|prod]-[property:move|scale|fade|rotate]-dur-[distance steps:25|50|75|100]

The classes for rotate use amount of angle change and follow this pattern:

ibm-motion-[motion mode:expr|prod]-[property:move|scale|fade|rotate]-dur-[distance steps:30|60|90|120|150|180|270|360]

The classes for scale uses the size change as the differentiator and follows this pattern:

ibm-motion-[motion mode:expr|prod]-[property:move|scale|fade|rotate]-dur-[width*height steps:64|256|1024|4096|16384|65536|262144|1048576|4194304|16777216]


This work is supported by the National Institutes of Health's National Center for Advancing Translational Sciences, Grant Number U24TR002306. This work is solely the responsibility of the creators and does not necessarily represent the official views of the National Institutes of Health.