
语言 🇨🇳 简体中文
入门指南
小部件样式
其他前端库
自定义样式指南
本指南提供 FastComments 评论小部件 (v2) 使用的完整默认 CSS 以及一些说明 用于覆盖这些样式。
了解默认 CSS 可让您:
- 自定义外观,通过覆盖特定样式
- 排查样式问题,查看有哪些类和选择器可用
- 构建自定义主题,使其适配小部件的结构
- 与 AI 助手配合使用,生成自定义 CSS 修改。
如何覆盖样式
覆盖样式的方法取决于小部件。对于评论小部件,您必须使用 customCSS 配置参数将 CSS 传入 iframe,或者在管理面板的自定义页面中指定 CSS,该页面会从我们的 CDN 提供该 CSS。
如何自定义样式 
如何自定义评论小部件样式
您可以通过两种方式自定义评论小部件的样式:
选项 1:通过 customCSS 参数
在初始化小部件时,将自定义 CSS 作为字符串传递给 customCSS 参数:
window.fcConfigs = [{
target: '#fastcomments-widget',
tenantId: 'your-tenant-id',
customCSS: `
.fast-comments .comment {
background-color: #f0f0f0 !important;
border-radius: 8px !important;
}
`
}];
选项 2:通过管理仪表板
- 在管理仪表板中转到 小部件自定义页面
- 向下滚动到 "Advanced" 下的 "Custom CSS" 部分
- 输入您的自定义 CSS
- 点击 "Save"
您的自定义 CSS 将应用到您网站上的所有评论小部件。
提示
- 如有需要,使用
!important覆盖默认样式 - 针对特定选择器,以免影响站点的其他部分
- 在不同浏览器中测试您的 CSS 以确保兼容性
- 该小部件使用标准 CSS —— 不需要特殊的预处理器
自定义评论框边框 
评论框周围的边框由文本区域自身的边框加上小组件在其周围绘制的几条细线组成。要更改其颜色或圆角,请设置这些 CSS 变量,而不是直接对 textarea 进行样式设置。这些变量会同时重新设置边框的每个部分,因此圆角和颜色始终保持一致。
| 变量 | 作用 | 默认值 |
|---|---|---|
--fc-input-border-color | 边框颜色 | #bfbfbf |
--fc-input-border-color-focus | 用户输入时的边框颜色 | #555 |
--fc-input-border-radius | 圆角的圆度 | 11px |
--fc-input-border-start-start-radius | 方形左上角的圆度(在从右到左的语言中为右上角) | 0 |
将 CSS 添加到小组件自定义页面上的 Custom CSS 框中,或通过 customCSS 选项传入。您只需设置想要更改的变量。
您还可以使用 Custom CSS 框正下方的 Comment box border 辅助工具,它会为您自动生成这些 CSS。
更改边框颜色

输入时更改边框颜色

将四个角全部设为圆角
默认情况下左上角是方形的。将两个圆角变量都设置相同的值即可将四个角全部设为圆角:

方形边角

匹配您的品牌

深色模式下的不同颜色
当小组件处于深色模式时,它会带有 dark 类,因此您可以为深色模式设置不同的值:

为什么不直接对文本区域进行样式设置?
小组件会在文本区域周围自行绘制评论框边框的一部分。如果您只在 textarea 上设置 border-color 或 border-radius,这些线条将保持默认样式,边框看起来会不协调,例如一条方形线条穿过圆角。上述变量会同时更改两者。
评论小部件自定义 CSS 参考(第2版,最新) 

最近评论小部件样式 
最新评论组件(Recent Comments Widget)会在您的整个网站或特定页面上显示最近评论的列表。它包含标题、圆形头像、评论预览、可深度链接到评论的可点击日期,以及自动深色模式检测。
基本安装
Run 
配置选项
- tenantId(必填):您的 FastComments 租户 ID
- urlId(可选):筛选到单个页面。留空 null 则显示所有页面
- count(可选):显示的评论数量。默认为
10 - hasDarkBackground(可选):强制使用深色模式样式。未设置时会根据页面背景自动检测
组件结构
该组件渲染为以下 HTML 结构:

默认 CSS 参考

自定义示例
更改头像大小

显示更多行评论文本

移除容器边框

讨论最多页面小部件样式 
“最多讨论页面”小部件显示一个按评论数排名的页面列表。它包含标题、排名序号、带图标的评论数、最近活动日期,以及自动深色模式检测。
基本安装
Run 
配置选项
- tenantId(必填):您的 FastComments 租户 ID
- hasDarkBackground(可选):强制使用深色模式样式。如未设置,将根据页面背景自动检测
小部件结构
该小部件渲染为以下 HTML 结构:

默认 CSS 参考

自定义示例
移除排名徽章

移除容器边框

最近讨论小部件样式 
最近讨论小组件按最近的评论活动排序显示页面列表。它包含标题、最后活动日期、带图标的评论数,以及自动深色模式检测。
基本安装
Run 
配置选项
- tenantId(必填):您的 FastComments 租户 ID
- count(可选):显示的页面数量。默认为
20,最大100 - hasDarkBackground(可选):强制使用深色模式样式。未设置时会根据页面背景自动检测
小件结构
该小组件按以下 HTML 结构渲染:

默认 CSS 参考

自定义示例
移除容器边框

自定义链接颜色
