decliner.js

Мини-библиотека (634 байта) для склонения исчисляемых русских слов

Установка

Несколько вариантов установки библиотеки:

• Склонировать репозиторий: git clone https://github.com/nmihalyov/decliner.git
• Скачать .zip архив (зелёная кнопка "Clone or download" на главной странице библиотеки)
• Загрузка с помощью пакетных менеджеров:
  • NPM: npm i decliner --save-dev
  • Bower: bower i decliner -D
  • Yarn: yarn add decliner -D

Далее просто включите библиотеку в ваш проект:

<script src="%path%/decliner/dist/decliner.js"></script>

или её минифицированную версию

<script src="%path%/decliner/dist/decliner.min.js"></script>

(где %path% - путь от корня проекта до папки в которую устанавливается пакет (или распаковывается архив))

Использование

Для начала работы необходимо создать массив из трёх строк (вариантов склонения) в строгом порядке: 1 %предмет%, 2 %предмета%, 5 %предметов%

Например

let rubles = ['рубль', 'рубля', 'рублей'];

Используя этот массив можно вызвать метод decline() в аргумент, которой передать необходимое число:

rubles.decline(105); // "рублей"

Этот метод также имеет второй параметр (по-умолчанию false). Если в него передать true, то число, передаваемое в кач-ве первого аргумента будет подставлено в строку через пробел:

rubles.decline(105, true); // "105 рублей"

Упрощённая форма для многократного обращения:

let rublesDecline = n => {
  return rubles.decline(n, true);
}

rublesDecline(123); // "123 рубля"

Дополнительная информация

decliner.js умеет работать и с отрицательными значениями:

rublesDecline(-50); // "-50 рублей"

И с вещественными числами:

rublesDecline(-0.4); // "-0.4 рубля"

В случае какой-либо ошибки при работе с библиотекой, эта ошибка выведется в консоль с описанием

Благодарность можно выразить поставив этому репозиторию звезду, а также зайдя в другие репозитории моего аккаунта

Контакты для связи:
Почта - [email protected]
Telegram - https://telegram.me/nmihalyov