virtual-each

0.6.3 • Public • Published

virtual-each

Ember Observer Score Ember badge NPM Version Build Status Dependency Status devDependency Status

A direct port of react-infinite-list to Ember. This was created as a benchmark exercise.

This component will only ever render DOM nodes for what can fill the view port. Using the power of Glimmer, it will reuse the DOM nodes it's already created and swap out the content as the user scrolls.

If you want a more flexible virtualization component, please try ember-collection.

Install

ember install virtual-each

Usage

{{#virtual-each items
  height=200
  itemHeight=36
  onScrollBottomed=(action 'handlePageBottom')
  positionIndex=0
  as |item actualIndex virtualIndex|
}}
  <div class="person-row">
    <img src={{item.picture}} />
    <div>
      <div>{{actualIndex}}. {{item.name.last}}, {{item.name.first}}</div>
      <div class="company">{{item.company}}</div>
    </div>
  </div>
{{else}}
  <strong>No results</strong>
{{/virtual-each}}

Attributes

  • height: fixed height of the component (required)
  • itemHeight: fixed row height (required)
  • onScrollBottomed: invoked when scrolled to the bottom of the list (optional)
  • positionIndex: start at or scroll to a specific item based on the item index (optional)

CSS

Add the following CSS snippet to styles/app.css:

.virtual-each {
  overflow-y: auto;
}
 
.infinite-list-content {
  list-style: none;
  margin: 0;
  padding: 0;
}

Known "Gotchas"

  • Not defining an itemHeight, or defining a less-than expected height, will result in unexpected jumping behavior during scrolling. itemHeight should be set to exact height of a row.

Demo

Requirements

  • Ember >= 2.12.0

Contributing

Install

  • git clone this repository
  • npm install
  • bower install
  • ember server
  • Visit your app at http://localhost:4200.

Running Tests

  • ember test
  • ember test --server

Readme

Keywords

Package Sidebar

Install

npm i virtual-each

Weekly Downloads

227

Version

0.6.3

License

MIT

Unpacked Size

1.66 MB

Total Files

13

Last publish

Collaborators

  • flexyford
  • jasonmit
  • robdel12