Important: This documentation covers Yarn 1 (Classic).
For Yarn 2+ docs and migration guide, see yarnpkg.com.

Package detail

ember-scroll-to-mk2

lolmaus79MIT2.0.0

A link/button component that performs scrolling to given selector.

ember-addon, scroll-to, scroll to, scroll, anchor, scrolling, ember

readme

ember-scroll-to-mk2

Travis npm Ember Observer Score 1.13+

A link/button component that performs scrolling to given selector.

Current implementation uses jQuery for animated scrolling (animation is optional).

See: demo, API docs.

Reimplementation of ember-scroll-to

This project is a reimplementation of ember-scroll-to by @jasonkriss and other contributors.

Differences:

  • ember-scroll-to-mk2 only provides the component, not the service.
  • Scrolls to any selector, not just id.
  • Allows specifying which container to scroll.
  • Optional caching of container and target elements -- disable caching if your app has them disappearing/reappearing.

Installation

ember install ember-scroll-to-mk2

Usage

Inline form:

{{scroll-to
  target = "#foo"
  label  = "Scroll to #foo"
}}

Block form:

{{#scroll-to
  target = "#foo"
}}
  <strong>Scroll to #foo"</strong>
{{/scroll-to}}

Arguments

Argument Type Default value Description
label undefined/String undefined If no block is provided, this is used as link/button label.
target String <required> Selector of the element to scroll to
scrollable String 'html, body' Selector of the element being scrolled. In test env, '#ember-testing-container' is used.
duration undefined/Number undefined Animation duration in milliseconds. When undefined, jQuery's default is used.
easing undefined/String undefined Animation easing name. When undefined, jQuery's default is used.
offset Number 0 Lets you scroll slightly above or below the target.
cacheTarget Boolean true Whether to cache the target element.
cacheScrollable Boolean true Whether to cache the scrollable element.
afterScroll undefined/Action undefined Ember Action to invoke every time scrolling animation completes.
shouldAccountForScrollable Boolean false if scrollable is not default Whether to account for scollable's offset and scolllTop when calculating scolllTop.

License

This software is free to use under the MIT license. See the LICENSE file for license text and copyright information.

Includes fragments of code borrowed from jasonkriss/ember-scroll-to.

changelog

Change Log

All notable changes to this project will be documented in this file. This project adheres to Semantic Versioning.

Unreleased

2.0.0 (2017-12-17)

New

  • shouldAccountForScrollable lets you control how scroll position is calculated, useful in complex layouts. :warning: Potentially breaking change.

Code maintenance

  • Upgrade Ember CLI and dependencies.
  • Update tests.

Demo

  • More complicated demo to test for various cases.

1.1.0

Fixed

  • href attr is now filled correctly for FastBoot compatibility.

Tests

  • Updated right column scrollers not to use caching.

1.0.2

Docs

  • Deploy to gh-pages.

1.0.1 (unpublished)

Fixed

  • Make tests pass. ^_^

1.0.0 (unpublished)

Initial release