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" — доступний тут у панелі адміністратора FastComments.
Віджет підтримує багато параметрів — див. FastCommentsConfig тут.
<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 безпосередньо, якщо ви передаєте зворотні виклики тощо. Натомість вам слід визначати
config через computed(), інакше щоразу, коли викликається ваш зворотний виклик тощо, весь віджет буде повторно відрендерено.
Усі віджети та документація
Запустіть локальну документацію:
npm run serveСтатус обслуговування
Ці компоненти є оболонками навколо наших базових компонентів VanillaJS. Ми можемо автоматично оновлювати ці компоненти (виправляти помилки, додавати можливості) без публікації цієї бібліотеки, тож хоча вона може деякий час не бути опублікованою, це не означає, що FastComments не перебуває в активній розробці! Перегляньте наш блог для оновлень. Зміни, що ламають API, або нові функції ніколи не будуть передані в основну бібліотеку без підвищення версії цієї бібліотеки.
FastComments
FastComments
Ця документація містить кілька прикладів того, як використовувати FastComments з Vue3.
Для повного списку параметрів конфігурації див. fastcomments-typescript та нашу документацію.
Потрібна допомога?
Якщо ви зіткнулися з будь-якими проблемами або маєте питання щодо бібліотеки Vue 3, будь ласка:
Участь у проєкті
Внески вітаються! Будь ласка, відвідайте репозиторій GitHub для ознайомлення з правилами внеску.