
Язык 🇷🇺 Русский
Документация
Начало работы
Использование
Добавьте комментарии в ваше приложение React
Это официальная библиотека React для FastComments.
Встраивайте виджеты живых комментариев, чата и обзоров в ваше приложение на React.
Репозиторий
Живая демонстрация 
Попробуйте каждый виджет вживую на https://fastcomments.com/commenting-system-for-react.
Демонстрация в реальном времени 
Чтобы увидеть каждый виджет и поток, работающие локально против публичного арендатора demo, клонируйте репозиторий и запустите:
cd examples/example-showcase
npm install
npm run dev
Каждый виджет/поток имеет собственный представление в examples/example-showcase/src/views/, которое вы можете скопировать напрямую в своё React‑приложение.
Примеры 
Отдельные примеры использования (темный режим, пагинация и т.д.) находятся в своих собственных папках внутри examples/. Каждый можно настроить с помощью npm install и запустить с помощью npm run dev (Vite).
Использование 
Основной компонент виджета
Компонент FastCommentsCommentWidget содержит виджет комментариев FastComments в режиме реального времени.
Замените "demo" ниже на ваш "tenantId" — он доступен здесь в панели администратора FastComments.
Виджет поддерживает множество опций - см. FastCommentsCommentWidgetConfig в src/index.tsx.
import React, { Component } from 'react'
import {FastCommentsCommentWidget} from 'fastcomments-react'
class Example extends Component {
render() {
return <FastCommentsCommentWidget tenantId="demo" />
}
}
Обновление текущей страницы (для SPA)
Чтобы обновить страницу/статью, к которой привязан поток комментариев, вы должны обновить параметры конфигурации "urlId" и "url". См. пример и объяснение здесь.
Регион аккаунта (ВНИМАНИЕ: клиенты из ЕС)
Если вы находитесь в ЕС, вам следует указать клиентским виджетам, в каком вы регионе. Смотрите examples/example-eu;
В противном случае определять region не обязательно.
Виджет количества комментариев
Компонент FastCommentsCommentCountWidget содержит виджет количества комментариев FastComments в режиме реального времени.
Замените "demo" ниже на ваш "tenantId" — он доступен здесь в панели администратора FastComments.
См. FastCommentsCommentCountConfig в src/index.tsx для поддерживаемых параметров конфигурации.
import React, { Component } from 'react'
import {FastCommentsCommentCountWidget} from 'fastcomments-react'
class Example extends Component {
render() {
return <FastCommentsCommentCountWidget tenantId="demo" urlId="https://example.com/some-page-or-id" />
}
}
Нативная реализация
Для полностью нативной реализации FastComments см. fastcomments-react-native-sdk.
Для обёртки этой библиотеки для React Native, использующей webview, см. fastcomments-react-native.
Статус поддержки 
Эти компоненты являются оболочками поверх наших основных компонентов VanillaJS. Мы можем автоматически обновлять эти компоненты (исправлять ошибки, добавлять функции) без публикации этой библиотеки, так что хотя она может некоторое время не публиковаться, это не означает, что FastComments не находится в активной разработке! Не стесняйтесь заглядывать в наш блог за обновлениями. Несовместимые изменения API или новые функции никогда не будут добавлены в базовую библиотеку без повышения версии этой библиотеки.
Нужна помощь?
Если вы столкнулись с какими-либо проблемами или у вас есть вопросы о React Library, пожалуйста:
Как внести вклад
Вклады приветствуются! Пожалуйста, посетите репозиторий на GitHub для получения инструкций по внесению вклада.