Легковесный (~4 kb min gzip), типизированный и настраиваемый React компонент для подсказок адресов, организаций, банков и ФИО с помощью сервиса DaData.ru

Демонстрация

Предоставлена документация для 2.x, версия 1.x не поддерживается

pnpm add react-dadata

yarn add react-dadata

npm install react-dadata

import { AddressSuggestions } from 'react-dadata';
import 'react-dadata/dist/react-dadata.css';

const [value, setValue] = useState();

<AddressSuggestions token="API_KEY" value={value} onChange={setValue} />;

Поскольку компонент классовый, он поддерживает вызов методов с помощью ref.

import React, { useRef } from 'react';
import { AddressSuggestions } from 'react-dadata';
import 'react-dadata/dist/react-dadata.css';

//...

const suggestionsRef = useRef<AddressSuggestions>(null);
const handleClick = () => {
  if (suggestionsRef.current) {
    suggestionsRef.current.setInputValue('Тут пример запроса');
  }
};

//...

<AddressSuggestions ref={suggestionsRef} token="API_KEY" />
<button onClick={handleClick}>Изменить поле ввода</button>

Вызывает событие focus на поле ввода

Устанавливает указанный текст в поле ввода

import { AddressSuggestions } from 'react-dadata';
import 'react-dadata/dist/react-dadata.css';

const [value, setValue] = useState();

<AddressSuggestions token="API_KEY" value={value} onChange={setValue} />;

import { PartySuggestions } from 'react-dadata';
import 'react-dadata/dist/react-dadata.css';

const [value, setValue] = useState();

<PartySuggestions token="API_KEY" value={value} onChange={setValue} />;

import { BankSuggestions } from 'react-dadata';
import 'react-dadata/dist/react-dadata.css';

const [value, setValue] = useState();

<BankSuggestions token="API_KEY" value={value} onChange={setValue} />;

import { FioSuggestions } from 'react-dadata';
import 'react-dadata/dist/react-dadata.css';

const [value, setValue] = useState();

<FioSuggestions token="API_KEY" value={value} onChange={setValue} />;

react-dadata поставляется с опциональным CSS файлом, который из коробки неплохо выглядит и выполняет свои функции. Чтобы использовать его, укажите этот CSS файл в импорте или создайте CSS файл у себя с нужными стилями.

import { AddressSuggestions } from 'react-dadata';

// Импортируем CSS файл
import 'react-dadata/dist/react-dadata.css';

// ...
<AddressSuggestions token="API_KEY" value={value} onChange={setValue} />;

Обратите внимание, что ваш сборщик должен быть настроен соответствующим образом для обработки CSS файлов.

Если у вас в проекте используется CSS-in-JS решение, то вы должны передавать CSS классы в компонент с помощью пропсов:

• inputProps.className - для поля ввода
• containerClassName - для контейнера компонента
• suggestionsClassName - для блока с подсказками
• suggestionClassName - для блока с подсказкой
• currentSuggestionClassName - для блока с текущей выделенной подсказкой
• hintClassName - для блока с пояснением
• highlightClassName - для тега mark, которым выделяются совпадения с введенным текстом

react-dadata написан на TypeScript, поэтому типы встроены.

import React, { useState } from 'react';
import { AddressSuggestions, DaDataSuggestion, DaDataAddress } from 'react-dadata';
import 'react-dadata/dist/react-dadata.css';

const [value, setValue] = useState<DaDataSuggestion<DaDataAddress> | undefined>();

// Также можно воспользоваться готовым типом DaDataAddressSuggestion для адреса или DaDataPartySuggestion для организаций
// import { DaDataAddressSuggestion } from 'react-dadata';
// const [value, setValue] = useState<DaDataAddressSuggestion | undefined>();

<AddressSuggestions token="API_KEY" value={value} onChange={setValue} />;

Данная ошибка возникает при использовании серверного рендеринга. Под капотом, react-dadata, следуя принципам доступности, создает компонент с aria ролью "combobox", которому необходимо через обычные HTML идентификаторы связывать различные элементы. При использовании SSR в виду текущей архитектуры компонента данные ID генерируются дважды независимо: на сервере и на клиенте, из-за чего в момент регидратации React выявляет несовпадение этих идентификаторов. Эта проблема решается довольно просто в функциональных компонентах, однако на данный момент у меня нет быстрого решения этой проблемы.

Чтобы иметь возможность избавиться от данной ошибки при использовании SSR можно передавать пропс uid, в которой вы можете передать уникальный в рамках страницы строковый идентификатор.

Если заранее известно, сколько компонентов и в каких местах страницы будут располагаться, можно передавать в качестве идентификаторов понятные строки:

<AddressSuggestions
  token="API_KEY"
  value={value}
  onChange={setValue}
  uid="dadata-address-order-page"
/>;

Если вы уже обновились на React 18, то можно воспользоваться стандартным хуком useId:

const id = useId();

return (
  <AddressSuggestions
    token="API_KEY"
    value={value}
    onChange={setValue}
    uid={id}
  />
);

The MIT License

Copyright (c) 2016 Vitaly Baev <[email protected]>, baev.dev

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in
all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
THE SOFTWARE.

• В ближайшее время добавить подсказки для ФИО.
• Увеличить покрытие тестов
• Сайт с документацией
• Если вам чего-то не хватает в текущем функционале - создавайте issue, попробуем помочь!