Add Comments to Your Vue 3 App
Это официальная библиотека Vue 3 для FastComments.
Встраивайте виджеты живых комментариев, чата и отзывов в ваше Vue-приложение.
Репозиторий
Онлайн-демо 
Попробуйте каждый виджет вживую на https://fastcomments.com/commenting-system-for-vue.
Онлайн-презентация
Чтобы увидеть все виджеты и потоки, работающие локально с публичным тенантом demo, клонируйте репозиторий и выполните:
npm install
npm run devТочка входа демонстрации находится в src/App.vue и index.html — каждый виджет/поток рендерится в том же приложении, которое вы можете скопировать в свой собственный проект на Vue 3.
Установка
NPM
npm install --save fastcomments-vue-nextYarn
yarn add fastcomments-vue-nextИспользование
Виджет комментариев
Компонент FastCommentsVueNext содержит живой виджет комментариев FastComments.
Замените "demo" ниже на ваш "tenantId" — доступен here в административной панели FastComments.
Виджет поддерживает множество опций — смотрите FastCommentsConfig here.
<template>
<FastComments v-bind:config="{tenantId: 'demo'}" />
</template>
<script>
import { FastComments } from 'fastcomments-vue-next'
export default {
name: 'FastCommentsExample',
components: {
FastComments
}
}
</script>Обновление текущей страницы (пример SPA)
В FastComments идентификатор статьи или страницы, к которой привязаны комментарии, мы называем URL ID, так как это может быть URL или ID. Определите URL ID следующим образом. Компонент отслеживает изменения в объекте config и будет перезагружаться, поэтому вы можете обновлять URL ID.
<FastComments v-bind:config="{tenantId: 'demo', url: 'https://example.com/somepage', urlId: 'some-page-id'}" />Регион аккаунта (ВНИМАНИЕ: клиенты из ЕС)
Если ваш аккаунт находится в ЕС, установите region = 'eu' в конфигурации виджета, например:
<FastComments v-bind:config="{tenantId: 'demo', url: 'https://example.com/somepage', urlId: 'some-page-id', region: 'eu'}" />В противном случае вам не нужно задавать region.
В продакшене
Вам, вероятно, не стоит определять config inline, если вы передаёте обратные вызовы и т. п.
Вместо этого стоит определить config через computed(), иначе каждый раз при вызове вашего обратного вызова и т. п. весь виджет будет перерисовываться.
Все виджеты и документация
Запустите локальную документацию:
npm run serveСтатус обслуживания
Эти компоненты являются обёртками вокруг наших основных компонентов VanillaJS. Мы можем автоматически обновлять эти компоненты (исправлять ошибки, добавлять функции) без публикации этой библиотеки, поэтому даже если она может некоторое время не публиковаться, это не означает, что FastComments не находится в активной разработке! Не стесняйтесь проверять наш блог на предмет обновлений. Критические изменения API или новые возможности никогда не будут добавлены в лежащую в основе core-библиотеку без повышения версии в этой библиотеке.
FastComments
FastComments
Эта документация содержит несколько примеров того, как использовать FastComments с Vue3.
Для полного списка параметров конфигурации смотрите fastcomments-typescript и нашу документацию.
Нужна помощь?
Если вы столкнётесь с какими-либо проблемами или у вас есть вопросы по библиотеке Vue 3, пожалуйста:
Внесение вклада
Вклады приветствуются! Пожалуйста, посетите репозиторий GitHub для ознакомления с правилами внесения вклада.