
언어 🇰🇷 한국어
시작하기
위젯 스타일링
기타 프론트엔드 라이브러리
맞춤 스타일링 가이드
이 가이드는 FastComments 댓글 위젯 (v2)에서 사용되는 기본 CSS 전체와 스타일을 재정의하는
몇 가지 지침을 제공합니다.
Understanding the default CSS allows you to:
- 모양을 사용자화: 특정 스타일을 재정의하여
- 스타일 문제 해결: 어떤 클래스와 선택자가 사용 가능한지 확인하여 스타일 문제를 진단
- 커스텀 테마 생성: 위젯의 구조에 맞는 커스텀 테마를 구축
- AI 어시스턴트와 함께 사용: 커스텀 CSS 수정을 생성하는 데 활용
스타일 재정의 방법
스타일 재정의 방법은 위젯에 따라 다릅니다. 댓글 위젯의 경우, customCSS 구성 매개변수를 사용하여 CSS를 iframe으로 전달하거나, 관리자 대시보드의 Customization 페이지에 CSS를 지정할 수 있으며, 해당 페이지는 CDN에서 CSS를 제공합니다.
스타일 맞춤 방법 
댓글 위젯 스타일 사용자 지정 방법
댓글 위젯 스타일은 다음 두 가지 방법으로 사용자 지정할 수 있습니다:
옵션 1: customCSS 매개변수 사용
위젯을 초기화할 때 customCSS 매개변수에 사용자 정의 CSS를 문자열로 전달하세요:
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를 사용합니다 - 별도의 전처리기가 필요하지 않습니다
댓글 박스 테두리 맞춤 
댓글 상자 주변의 테두리는 텍스트 영역 자체의 테두리와 위젯이 그 주위에 그리는 몇 개의 얇은 선으로 구성됩니다. 색상이나 모서리 둥글기를 변경하려면 textarea를 직접 스타일링하는 대신 다음 CSS 변수를 설정하세요. 이 변수들은 테두리의 모든 부분을 한 번에 재스타일링하므로 모서리와 색상이 항상 일치합니다.
| 변수 | 변경 내용 | 기본값 |
|---|---|---|
--fc-input-border-color | 테두리 색상 | #bfbfbf |
--fc-input-border-color-focus | 사용자가 입력하는 동안의 테두리 색상 | #555 |
--fc-input-border-radius | 둥근 모서리의 둥글기 | 11px |
--fc-input-border-start-start-radius | 왼쪽 위 사각형 모서리의 둥글기 (오른쪽에서 왼쪽 언어에서는 오른쪽 위) | 0 |
Widget Customization page의 Custom CSS 상자에 CSS를 추가하거나, customCSS 옵션으로 전달하세요. 변경하려는 변수만 설정하면 됩니다.
Custom CSS 상자 바로 아래의 Comment box border 헬퍼를 사용할 수도 있는데, 이 헬퍼가 이 CSS를 대신 작성해 줍니다.
테두리 색상 변경

입력 중 테두리 색상 변경

네 모서리 모두 둥글게 만들기
기본적으로 왼쪽 위 모서리는 사각형입니다. 네 모서리를 모두 동일하게 둥글게 만들려면 두 radius 변수를 모두 설정하세요:

사각형 모서리

브랜드에 맞추기

다크 모드에서 다른 색상 사용
위젯이 다크 모드일 때는 dark 클래스가 적용되므로, 다크 모드에 대해 다른 값을 설정할 수 있습니다:

텍스트 영역을 직접 스타일링하면 안 되나요?
위젯은 텍스트 영역 주변의 댓글 상자 테두리 일부를 직접 그립니다. textarea에만 border-color 또는 border-radius를 설정하면, 그 선들은 기본 스타일을 유지하여 테두리가 어울리지 않게 보입니다. 예를 들어 둥근 모서리를 가로지르는 사각형 선이 나타날 수 있습니다. 위의 변수들은 두 부분을 한 번에 변경합니다.
댓글 위젯 맞춤 CSS 레퍼런스 (v2, 최신) 

최근 댓글 위젯 스타일링 
최근 댓글 위젯은 사이트 전체 또는 특정 페이지의 최신 댓글 목록을 표시합니다. 제목, 둥근 아바타, 댓글 미리보기, 댓글로 직접 연결되는 클릭 가능한 날짜, 자동 다크 모드 감지를 포함합니다.
기본 설치
Run 
구성 옵션
- tenantId (필수): FastComments 테넌트 ID
- urlId (선택 사항): 단일 페이지로 필터링합니다. 모든 페이지를 표시하려면 null로 둡니다
- count (선택 사항): 표시할 댓글 수입니다. 기본값은
10 - hasDarkBackground (선택 사항): 다크 모드 스타일을 강제 적용합니다. 설정하지 않으면 페이지 배경에서 자동으로 감지됩니다
위젯 구조
위젯은 다음 HTML 구조로 렌더링됩니다:

기본 CSS 참조

사용자 지정 예제
아바타 크기 변경

댓글 텍스트 더 많이 표시

컨테이너 테두리 제거

가장 많이 논의된 페이지 위젯 스타일링 
가장 많이 논의된 페이지 위젯은 댓글이 가장 많은 페이지를 순위별로 표시합니다. 헤딩, 번호 매겨진 순위, 아이콘이 있는 댓글 수, 마지막 활동 날짜 및 자동 다크 모드 감지를 포함합니다.
기본 설치
Run 
구성 옵션
- tenantId (required): Your FastComments tenant ID
- hasDarkBackground (optional): 다크 모드 스타일을 강제 적용합니다. 설정하지 않으면 페이지 배경에서 자동으로 감지됩니다
위젯 구조
위젯은 다음 HTML 구조로 렌더링됩니다:

기본 CSS 참조

맞춤 설정 예제
순위 배지 제거

컨테이너 테두리 제거

최근 토론 위젯 스타일링 
최근 토론 위젯(Recent Discussions Widget)은 가장 최근의 댓글 활동을 기준으로 정렬된 페이지 목록을 표시합니다. 제목, 마지막 활동 날짜, 아이콘이 포함된 댓글 수, 그리고 자동 다크 모드 감지 기능이 포함됩니다.
기본 설치
Run 
설정 옵션
- tenantId (필수): FastComments 테넌트 ID
- count (선택): 표시할 페이지 수. 기본값은
20, 최대100 - hasDarkBackground (선택): 다크 모드 스타일링 강제 적용. 설정하지 않으면 페이지 배경에서 자동으로 감지됩니다
위젯 구조
위젯은 다음 HTML 구조로 렌더링됩니다:

기본 CSS 참조

커스터마이징 예제
컨테이너 테두리 제거

커스텀 링크 색상
