Display an image with overlying text.
This component is still being developed and this documentation will be revised as the component is finalized. The settings may change without notice. If you do use it, please send us feedback!
Currently you will need to enable Experimental Components on your site to try it out.
Last reviewed: January 19, 2023
Enhance your home page with a visually bold header that can even become the primary (H1) heading. This component was developed to be used in a full-width 'hero' size but flexes to accommodate other settings. It combines rich text and imagery that is accessible and readily adjusts to small screen sizes. A variety of image and text styling features are supported, as well as borders, different alignments and other treatments. It can also host several Buttons to provide additional navigation.
Because this is intended for top-level placement, high quality imagery and language are needed that align with your strategic messaging and our UB brand, supported by regular evaluation and assessment.
The wrench 'Configure' icon provides access to add/clear the image and change settings in the four tabs: Layout, Text, Colors and Image (includes Alt text).
* If you select Hero or Super Hero, and additional button option appears.
Remember small screen devices when you write your Headline and Subheading. Your text will wrap and the font size will shrink to help fit the text--long headings may not display comfortably.
Only JPG, GIF and PNG formats are allowed. JPGs are recommended for best results and faster load times.
The UBCMS optimizes images for best display on the user's device, but we recommend:
The tool approximates how your original image will be cropped for desktop, mobile and teaser (thumbnail) views, allowing adjustments to better represent your desired focus in these contexts.
The interface responds to the main Image Size setting. Set the Image Size, then drag the Adaptive Crop cross-hairs to the center of your desired focus, and adjust the three sliders as desired to highlight the three zones.
The interface approximates the final displays. After you make your adjustments, we suggest you preview the results (e.g. using the mobile device emulator). And if you realize the List thumbnail is not working out as desired, consider also loading an image into page Properties that is cropped exactly as desired, where it will be used preferentially for teasers.
Alternative text ('Alt text') is a best practice for all your UBCMS images and is often required for accessibility.
Purely decorative images can be flagged "This image does not require Alt text" (when available), which nullifies any Alt text that was already entered, and some components (e.g. Photo) supports a nested Caption which can serve in place of Alt text, with these exceptions:
Alternative text ('alt text') is a short, written description that describes the appearance, content and/or function of an image on a webpage. Adding alt text is a best practice for all your UBCMS images and is required for accessibility so users will understand what they are not seeing.
Purely decorative images (that do not convey content or have a function on the page) can instead be set as "This image does not require Alt text" in some components, which also nullifies alt text that was previously entered.
Alt text is required in these contexts:
* When the image is a link, starts an animation or video, or is a navigational element, alt text should indicate its function, not the image's content (i.e., "watch video ABC" and not "screenshot from video ABC"). Screen readers will treat this image as a standard link.
Alt text can be added to images in Assets. This is required for images that are then used in the Photo Gallery component, while it can also be used as an alternate source for Alt text in some components (e.g. the Photo setting 'Get Alt text from Assets').
Best practice:
Text Over Photo provides an accessible alternative to using images that have embedded text.
> Learn more about the Text Over Photo component.