mirror of
https://github.com/wassname/talk.git
synced 2026-07-03 12:20:39 +08:00
fd64469c00
* docs: document css variables * Update 02-04-css.md
79 lines
2.3 KiB
Markdown
79 lines
2.3 KiB
Markdown
---
|
|
title: Customizing Styles with CSS
|
|
permalink: /v5/css/
|
|
---
|
|
|
|
You can add your own stylesheet in **Admin** > **Configure** > **Advanced** > **Custom CSS**.
|
|
|
|
### Use CSS Variables
|
|
|
|
We recommend using CSS Variables to broadly apply changes to certain styling aspects like color or fonts.
|
|
|
|
Here is a CSS example that modifies some of the CSS Variables.
|
|
|
|
```css
|
|
:root {
|
|
/* Change primary font */
|
|
--font-family-primary: 'Verdana';
|
|
|
|
/* Remove round corners */
|
|
--round-corners: 0px;
|
|
}
|
|
```
|
|
|
|
You can find all CSS Variables using the Web Inspector or navigate to https://github.com/coralproject/talk/blob/master/CSS_VARIABLES.md for a comprehensive list and additional information.
|
|
|
|
> **NOTE:** Before 6.3.0 Coral uses a different set of CSS Variables. Navigate to the link above to get information on upgrading.
|
|
|
|
### Use stable CSS Class Names
|
|
|
|
If you would like to change the styling of any elements of the comment embed, we provide global classnames. Most elements will be tagged with either `.coral` or `.coral-stream`.
|
|
|
|
The easiest way to find the classname for the element you're looking for is to use the web inspector, and then update your stylesheet accordingly.
|
|
|
|
You can also navigate to https://github.com/coralproject/talk/blob/master/src/core/client/stream/classes.ts to see available stable class names.
|
|
|
|
### Custom body class for theming
|
|
|
|
You can set the class name of the `<body>` tag inside the embed by using the `bodyClassName` parameter when calling `Coral.createStreamEmbed`:
|
|
|
|
```js
|
|
Coral.createStreamEmbed({
|
|
bodyClassName: "pink"
|
|
});
|
|
```
|
|
|
|
This will allow your styles to include variations:
|
|
|
|
```css
|
|
.pink button.coral {
|
|
background: pink;
|
|
}
|
|
```
|
|
|
|
### Reaction styling
|
|
|
|
As of Coral 6.3.0, Coral has support for styling based on the number of
|
|
reactions that a given comment has received. It does so via the:
|
|
|
|
```sh
|
|
.coral-reacted-{{ n }}
|
|
```
|
|
|
|
Where `{{ n }}` is the number of reactions the comment has received. You can
|
|
invert this when creating CSS to allow you to highlight comments that have at
|
|
least `{{ n }}` reactions. For example, if you wanted to add a coral color to
|
|
comments with at least 3 reactions, you could write:
|
|
|
|
```css
|
|
.coral-comment .coral-indent {
|
|
background-color: coral;
|
|
}
|
|
|
|
.coral-reacted-0 .coral-indent,
|
|
.coral-reacted-1 .coral-indent,
|
|
.coral-reacted-2 .coral-indent {
|
|
background-color: transparent;
|
|
}
|
|
```
|