FastComments.com

Add Comments to Your Next.js App

這是 FastComments 的官方 Next.js 函式庫。

在你的 Next.js 應用程式中嵌入即時評論、聊天和評價小工具。

儲存庫

在 GitHub 上查看


線上示範 Internal Link

要在本機端查看針對公開的 demo 租戶執行的每個元件與流程,請複製此儲存庫並執行:

cd example
npm install
npm run dev

每個元件在 example/app/ 底下都有自己的路由,你可以直接將它們複製到你自己的 Next.js 應用程式中。

安裝 Internal Link

npm install fastcomments-nextjs

快速開始 Internal Link

// app/page.tsx
import { FastComments } from 'fastcomments-nextjs';

export default function Page() {
    return <FastComments tenantId="demo" />;
}

"demo" 替換為您的 FastComments 租戶 ID。該元件已經宣告 'use client',因此您可以從伺服器元件中呈現它。

元件 Internal Link

元件 說明
FastComments 具備回覆、投票等功能的留言元件
FastCommentsCommentCount 顯示頁面留言數量
FastCommentsImageChat 圖片註解留言
FastCommentsLiveChat 即時聊天元件
FastCommentsCollabChat 協作式內嵌留言
FastCommentsReviewsSummary 星級評分評論摘要
FastCommentsUserActivityFeed 使用者活動動態

所有元件皆從套件根目錄匯出:

import {
    FastComments,
    FastCommentsLiveChat,
    FastCommentsReviewsSummary,
} from 'fastcomments-nextjs';

Vercel 部署 Internal Link

如果您已透過 Vercel Marketplace 的整合安裝 FastComments,您的租戶 ID 可作為 FASTCOMMENTS_TENANT_ID 環境變數取得。要在客戶端讀取它,請透過 next.config.js 將它暴露出來,或在變數名前加上 NEXT_PUBLIC_

<FastComments tenantId={process.env.NEXT_PUBLIC_FASTCOMMENTS_TENANT_ID!} />

範例專案 Internal Link

example/ 目錄中附帶一個可運作的示範:

cd example && npm install && npm run dev


維護狀態 Internal Link


這些元件是我們核心 VanillaJS 元件的包裝器。我們可以自動更新這些元件(修復錯誤、加入功能)而無需發布此函式庫,因此雖然它可能暫時不會發佈,但並不代表 FastComments 沒有在積極開發中!歡迎查看 我們的部落格 以取得更新。破壞性 API 變更或新功能,絕不會在未對此函式庫進行版本提升的情況下發佈到底層核心函式庫。

需要幫忙?

如果您在使用 Next.js 函式庫 時遇到任何問題或有疑問,請:

貢獻

歡迎貢獻!請造訪 GitHub 儲存庫 以取得貢獻指南。