
언어 🇰🇷 한국어
시작하기
위젯 스타일링
기타 프론트엔드 라이브러리
맞춤 스타일링 가이드
이 가이드는 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를 사용합니다 - 별도의 전처리기가 필요하지 않습니다
댓글 박스 테두리 맞춤 
The border around the comment box is made of the text area's own border plus a few thin lines the widget draws around it. To change its color or corner roundness, set these CSS variables instead of styling the textarea directly. The variables restyle every part of the border at once, so the corners and colors always line up.
댓글 상자 주변의 테두리는 텍스트 영역 자체의 테두리와 위젯이 그 주위에 그리는 몇 개의 얇은 선으로 구성됩니다. 색상이나 모서리 둥글기를 변경하려면 textarea를 직접 스타일링하는 대신 이러한 CSS 변수를 설정하세요. 이 변수들은 테두리의 모든 부분을 한 번에 다시 스타일링하므로 모서리와 색상이 항상 일치합니다.
| Variable | What it changes | Default |
|---|---|---|
--fc-input-border-color | 테두리 색상 | #bfbfbf |
--fc-input-border-color-focus | 사용자가 입력 중일 때 테두리 색상 | #555 |
--fc-input-border-radius | 둥근 모서리의 반경 | 11px |
--fc-input-border-start-start-radius | 좌상단 사각형 모서리의 반경 (RTL 언어에서는 우상단) | 0 |
Add the CSS to the Custom CSS box on the Widget Customization page, or pass it with the customCSS option. You only need to set the variables you want to change.
CSS를 Custom CSS 상자에 추가하거나, customCSS 옵션으로 전달하세요. 변경하고 싶은 변수만 설정하면 됩니다.
You can also use the Comment box border helper right under the Custom CSS box, which writes this CSS for you.
또한 Custom CSS 상자 바로 아래에 있는 Comment box border 도우미를 사용하면 이 CSS를 자동으로 작성해 줍니다.
Change the Border Color

Change the Border Color While Typing

Round All Four Corners
By default the top-left corner is square. Set both radius variables to round all four corners the same:
기본적으로 좌상단 모서리는 사각형입니다. 두 반경 변수를 모두 설정하여 네 모서리를 동일하게 둥글게 만들 수 있습니다.

Square Corners

Match Your Brand

Different Colors in Dark Mode
When the widget is in dark mode it has the dark class, so you can set different values for dark mode:
다크 모드에서는 위젯에 dark 클래스가 적용되므로 다크 모드용으로 다른 값을 설정할 수 있습니다.

Why Not Style the Text Area Directly?
The widget draws part of the comment box border itself, around the text area. If you set border-color or border-radius only on the textarea, those lines keep the default style and the border looks mismatched, for example a square line running through a rounded corner. The variables above change both at once.
위젯은 텍스트 영역 주위에 댓글 상자 테두리의 일부를 직접 그립니다. 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 참조

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

컨테이너 테두리 제거

최근 토론 위젯 스타일링 
The Recent Discussions Widget displays a list of pages sorted by the most recent comment activity. It includes a heading, last activity dates, comment counts with icons, and automatic dark mode detection.
Basic Installation
Run 
Configuration Options
- tenantId (required): FastComments 테넌트 ID
- count (optional): 표시할 페이지 수. 기본값은
20, 최대100 - hasDarkBackground (optional): 다크 모드 스타일을 강제 적용합니다. 설정되지 않은 경우 페이지 배경에서 자동 감지됩니다
Widget Structure
The widget renders with the following HTML structure:

Default CSS Reference

Customization Examples
Remove the Container Border

Custom Link Color
