Version:
Cohesiondx.com

Are you looking for the latest documentation?

Documentation for Acquia Cohesion V6.0 onwards has moved to https://cohesiondocs.acquia.com

    Stable version 5.3 release details

    Last updated: 17th December 2018 

    Overview

    This page is to detail the latest changes and updates regarding DX8 version 5.3 and to give you an overview of how this may affect your experience with the platform.

    This release contains a some new features such as a new HTML base style, experimental layout builder support and some enhanced security for components. The release also contains some bug fixes with component default content and the video element assets not loading.

    Known Issues

    The following are known issues within this version of DX8:

    • Tokenising icons within component field in style tab, the icon doesn't render 
    • A missing permission to limit access to Custom elements in the sidebar browser
    • Using a view item in a view template and updating the entity type, the bundle and view mode select lists are not updated based on the selected entity type.
    • Selecting transparency as color on an element can cause an error when saving multiple times. The current workaround for this is to edit the styles and re-select transparency in the color picker, you will then be able to save the node without the error.

    Highlights

    Here's what new features this release includes:

    HTML base style

    It is now possible to create an HTML base style.

    This is particularly useful for maintaining <body> scroll position when opening a fixed position menu or modal, where the <html> and <body> elements need to be given a fixed height of 100%.

    See https://labs.cohesiondx.com/projects/menu-page-scroll for a demo of this technique in action.

    Layout builder support - Experimental

    You can now enable a new sub module "DX8 layout builder" (cohesion_layout_builder) which will give some support when using DX8 with the core Drupal layout builder module. Note that the layout builder module is experimental, so this support module may break unexpectedly. Consider it experimental until the core layout builder comes out of experimental status.

    Support:

    • Content templates will render on the layout edit page (node/x/layout)
    • Custom block templates can be themed with DX8 (/admin/cohesion/templates/content_templates/block_content)
    • Tokens can be used in custom blocks.
    • New "Drupal -> Content" element available in the DX8 sidebar browser (this element prints the content variable of the current context which effectively hands rendering the content entity over to Drupal core).

    To use core layout builder with DX8, you will need to add the new "Content" element onto your content template in place of the usual fields that you would add if using the DX8 layout builder field to handle your content entity layouts.

    Enhanced security

    This version of DX8 provides some enhanced security, this means that within some component form fields you can now escape HTML, you can find out more about using this feature here.

    Button element

    There is now a button element available within the Interactive section of the sidebar browser.

    This shares the Back to top and Scroll to functionality of the link element and provides two additional modifier options:

    • Toggle modifier (as accessible popup - collapsed) = Adds attributes/values aria-haspop="true" and aria-expanded="false"
    • Toggle modifier (as accessible popup - expanded) = Adds attributes/values aria-haspop="true" and aria-expanded="true"

    These should be used instead of links for toggling visibility of mobile and other hidden navigation, e.g. search and language selector blocks.

    Find out more about the button element here.

    Bug fixes

    Here's what bug fixes this release includes:

    Fixed Video controls assets not loading

    Fixed a bug where the path in the .css to /assets/video/mejs-controls.svg was incorrect in generated css resulting in the video controls not showing for the video element.

    Component default content update

    When using components that have default values, the default value will be applied at the point that the component is added to the layout canvas.

    This means that later updates to default values will not propagate to components saved on nodes or in helpers etc.

    Adding new fields or removing fields from a component will propagate to existing components and any new default data associated with those new fields will be added to the node when it's next saved.

    Testing notes

    When upgrading to this version of DX8, we recommend that you upgrade on a development environment, before upgrading a production website. 
    These are some recommended things to test:

    • Video element if used, check your controls are displaying correctly
    • Check your components content is rendering as expected, especially if you have used HTML tags such as <strong> in an input or plain text area
    • Add a component which contains default content to the layout canvas and check your default content is rendering as expected.

    Upgrade

    It is recommended that you backup and upgrade your website on a development version before applying to a production website.
    You can upgrade your version of DX8 by following our upgrade guide

    Have you found a bug?

    If you have found a bug, raise a ticket with our Customer Success team on our help center and we will look into your issue.

    DX8 knowledge base icon

    Frequently asked questions

    Get instant answers to common questions. Available online 24/7.

    Find answers

    Raise a ticket icon

    Raise a support ticket

    To raise a ticket, sign into Acquia Cloud and select Help in the top menu.

    Raise support ticket

    Acquia

    Copyright © 2020 Acquia, Inc. All Rights Reserved. Drupal is a registered trademark of Dries Buytaert.