Changelog

Keep track of what's new with ACSS! For details on specific features and utilities, please check the official documentation.

New
Enhance
Fix
  • June 28, 2024

    3.0.0

    V3.0 is now official! This changelog entry only lists the changes since rc-2. Make sure you review the long list of beta and RC changelog releases for 3.0 prior to this one for the full scope of updates related to v3.0. Always make a backup of your site before upgrading and clear all caches, including server caches and cloudflare prior to submitting any support requests.

    • .link-hover-- classes

      Users can now change link hover styles on the fly for individual links or groups of links with .link-hover-- classes.

    • .btn--none

      .btn--none prevents auto .btn-- syntax matching in case users want to use the .btn-- syntax, but don’t want ACSS to apply global button styles automatically. It also clears user agent styling on <button> elements.

    • Simple Bricks UI/UX Enhancements

      • Stack elements panel (single column)
      • Remove walled-garden elements (“builder pro mode”)
      • Remove redundant components (for Frames users)
    • Manage dashboard state for frontend and backend separately

      The builder will now remember its open/close position separately on the frontend and backend. For users that don’t open the dashboard on the front end, this will keep the dashboard closed on the frontend even when you’ve left it open on the backend.

    • Refactored header height and scroll offset features

      These features were improved for consistency and code efficiency.

    • Content Grid exclusions

      When setting sections to default to content grid structure, users now have programmatic control over where that structure is excluded. For example, you can exclude third party code that uses <section> elements from having their structure changed.

    • New constant as alternative to wp_environment_type

      We no longer use wp_environment_type for development as this was creating conflicts on some dev installs.

    • Option to use header height for scroll offsets

      This was automatic in the past, but it now has a toggle in case users want to disconnect header height from scroll offsets.

    • You can now save changes directly from the search results screen

      No more relying on the keyboard shortcut or clearing searches in order to save.

    • Improved backend validation

    • Fixed some instances where the "changed" indicator dot wasn't indicating properly

      Some random toggles suggested the current value was not the default when it actually was.

    • Fixed an issue with the dashboard not opening in Gutenberg

      Gutenberg is a real joy to work with.

    • Fixed global styling for text size classes

      Not all global styles were being applied from the dashboard to text sizes when using text size classes. This is fixed.

    • Fixed missing spacing in non-iframe Gutenberg instances

      If your Gutenberg instance uses the non-iframe version of Gutenberg, you’ll see proper spacing now, assuming you’ve turned off “Use Gutenberg for Page Building.”

    • Fixed the toggle that completely removes ACSS styling from Gutenberg

      This toggle works now.

    • Fix for box-shadow paste error

      Pasting a value in the box-shadow input sometimes resulted in a value of “0.” This is now fixed.

    • Fluent Forms styling fixes

      • Fixed progress bar styling
      • Fixed font size styling
    • WS Form styling fixes

      • Fixed a bug causing invalid input text color visibility issues with dark form styles
      • Fixed active tab border style conflict with step numbers
    • Fixed a bug with blank heading/text size inputs in overrides

      Size would compute to “0px” when the input was blank.

    • More bug fixes related to dashboard position with boxed layouts

      Boxed layout was throwing the dashboard off the screen.

    • Fixed the duplicate save button generated by cheatsheet searches

      Searching in the cheatsheet was producing a second save button near the search input that isn’t needed. This is fixed.

    • Fix for live preview of font sizes when clearing inputs

      You’d need to refresh on earlier versions. You no longer have to do this.

  • June 20, 2024

    3.0.0-rc-2

    WCEU delayed the investigation of the Gutenberg bug, so we’re releasing what we have this week. Next week is scheduled for official 3.0. Note: ACSS is stable for production sites and should be safe to upgrade as well. Please make a backup. If you notice any issues after upgrade please report them.

    • Added control for default section block padding

      You can now control the default section block padding value, including the ability to remove top or bottom section padding by default (helpful in certain use cases).

    • New "Use Block Editor for Page Building" Option

      When editing pages with the block editor, ACSS will no longer assume you want to use the block editor for full page building and will not change the block editor behavior.

      If you do want to use the block editor for full page building, you can toggle this feature on under Options > Gutenberg.

      Warning: This is still not perfect on sites that have plugins which use blocks on the block editor API prior to V3 because of an architectural issue in Gutenberg that we have to find a workaround for. Details on this issue here.

    • Improve color scheme compatibility with auto color relationships

      There were a few specificity issues related to auto color relationships when combined with color scheme. These have been worked out.

    • Line-height inputs now support calc()

      Some line height inputs supported calc() and some didn’t. Now they all do.

    • Line-height variable application now supports calc()

      Using calc() for line-height within variables can be problematic if placed on generic elements like the body, so the framework has been improved to ensure that calculated line heights are applied accurately.

    • New smart line-height defaults

      The default value for line height has been changed to a new, smarter approach to line height which adds a “leading” value in pixels to double the x-height value of the font.

      This approach sets a sensible default line height for headings and text that scales appropriately across all sizes and responds more accurately to fluid responsive typography while still being easy for users to adjust.

    • Workaround for "sticky hover" issue on touch devices

      Setting hover using the pseudo class :hover alone has always been problematic in the era of touch devices. This is because, on touch devices, hover styles “stick” on user interaction. This is undesirable for <button> elements and anchor links.

      We’ve improved buttons and links to ensure they no longer suffer from this default browser interpretation of traditional :hover styles.

  • June 7, 2024

    3.0.0-rc-1

    We were hoping that this week would be the release of 3.0 official. Unfortunately, there’s a dashboard loading issue in Gutenberg, possibly related to the latest WP update, that requires further investigation. To make things more challenging, this issue does not apply to every install. There’s also an issue with how Gutenberg sometimes loads in an iframe and sometimes doesn’t, which makes the block editor unpredictable.

    Gutenberg is far more of a technical mess than most people realize and it causes endless problems with development. As it stands now, 3.0 official is scheduled for release after our return from Italy, the week after next.

    With that said, ACSS 3.0 is now in RC phase. Users are encouraged to backup existing websites, copy the export JSON from the import/export screen (store it somewhere safe), and upgrade to 3.0. The JSON export is required in case you need to rollback your install for some reason. Also note: We would not recommend bulk updating websites yet. Update sites independently, clear all caching including server caching, and then review your site to verify a clean upgrade.

    • JS Recipes

      We’ve added a new category of recipes dedicated to writing Javascript in a builder environment. The first recipe added is @script; which generates script tags using the type=”module” syntax for creating a new scoping context (to prevent collisions), automatically deferring the script, and ensuring DOM is loaded before script execution.

    • Save changes from search results

      You can now save changes from the search results screen.

    • Smart spacing only affects direct children

      One of the smart spacing instructions (for lists) was inappropriately touching certain children. That’s obviously not a good thing, so we’ve fixed it.

    • XL Breakpoint default value now matches content width default value

      When we changed the default content width for new installs to 1366, we left the XL breakpoint at 1280. These now match out of the gate.

    • Fixed the .on-scroll sticky header bug in Bricks

      You can thank Bricks’ mild addiction to unnecessary specificity for that one.

    • Toggle labels no longer collide with the dashboard header

      Z-index is a bitch sometimes.

    • Fix for boxed layout tossing the dashboard off the screen

      There are so many points of contention for creating a floating, pinnable panel across a wide range of builder environments and browsers. Things aren’t perfect, but they continue to improve.

    • Fixed an issue with Gutenberg button code output

      Too technical to describe in a short paragraph. All-in-all, less code gets output now, buttons still work great, and there’s nothing to see here.

  • May 30, 2024

    3.0-beta-3

    We’re getting close! We’re going to try and avoid another beta version. If all goes well, the next release should be 3.0 official!

    • Dashboard Integration in Gutenberg & Generate

      The ACSS dashboard now loads and instantly previews in Gutenberg. This also provides integration for Generate Blocks users.

    • Dashboard Integration in Breakdance (See Notes)

      The ACSS dashboard now loads and instantly previews in Breakdance.

      Note: Breakdance doesn’t have a hook that allows us to load the dashboard in the Breakdance builder DOM. The only hook they offer is loading the dashboard in the builder’s preview/canvas DOM.

      This isn’t an ideal experience, so we’ve reached out to the Breakdance team and it looks like they’ll add a new hook for us. Once that hook is released, we’ll move the dashboard into the full builder DOM.

      Contextual menus and other builder enhancements will follow in a future release to complete full integration with Breakdance.

    • Dashboard Integration in Oxygen

      The ACSS dashboard now loads and instantly previews in Oxygen.

    • New & enhanced btn() mixin

      • The new, more powrful btn() mixin replaces the old btn-default() mixin. You can now apply styles from *any* of the 36 available button styles in ACSS to any selector with a single include statement. Read more about button mixins.
    • New @btn recipe

    • Automatic support for sticky headers in boxed layouts in Bricks

      • Activating the boxed layout feature in ACSS would not have previously affected sticky headers in Bricks because of their fixed position and 100% width. We’ve now added native/automatic support for fixed/sticky headers when boxed layouts are active.
      • If you’ve manually created a sticky header, all you have to do is add the class “.sticky” to your header to gain boxed layout support.

      Note: We’ll be extending support to other builders that have a sticky header option soon.

    • Gutenberg canvas background color, spacing, and text sizes.

      • Gutenberg looked odd in previous betas due to ACSS’s inability to load in Gutenberg fully. This should be resolved now.

      Note: Certain users may still have issues due to the complexity and messiness of the Gutenberg environment. If you encounter any new issues, please start a thread in the ACSS support group.

    • Fixed button classes in Gutenberg

      • Button classes reverted to styling the wrapper that Gutenberg places on all links instead of the links themselves. This is now fixed.
    • Tertiary palette folder and swatches now load in Bricks

      In previous betas, the functionality for installing the new Tertiary color swatches and Tertiary color folder in Bricks’ color picker was missing. This is now fixed. However, since Bricks doesn’t have a proper hook for installing colors, you must deactivate and then reactivate ACSS for previously deactivated colors to be installed natively in the builder (once that color is turned on).

    • Fixed dashboard dropdown z-index issue

      The dropdown was going behind the dashboard’s sticky header bar. This is now fixed.

  • May 16, 2024

    3.0-beta-2.2

    • Conditional logic for automatic content offset

      • Turn off content offset with a custom header selector. Default is [data-header-sticky='0'], but you can create your own.
      • Turn off content offset with body class selectors. Default is .content-offset--off but you can target any body classes you’d like.
    • Improve drag and pin functionality

      It’s still not perfect, but it’s definitely better.

    • Remove Gutenberg master switch

      This started out as an internal insurance policy of sorts, but it’s redundant now so we’ve removed it.

    • Dashboard inputs now allow negative values

      Better late than never.

    • Fixed missing .smart-spacing utility class

      It wandered off. We found it and brought it back.

    • Fixed HSL inputs from clearing when deleting lightness value

      When you deleted the lightness value, the hue and saturation also disappeared. This isn’t the “automatic” we were going for, so we’ve patched it.

    • Fixed HSL inputs from changing when an adjacent input was edited

      When you edited an HSL value, the adjacent values would change randomly. While this created a fun little game of “Can You Actually Dial That Color In?!,” we ultimately decided that it wasn’t suitable for an efficient, professional workflow.