
語言 🇹🇼 繁體中文
入門指南
小工具樣式
其他前端函式庫
自訂樣式指南
本指南提供 FastComments 評論小工具 (v2) 使用的完整預設 CSS 以及一些覆寫樣式的說明。
了解預設 CSS 可讓您:
- 自訂外觀:透過覆寫特定樣式來自訂外觀
- 排除樣式問題:透過查看可用的 class 與選擇器來排除樣式問題
- 建立自訂主題:建立與小工具結構相容的自訂主題
- 與 AI 助手搭配使用:以產生自訂 CSS 修改。
如何覆寫樣式
覆寫樣式依小工具而異。對於評論小工具,您必須使用 customCSS config 參數將 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:透過管理後台
- 在您的管理後台前往 小工具自訂頁面
- 捲動到「進階」中的「自訂 CSS」區段
- 輸入您的自訂 CSS
- 點選「儲存」
您輸入的自訂 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 新增至 Widget Customization 頁面 上的 Custom CSS 方塊,或透過 customCSS 選項傳遞。您只需設定想要更改的變數。
您也可以使用 Custom CSS 方塊正下方的 Comment box border 輔助工具,它會為您自動產生此 CSS。
更改邊框顏色

更改輸入時的邊框顏色

讓四個角全部變圓
預設情況下左上角是方形的。將兩個圓角變數都設定為相同的值,即可讓四個角全部變圓:

方形邊角

符合您的品牌風格

在深色模式中使用不同的顏色
當小工具處於深色模式時,它會帶有 dark class,因此您可以為深色模式設定不同的值:

為什麼不直接為文字區域設定樣式?
小工具會自行在文字區域周圍繪製留言框邊框的一部分。如果您只為 textarea 設定 border-color 或 border-radius,那些線條將保持預設樣式,邊框看起來會不一致,例如一條方形線條穿過圓角。上述變數會同時更改兩者。
評論小工具自訂 CSS 參考(v2,最新) 

最近評論小工具樣式 
「最新留言小工具」會顯示您整個網站或特定頁面上最新留言的清單。它包含標題、圓形頭像、留言預覽、可深層連結至該留言的可點擊日期,以及自動深色模式偵測。
基本安裝
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 參考

自訂範例
移除容器邊框

自訂連結顏色
