ember-links-with-follower
ember-links-with-follower
npm i ember-links-with-follower
ember-links-with-follower

ember-links-with-follower

Render a set of links with a "follower" line underneath. The follower moves to the active link, matching size and position on the page.

by echobind

0.6.0 (see all)License:MITTypeScript:Not Found
npm i ember-links-with-follower
Readme

ember-links-with-follower

CircleCI npm version Code Climate Dependency Status Ember Observer Score

Features

Provides a component that renders a set of links with a follower line underneath. The follower will animate to the position of the active link, and grow or shrink in size if needed. If no active links are found, the follower will hide.

This pattern is commonly used for navigation:

twitter

(from Twitter app)

linkedin

(from LinkedIn app)

Animation of the follower is done through CSS transition and transform using translate3d. The transitions duration will be set to 0 on window resize to avoid issues with animating while resizing.

Since Links with Follower hooks in to the Router's willTransition event, you can use link-to or transitionTo and the follower will still update properly.

Installation

ember install ember-links-with-follower

Usage

Render links with default behavior (links passed in the block are expected to be li's):

{{#links-with-follower class="my-nav"}}
  {{#link-to 'Home' tagName='li'}}Home{{/link-to}}
  {{#link-to 'Stuff' tagName='li'}}Stuff{{/link-to}}
{{/links-with-follower}}

Render custom tags, change the active selector, and animate slowly:

{{#links-with-follower
  containerTagName="section"
  linkTagName="div"
  activeSelector="selected"
  followerAnimationDuration=1000}}

  {{#link-to "Home" tagName="div"}}Home{{/link-to}}
  {{#link-to "Stuff" tagName="div"}}Stuff{{/link-to}}

{{/links-with-follower}}

Customize the follower with css:

.my-nav .link-follower {
  border-color: tomato;
  border-size: 3px;
}

How does this work?

A listener is added to the router's willTransition event. On willTransition, we look for an active link in the links provided to the component via block format.

An active link is defined by the activeSelector property, which defaults to 'li.active:not(li.ember-transitioning-out), li.ember-transitioning-in'. This allows us to eagerly transition the follower before the route has fully transitioned.

Echobind LLC (c) 2016 @echobind Licensed under the MIT license

Downloads/wk

7

GitHub Stars

43

LAST COMMIT

5yrs ago

MAINTAINERS

2

CONTRIBUTORS

6

OPEN ISSUES

10

OPEN PRs

14
VersionTagPublished
0.6.0
latest
6yrs ago
No alternatives found
No tutorials found
Add a tutorial
No dependencies found

Rate & Review

100
No reviews found
Be the first to rate