2 responses on “Custom CSS in the Site-Editing era

  1. Kathryn P.'s avatar Kathryn P.

    Here are the code snippets I used during the site-wide CSS editor demo, along with all the resources that were mentioned:


    /* Image block – caption */
    .wp-block-image figcaption {
    margin-top: 0;
    padding: 20px 10px;
    background-color: #4ccee6;
    color: #563429;
    font-weight: bold;
    }
    /* Quote block – first letter different */
    .wp-block-quote p::first-letter {
    font-weight: bold;
    color: #4ccee6;
    font-size: 70px;
    }
    /* Quote block – citation */
    .wp-block-quote cite {
    font-variant: small-caps;
    }
    /* Button hover */
    .wp-block-button__link:hover {
    background-color:#4ccee6;
    }
    /* Unordered list */
    ul {
    list-style-type: square;
    }
    /* Special button hover – use this with an Additional CSS class in the block editor */
    .my-special-class .wp-block-button__link:hover {
    background-color: #bb00bb;
    }

  2. Kathryn P.'s avatar Kathryn P.

    DOCUMENTATION/TUTORIALS

    Block Themes
    https://wordpress.org/documentation/article/block-themes/

    Styles
    https://wordpress.org/documentation/article/styles-overview/

    Styles Overview – Applying Custom CSS
    https://wordpress.org/documentation/article/styles-overview/#applying-custom-css

    Site-wide Custom CSS
    https://wordpress.org/documentation/article/styles-overview/#site-wide-custom-css

    Per-block Custom CSS
    https://wordpress.org/documentation/article/styles-overview/#per-block-css

    Using the Style Book With Block Themes
    https://learn.wordpress.org/tutorial/how-to-use-the-wordpress-stylebook-with-your-block-theme/

    Create Block Theme Plugin
    https://wordpress.org/plugins/create-block-theme/

    OTHER RESOURCES

    Mozilla CSS Reference
    https://developer.mozilla.org/en-US/docs/Web/CSS

    More Advanced reading – Per-block CSS with theme.json
    https://developer.wordpress.org/news/2023/04/per-block-css-with-theme-json/

    GETTING HELP

    Theme Support Forum – for example, here’s the Twenty Twenty-Three forum
    https://wordpress.org/support/theme/twentytwentythree/

    Gutenberg Support Forum
    https://wordpress.org/support/plugin/gutenberg/

    Gutenberg GitHub
    https://github.com/WordPress/gutenberg/issues

    WHAT’S NEXT

    Code Linting
    https://github.com/WordPress/gutenberg/issues/47945

    List of blocks with custom CSS applied
    https://github.com/WordPress/gutenberg/issues/47946

    Selective loading of block CSS
    https://github.com/WordPress/gutenberg/issues/49559

    Clear hierarchy of styles
    https://github.com/WordPress/gutenberg/issues/49278

Continue the discussion

Published

June 14, 2023

WordPress 6.2 introduced two new ways to add custom CSS to your site: a global CSS editor, and a per-block CSS editor. Both methods let you add CSS overrides directly in the Site Editor, in order to tweak the way your site looks. In this session we’ll cover the differences between the two types of editors, and how to use them effectively and appropriately.

We’ll also look at:

– A brief history of custom CSS in WordPress.
– The purpose of having custom CSS editors in the Site Editor in the first place; when to use them, and when not to.
– A cross-section of practical examples that you can put into action right away!

To get the most out of this workshop, you should have some knowledge of CSS basics and understand how to use a browser inspector to find the right elements to target. The workshop won’t cover how to write CSS itself.

Presentation Slides »

Rate this:

Speakers

Kathryn Presner 33
Álvaro Gómez Velasco 19

Language

English 11384

Download
MP4: Low, Original
Subtitles
TTML: English
Subtitle this video →
Producer