Скачать tagger - Скачать исходный код tagger

tagger

Другие ресурсы

0.6.2

Скачать

  _____
 |_   _|___ ___ ___ ___ ___
   | | | .'| . | . | -_|  _|
   |_| |__,|_  |_  |___|_|
           |___|___|   version 0.6.2

Tagger: нулевая зависимость, редактор ванильного javascript

Онлайн демо

Установка

 npm install @jcubic/tagger

или

 yarn add @jcubic/tagger

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

 tagger(document.querySelector('[name="tags"]'), {allow_spaces: false});

Несколько входов могут быть созданы путем передачи узла или массива элементов (например, document.queryselectorall ()). Если в списке содержится только один элемент, то Tagger вернет экземпляр Tagger, массив экземпляров Tagger будет возвращен, если количество элементов больше 1.

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

Tagger можно легко использовать с ReactJS.

 import { useRef , useState , useEffect } from 'react'
import tagger from '@jcubic/tagger'

const App = ( ) => {
    const [ tags , setTags ] = useState ( [ ] ) ;
    const inputRef = useRef ( null ) ;

    useEffect ( ( ) => {
        const taggerOptions = {
            allow_spaces : true ,
        } ;
        tagger ( inputRef . current , taggerOptions ) ;
        onChange ( ) ;
    } , [ inputRef ] ) ;

    const onChange = ( ) => {
        setTags ( tags_array ( inputRef . current . value ) ) ;
    } ;

    return (
        < div className = "app" >
            < input type = "text" ref = { inputRef } onChange = { onChange } defaultValue = "charles, louis, michel" />
            < br />
            < ul >
                { tags . map ( ( tag , index ) => < li key = { ` ${ tag } - ${ index } ` } > { tag } </ li > ) }
            </ ul >
        </ div >
    )
}

function tags_array ( str ) {
    return str . split ( / s*,s* / ) . filter ( Boolean ) ;
}

export default App

Смотрите демо в действии на Codepen.

API

Методы:

add_tag(string): boolean
remove_tag(string): booelan
complete(string): void

Параметры:

wrap (по умолчанию false) Разрешите теги на новую линии вместо переполнения прокрутки
Allow_duplicates (по умолчанию false)
Alling_spaces (по умолчанию true)
add_on_blur (по умолчанию false)
Завершение {list: string[] | function(): Promise(string[])|string[], delay: miliseconds, min_length: number}
Функция ссылки function(name): string|false It должен вернуть то, что должно быть в атрибуте href или false
TAG_LIMIT number (по умолчанию -1) Ограниченное количество тегов, когда установлено на -1 Нет ограничений
string заполнителя (по умолчанию UNSET) Если установлено в параметрах или на начальном вводе, это значение заполнителя будет показано на входе в запись тега
Функция фильтра function(name): string Он должен вернуть имя тега после применения любых фильтров (например, string.touppercase ()), пустая строка для фильтрации тега и предотвращения создания.