isotope README

The project's README from github.com/metafizzy/isotope. As one markdown file: README.md.

Isotope

Filter & sort magical layouts

See isotope.metafizzy.co for complete docs and demos.

Install

Download

CDN

Link directly to Isotope files on unpkg.

<script src="https://unpkg.com/isotope-layout@3/dist/isotope.pkgd.min.js"></script>
<!-- or -->
<script src="https://unpkg.com/isotope-layout@3/dist/isotope.pkgd.js"></script>

Package managers

npm: npm install isotope-layout --save

Bower: bower install isotope-layout --save

License

Commercial license

If you want to use Isotope to develop commercial sites, themes, projects, and applications, the Commercial license is the appropriate license. With this option, your source code is kept proprietary. Purchase an Isotope Commercial License at isotope.metafizzy.co

Open source license

If you are creating an open source application under a license compatible with the GNU GPL license v3, you may use Isotope under the terms of the GPLv3.

Read more about Isotope's license.

Initialize

With jQuery

$('.grid').isotope({
  // options...
  itemSelector: '.grid-item',
  masonry: {
    columnWidth: 200
  }
});

With vanilla JavaScript

// vanilla JS
var grid = document.querySelector('.grid');
var iso = new Isotope( grid, {
  // options...
  itemSelector: '.grid-item',
  masonry: {
    columnWidth: 200
  }
});

With HTML

Add a data-isotope attribute to your element. Options can be set in JSON in the value.

<div class="grid"
  data-isotope='{ "itemSelector": ".grid-item", "masonry": { "columnWidth": 200 } }'>
  <div class="grid-item"></div>
  <div class="grid-item"></div>
  ...
</div>

By Metafizzy 🌈🐻, 2010–2020

isotope (metafizzy/isotope)

Searching Database…

11.1K ·GitHub
Isotope
Что это такое?Isotope — это JavaScript-библиотека для «волшебных раскладок»: она фильтрует и сортирует элементы на веб-странице и анимированно перемещает их на новые места.
Это плагин для jQuery или отдельная штука?Это фронтенд-библиотека на JavaScript, а не отдельное приложение: вы подключаете скрипт isotope.pkgd.js на свою страницу и применяете его к тем элементам, которые хотите фильтровать и сортировать.
Как добавить её в проект?Выполните npm install isotope-layout (подойдёт и Bower), подключите файл с CDN unpkg или скачайте isotope.pkgd.js и добавьте его на свою страницу. Полная документация и примеры — на isotope.metafizzy.co.
Для него нужен jQuery?Нет. jQuery — лишь один из трёх вариантов: Isotope можно инициализировать на чистом JavaScript или вообще прямо в HTML, добавив атрибут data-isotope с настройками в виде JSON. Так что jQuery совершенно необязателен.
Можно бесплатно использовать его в коммерческом проекте?Не автоматически. Для коммерческих сайтов, тем и приложений нужно купить коммерческую лицензию Isotope (Isotope Commercial License); бесплатный вариант распространяется только на open source-проекты под лицензией, совместимой с GPLv3.
Он привязан к сеткам в стиле masonry?Пакет masonry-layout идёт в комплекте как зависимость, так что укладка элементов в стиле masonry встроена с самого начала; сам README описывает основную задачу библиотеки как фильтрацию и сортировку элементов раскладки.
Есть ли сжатая сборка для продакшена?Да: вместе с несжатым файлом isotope.pkgd.js поставляется и минифицированный isotope.pkgd.min.js, причём оба также доступны на CDN unpkg.
What are similar projects?masonry, muuri, velocity, chosen, jquery, scrollreveal, toastr, material
Which topics is it in?grid, layout, jquery, javascript-library, animation, browser, html, ui, gplv3, web-development, npm, frontend
Creator
metafizzy
Size
1.7 MB
Stars
11.1K
Updated
CommitApr 14Releasev3.0.5Apr 06
Age
15y
Commits · 90 Days