sklonenie

Sklonenie.js

Лёгкая и быстрая библиотека для склонения по падежам русских имён, отчеств и фамилий

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

Серверная сторона

Если вы хотите использовать Sklonenie.js как node.js-зависимость, установите пакет при помощи npm:

$ npm install sklonenie

И используйте следующим образом:

const sklonenie = require('sklonenie');
// ...
var bulgakov = sklonenie('Михаил', 'Афанасьевич', 'Булгаков');

console.log(
    `На страницах рукописи ${bulgakov['винительный'].join(' ')}
    «Мастер и Маргарита» ученые обнаружили следы морфия`
 );
/* ->
 На страницах рукописи Михаила Афанасьевича Булгакова
 «Мастер и Маргарита» ученые обнаружили следы морфия
*/

Клиентская сторона

Для использования Sklonenie.js в браузере, вам нужно подключить минифицированный файл на html-странице (js/sklonenie.min.js) и в дальнейшем использовать функцию sklonenie

<script src="sklonenie.min.js"></script>
<script>
    var brodsky = sklonenie.lastname('Бродский');

    console.log(
        `Ходят слухи, что получить Нобелевскую премию
        по литературе ${brodsky['дательный']} помогли связи`
    );
    /* ->
     Ходят слухи, что получить Нобелевскую премию
     по литературе Бродскому помогли связи
    */
</script>

Методы

sklonenie()

Получение массива со склонениями имени, отчества и фамилии.

Синтаксис:

sklonenie(имя, отчество, фамилия[, пол]);
sklonenie(имя, отчество, фамилия[, пол])[склонение];

Последный аргумент — пол — может принимать значение «1» — мужское имя, или «2» — женское. Не обязателен, но может помочь склонять некоторые имена и фамилии.

Пример:

var adel_1 = sklonenie('Адель', 'Захарович', 'Дельвиг');
var adel_2 = sklonenie('Адель', 'Захаровна', 'Дельвиг', 2);

console.log(
    adel_1['родительный'],
    adel_2['родительный']
);
/* ->
 * ['Аделя', 'Захаровича', 'Дельвига']
 * ['Адели', 'Захаровны', 'Дельвиг']
 */

Склонение можно получить по ключу в виде названия или индекса падежа (от 0 до 5).

Пример:

var tolstoy = sklonenie('Лев', 'Николаевич', 'Толстой')

console.log(
    tolstoy['дательный'], // получение по названию
    tolstoy[2]            // получение по индексу (0–5)
);

Также возможно получение части имени из результата

Пример:

var saltikovSchedrin = sklonenie('Михаил', 'Евграфович', 'Салтыков-Щедрин', 1);

console.log(saltikovSchedrin.lastname['винительный']);
 /* ->
 * Салтыкова-Щедрина
 */

sklonenie.firstname()

Получение массива со склонениями имени

Синтаксис:

sklonenie.firstname(имя[, пол]);

Пример:

var pavel = sklonenie.firstname('Павел');

console.log(pavel['именительный']);
 /* ->
 * Павел
 */

sklonenie.middlename()

Получение массива со склонениями отчества

Синтаксис:

sklonenie.middlename(отчество[, пол]);

Пример:

var mihaylovich = sklonenie.middlename('Михайлович');
var mihalych    = sklonenie.middlename('Михалыч');

console.log(mihaylovich['родительный']);
/* ->
 * Михайловича
 */
console.log(mihalych['родительный']);
/* ->
* Михалыча
*/

sklonenie.lastname()

Получение массива со склонениями фамилии

Синтаксис:

sklonenie.lastname(фамилия[, пол]);

Пример:

var lermontov = sklonenie.lastname('Лермонтов');
var gyote     = sklonenie.lastname('Гёте');

console.log(lermontov['дательный']);
/* ->
 * Лермонтову
 */
console.log(gyote['предложный']);
/* ->
* Гёте
*/