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:
.ics-calendar, .r34ics_lightbox {
--r34ics--color--black: #000000;
--r34ics--color--darkgray: #555555;
}
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.
Colors
ICS Calendar Pro users: You can use the Customizer to modify your color palette, including selecting from a set of predefined alternate palettes, rather than writing custom CSS.
ICS Calendar color variables sometimes deviate slightly from the HTML colors their names share. When they are the same, the named color is used as the default value. (The named colors such as
gainsboro
are true neutrals; ICS Calendar shifts these to slightly “cool” grays.)
Variable | Purpose | Default |
---|---|---|
--r34ics--color--black |
Black, mostly for text | #10181f |
--r34ics--color--darkgray |
Medium gray; mostly borders (ironically, HTML darkgray is lighter than gray ) |
#a3a8ac |
--r34ics--color--dimgray |
Dark gray, mostly used in dark mode/inverted colors | #60686f |
--r34ics--color--dodgerblue |
ICS Events branding | dodgerblue |
--r34ics--color--gainsboro |
Light gray; mostly backgrounds and borders | #d9dcdf |
--r34ics--color--gold |
Reserved for future use | gold |
--r34ics--color--gray |
Medium gray; mostly borders | #70787f |
--r34ics--color--ics-purple |
ICS Calendar Pro branding | #312a85 |
--r34ics--color--ics-red |
ICS Calendar branding | #dc143c |
--r34ics--color--lemonchiffon |
Reserved for future use | lemonchiffon |
--r34ics--color--limegreen |
Reserved for future use | limegreen |
--r34ics--color--orangered |
Reserved for future use | orangered |
--r34ics--color--white |
White; mostly background elements | #ffffff |
--r34ics--color--whitesmoke |
Off-white; mostly background elements | #f0f3f6 |
--r34ics--color--trans10 |
Transparent gray; backgrounds, borders and shadows | rgba(105,105,105,0.1) |
--r34ics--color--trans20 |
Transparent gray; backgrounds, borders and shadows | rgba(105,105,105,0.2) |
--r34ics--color--trans30 |
Transparent gray; backgrounds, borders and shadows | rgba(105,105,105,0.3) |
--r34ics--color--trans40 |
Transparent gray; backgrounds, borders and shadows | rgba(105,105,105,0.4) |
--r34ics--color--trans50 |
Transparent gray; backgrounds, borders and shadows | rgba(105,105,105,0.5) |
--r34ics--color--trans60 |
Transparent gray; backgrounds, borders and shadows | rgba(105,105,105,0.6) |
--r34ics--color--trans70 |
Transparent gray; backgrounds, borders and shadows | rgba(105,105,105,0.7) |
--r34ics--color--trans80 |
Transparent gray; backgrounds, borders and shadows | rgba(105,105,105,0.8) |
--r34ics--color--trans90 |
Transparent gray; backgrounds, borders and shadows | 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 block background | var(--r34ics--color--trans10) |
r34ics--element--basic--date--border |
Basic view; date block border | 2px solid var(--r34ics--color--trans40) |
r34ics--element--color--whitetext |
Text color when the whitetext parameter is used | var(--r34ics--color--white) |
r34ics--element--descloc-feed-label--border-bottom |
Bottom border for feed labels (when used) in event description boxes | 1px solid var(--r34ics--color--trans30) |
r34ics--element--descloc-feed-label--border-left |
Left border for feed labels (when used) in event description boxes | 6px solid var(--r34ics--color--trans30) |
r34ics--element--descloc-feed-label-before--background |
Backround for feed labels (when used) in event description boxes | var(--r34ics--color--trans30) |
r34ics--element--events--color--whitetext |
Color for event text when whitetext parameter is used | var(--r34ics--color--white) |
r34ics--element--events--color |
Color for event text | var(--r34ics--color--black) |
r34ics--element--hover-block--background--whitetext |
Background color for event hover blocks when whitetext parameter is used | var(--r34ics--color--dimgray) |
r34ics--element--hover-block--background |
Background color for event hover blocks | var(--r34ics--color--white) |
r34ics--element--hover-block--border |
Border for event hover blocks | 1px solid var(--r34ics--color--darkgray) |
r34ics--element--hover-block--box-shadow |
Drop shadow for event hover blocks | 2px 2px 5px var(--r34ics--color--trans20) |
r34ics--element--lightbox--background |
Color of mask overlay when the lightbox is open | var(--r34ics--color--trans50) |
r34ics--element--lightbox-close--background |
Background of the lightbox close button | var(--r34ics--color--black) |
r34ics--element--lightbox-close--box-shadow |
Drop shadow of the lightbox close button | 3px 3px 9px var(--r34ics--color--trans50) |
r34ics--element--lightbox-close--color |
Color of the X in the lightbox close button | var(--r34ics--color--white) |
r34ics--element--lightbox-content--background |
Background color of the lightbox content area | var(--r34ics--color--white) |
r34ics--element--lightbox-content--box-shadow |
Drop shadow on the lightbox content area | 3px 3px 9px var(--r34ics--color--trans50) |
r34ics--element--lightbox-content--color |
Text color of the lightbox content | var(--r34ics--color--black) |
r34ics--element--month--background--whitetext |
Background color of the calendar table when whitetext parameter is used | var(--r34ics--color--black) |
r34ics--element--month--background |
Background color of the calendar table | var(--r34ics--color--white) |
r34ics--element--month--day--background--whitetext |
Background of day numbers in the calendar table when whitetext parameter is used | var(--r34ics--color--dimgray) |
r34ics--element--month--day--background |
Background of day numbers in the calendar table | var(--r34ics--color--whitesmoke) |
r34ics--element--month--day--color |
Text color of day numbers in the calendar table | var(--r34ics--color--black) |
r34ics--element--month--events-li--border-bottom |
Bottom border/separator on individual events in the calendar table | 1px solid var(--r34ics--color--gainsboro) |
r34ics--element--month--off--background--whitetext |
Background for days outside the current month in the calendar table, when whitetext parameter is used | var(--r34ics--color--dimgray) |
r34ics--element--month--off--background |
Background for days outside the current month in the calendar table | var(--r34ics--color--whitesmoke) |
r34ics--element--month--off--color |
Text color for days outside the current month in the calendar table | var(--r34ics--color--gray) |
r34ics--element--month--th--background--whitetext |
Background for day name headers in the calendar table when whitetext parameter is used | var(--r34ics--color--dimgray) |
r34ics--element--month--th--background |
Background for day name headers in the calendar table | var(--r34ics--color--gainsboro) |
r34ics--element--month--th--color |
Text color for day name headers in the calendar table | var(--r34ics--color--black) |
r34ics--element--month--th-td--border |
Cell borders in the calendar table | 1px solid var(--r34ics--color--gainsboro) |
r34ics--element--month--today-day--background--whitetext |
Background for the day number for “today” in the calendar table when whitetext parameter is used | var(--r34ics--color--gainsboro) |
r34ics--element--month--today-day--background |
Background for the day number for “today” in the calendar table | var(--r34ics--color--gray) |
r34ics--element--month--today-day--color--whitetext |
Text color for the day number for “today” in the calendar table when whitetext parameter is used | var(--r34ics--color--black) |
r34ics--element--month--today-day--color |
Text color for the day number for “today” in the calendar table | var(--r34ics--color--white) |
r34ics--element--multiday--background |
Background color for events spanning multiple days | var(--r34ics--color--gainsboro) |
r34ics--element--print--background |
Background color for all elements when printing | var(--r34ics--color--white) |
r34ics--element--print--border |
Border color for all elements when printing | 1px solid var(--r34ics--color--gainsboro) |
r34ics--element--print--color |
Text color for all elements when printing | var(--r34ics--color--black) |
r34ics--element--select--color |
Text color for the month selector dropdown menu | var(--r34ics--color--black) |
ICS Calendar Pro
These variables are used in ICS Calendar Pro only.
Variable | Purpose | Default |
---|---|---|
--r34ics--fc--fc-timegrid-slot--height-ratio |
Full view, height ratio of time slots in time grids | 0.6 |
--r34ics--fc--fc-timegrid-slot--hour-weight |
Full view, font weight for hours in time grids | bold |
--r34ics--image--max-width |
Maximum image width | 360px |
--r34ics--widget--max-width |
Widget/Widget Availability views, maximum width of the widget | 360px |