ICS Calendar and ICS Calendar Pro use a set of CSS variables to define colors and various other properties used within the plugin.
You can change the values of these variables in your own theme CSS to modify some aspects of the calendar appearance without having to use the inspector to find specific CSS selectors.
Variable Scope
CSS variables are given specific scope. Commonly :root { } is used, for the variable to apply universally.
ICS Calendar does not use :root { }. In order to avoid inadvertently affecting styles outside of ICS Calendar’s own output, the scope for ICS Calendar CSS variables is .ics-calendar, .r34ics_lightbox { }. All variable overrides should be placed inside the curly braces with this scope. For example:
<code>.ics-calendar, .r34ics_lightbox {
--r34ics--color--black: #000000;
--r34ics--color--darkgray: #555555;
}</code>
Custom CSS can go in your site theme’s CSS file, or in the Customizer under Additional CSS.
The tables below describe the available CSS variables, their purpose, and their default values.
ICS Calendar Pro users: You can use the Appearance tab of the settings page to modify your color palette, including selecting from a set of predefined alternate palettes, rather than writing custom CSS.
Colors
| Variable | Purpose | Default |
|---|---|---|
--r34ics--color--ics-red | ICS Calendar branding | #ee0055 |
--r34ics--color--ics-purple | ICS Calendar Pro branding | #3300bb |
--r34ics--color--ics-blue | ICS Events branding | #0099ff |
--r34ics--color--white | Neutral palette color | #ffffff |
--r34ics--color--whitesmoke | Neutral palette color | #f0f3f6 |
--r34ics--color--gainsboro | Neutral palette color | #d9dcdf |
--r34ics--color--darkgray | Neutral palette color1 | #a3a8ac |
--r34ics--color--gray | Neutral palette color | #70787f |
--r34ics--color--dimgray | Neutral palette color | #60686f |
--r34ics--color--black | Neutral palette color | #10181f |
--r34ics--color--darkorange | Admin status messages | darkorange |
--r34ics--color--dodgerblue | Admin status messages | dodgerblue |
--r34ics--color--forestgreen | Admin status messages | forestgreen |
--r34ics--color--gold | Reserved for future use | gold |
--r34ics--color--lemonchiffon | Reserved for future use | lemonchiffon |
--r34ics--color--limegreen | Reserved for future use | limegreen |
--r34ics--color--orangered | Admin status messages | orangered |
--r34ics--color--trans03 | Transparent gray for borders and backgrounds | rgba(105,105,105,0.03) |
--r34ics--color--trans05 | Transparent gray for borders and backgrounds | rgba(105,105,105,0.05) |
--r34ics--color--trans10 | Transparent gray for borders and backgrounds | rgba(105,105,105,0.1) |
--r34ics--color--trans20 | Transparent gray for borders and backgrounds | rgba(105,105,105,0.2) |
--r34ics--color--trans30 | Transparent gray for borders and backgrounds | rgba(105,105,105,0.3) |
--r34ics--color--trans40 | Transparent gray for borders and backgrounds | rgba(105,105,105,0.4) |
--r34ics--color--trans50 | Transparent gray for borders and backgrounds | rgba(105,105,105,0.5) |
--r34ics--color--trans60 | Transparent gray for borders and backgrounds | rgba(105,105,105,0.6) |
--r34ics--color--trans70 | Transparent gray for borders and backgrounds | rgba(105,105,105,0.7) |
--r34ics--color--trans80 | Transparent gray for borders and backgrounds | rgba(105,105,105,0.8) |
--r34ics--color--trans90 | Transparent gray for borders and backgrounds | rgba(105,105,105,0.9) |
Selector Properties
Introduced in ICS Calendar 11.5.15 (and ICS Calendar Pro 5.10.9), these variables apply to specific selectors, allowing you to customize your calendar appearance to a greater extent than simply changing the values of the color variables. Most of these variables reference other color variables, or occasionally consist of a color variable plus dimensions.
| Variable | Purpose | Default |
|---|---|---|
--r34ics--element--basic--date--background | Basic view date background | var(--r34ics--color--trans10) |
--r34ics--element--basic--date--border | Basic view date border design | 2px solid var(--r34ics--element--basic--date--border-color) |
--r34ics--element--basic--date--border-color | Basic view date border color | var(--r34ics--color--trans40) |
--r34ics--element--basic--date--color | Basic view date text color | var(--r34ics--color--black) |
--r34ics--element--button--background | Button background | var(--r34ics--color--gray) |
--r34ics--element--button--background-hover | Button background hover state | var(--r34ics--color--darkgray) |
--r34ics--element--button--border | Button border design | 1px solid var(--r34ics--element--button--border-color) |
--r34ics--element--button--border-color | Button border color | var(--r34ics--color--gray) |
--r34ics--element--button--border-color-hover | Button border color hover state | var(--r34ics--color--darkgray) |
--r34ics--element--button--border-radius | Button border radius | 4px |
--r34ics--element--button--color | Button text color | var(--r34ics--color--white) |
--r34ics--element--button--color-hover | Button text color hover state | var(--r34ics--color--white) |
--r34ics--element--descloc-feed-label--border-bottom | Feed label styling in event description hover box: bottom border design | 1px solid var(--r34ics--element--descloc-feed-label--border-bottom-color) |
--r34ics--element--descloc-feed-label--border-bottom-color | Feed label styling in event description hover box: bottom border color | var(--r34ics--color--trans30) |
--r34ics--element--descloc-feed-label--border-left | Feed label styling in event description hover box: left border design | 6px solid var(--r34ics--element--descloc-feed-label--border-left-color) |
--r34ics--element--descloc-feed-label--border-left-color | Feed label styling in event description hover box: left border color | var(--r34ics--color--trans30) |
--r34ics--element--descloc-feed-label-before--background | Feed label styling in event description hover box: background on :before pseudoelement | var(--r34ics--color--trans30) |
--r34ics--element--events--accent--background | Event styling: accent background color | var(--r34ics--color--gray) |
--r34ics--element--events--accent--border-color | Event styling: accent border color | var(--r34ics--color--gray) |
--r34ics--element--events--accent--color | Event styling: accent text color | var(--r34ics--color--white) |
--r34ics--element--events--color | Event styling: text color | var(--r34ics--color--black) |
--r34ics--element--events--color--link | Event styling: link color (inherit from theme) | inherit |
--r34ics--element--events--color--link-hover | Event styling: link hover state color (inherit from theme) | inherit |
--r34ics--element--hover-block--background | Event details hover block: background color | var(--r34ics--color--white) |
--r34ics--element--hover-block--border | Event details hover block: border design | 1px solid var(--r34ics--element--hover-block--border-color) |
--r34ics--element--hover-block--border-color | Event details hover block: border color | var(--r34ics--color--darkgray) |
--r34ics--element--hover-block--box-shadow | Event details hover block: shadow | 2px 2px 5px var(--r34ics--color--trans20) |
--r34ics--element--lightbox--background | Event details lightbox: background color | var(--r34ics--color--trans50) |
--r34ics--element--lightbox-close--background | Event details lightbox: close button background color | var(--r34ics--color--black) |
--r34ics--element--lightbox-close--box-shadow | Event details lightbox: close button shadow | 3px 3px 9px var(--r34ics--color--trans50) |
--r34ics--element--lightbox-close--color | Event details lightbox: close button X color | var(--r34ics--color--white) |
--r34ics--element--lightbox-content--background | Event details lightbox: content background color | var(--r34ics--color--white) |
--r34ics--element--lightbox-content--box-shadow | Event details lightbox: content shadow | 3px 3px 9px var(--r34ics--color--trans50) |
--r34ics--element--lightbox-content--color | Event details lightbox: content text color | var(--r34ics--color--black) |
--r34ics--element--month--background | Month (table) view: background color | var(--r34ics--color--white) |
--r34ics--element--month--day--background | Month (table) view: day background color | var(--r34ics--color--whitesmoke) |
--r34ics--element--month--day--color | Month (table) view: day text color | var(--r34ics--color--black) |
--r34ics--element--month--events-li--border-bottom | Month (table) view: day events list divider design | 1px solid var(--r34ics--element--month--events-li--border-bottom-color) |
--r34ics--element--month--events-li--border-bottom-color | Month (table) view: day events list divider color | var(--r34ics--color--gainsboro) |
--r34ics--element--month-label--color | Month (table) view: month heading label color (inherit from theme) | inherit |
--r34ics--element--month--off--background | Month (table) view: background for days outside current month | var(--r34ics--color--whitesmoke) |
--r34ics--element--month--off--color | Month (table) view: text color for days outside current month | var(--r34ics--color--gray) |
--r34ics--element--month--th--background | Month (table) view: header background | var(--r34ics--color--gainsboro) |
--r34ics--element--month--th--color | Month (table) view: header text color | var(--r34ics--color--black) |
--r34ics--element--month--th-td--border | Month (table) view: grid border design | 1px solid var(--r34ics--element--month--th-td--border-color) |
--r34ics--element--month--th-td--border-color | Month (table) view: grid border color | var(--r34ics--color--gainsboro) |
--r34ics--element--month--today-day--background | Month (table) view: “today” day header background | var(--r34ics--color--gray) |
--r34ics--element--month--today-day--color | Month (table) view: “today” day header text color | var(--r34ics--color--white) |
--r34ics--element--print--background | Print background color | var(--r34ics--color--white) |
--r34ics--element--print--border | Print grid border design | 1px solid var(--r34ics--element--print--border-color) |
--r34ics--element--print--border-color | Print grid border color | var(--r34ics--color--gainsboro) |
--r34ics--element--print--color | Print text color | var(--r34ics--color--black) |
--r34ics--element--select--background | Month dropdown selector background | var(--r34ics--color--whitesmoke) |
--r34ics--element--select--color | Month dropdown selector text color | var(--r34ics--color--black) |
ICS Calendar Pro
These variables are used in ICS Calendar Pro only.
| Variable | Purpose | Default |
|---|---|---|
--r34ics--image--max-width | Maximum width of images in event descriptions | 360px |
--r34ics--widget--max-width | Maximum width of Widget view | 360px |
ICS Calendar Pro: Full View
These variables apply to Full view in ICS Calendar Pro only. The scope for these variables is .ics-calendar .fc { }.
| Variable | Purpose | Default |
|---|---|---|
--r34ics--fc--font--size | Text size | 13px |
--r34ics--fc--fc-timegrid-slot--height-ratio | Scaling ratio for height of time slots in day and week tabs | 0.6 |
--r34ics--fc--fc-timegrid-slot--hour-weight | Font weight for time labels in day and week tabs | bold |
--fc-bg-event-color | Text color for events outside range | var(--r34ics--color--gray) |
--fc-bg-event-opacity | Opacity for events outside range | 0.3 |
--fc-border-color | Grid border color | var(--r34ics--element--month--th-td--border-color) |
--fc-button-active-bg-color | Tab/button background color active state | var(--r34ics--color--dimgray) |
--fc-button-active-border-color | Tab/button border color active state | var(--r34ics--color--dimgray) |
--fc-button-bg-color | Tab/button background color | var(--r34ics--element--button--background) |
--fc-button-border-color | Tab/button border color | var(--r34ics--element--button--border-color) |
--fc-button-hover-bg-color | Tab/button background color hover state | var(--r34ics--element--button--background-hover) |
--fc-button-hover-border-color | Tab/button border color hover state | var(--r34ics--element--button--border-color-hover) |
--fc-button-text-color | Tab/button text color | var(--r34ics--element--button--color) |
--fc-event-bg-color | Event background color | var(--r34ics--element--events--accent--background) |
--fc-event-border-color | Event border color | var(--r34ics--element--events--accent--border-color) |
--fc-event-resizer-dot-border-width | (Not applicable) | 1px |
--fc-event-resizer-dot-total-width | (Not applicable) | 8px |
--fc-event-resizer-thickness | (Not applicable) | 8px |
--fc-event-selected-overlay-color | Background color for selected event overlay | var(--r34ics--color--trans30) |
--fc-event-text-color | Event text color | var(--r34ics--element--events--accent--color) |
--fc-highlight-color | Event highlight color | rgba(188,232,241,.3) |
--fc-list-event-hover-bg-color | Event hover background color | var(--r34ics--color--trans30) |
--fc-more-link-bg-color | More link background color | var(--r34ics--element--events--accent--background) |
--fc-more-link-text-color | More link text color | var(--r34ics--element--events--accent--color) |
--fc-neutral-bg-color | Neutral background color | var(--r34ics--element--month--off--background) |
--fc-neutral-text-color | Neutral text color | var(--r34ics--element--month--off--color) |
--fc-non-business-color | Background color for non-business days | var(--r34ics--element--month--off--background) |
--fc-now-indicator-color | “Now” indicator color for day/week tabs | var(--r34ics--color--ics-red) |
--fc-page-bg-color | Overall page background color | var(--r34ics--element--month--background) |
--fc-small-font-size | Small font size | var(--r34ics--fc--font--size) |
--fc-today-bg-color | Today background color | var(--r34ics--element--month--background) |
- Yes,
darkgrayis lighter thangray. We’re just using standard HTML color names and that’s how they’re defined. ↩︎
