v4.1

This minor release covers 3 pull requests.

Bugs fixed

• Improve style and URL matching logic for filtered listings #603

New feature

• Added indigenous acknowledgement to global footer #604

v4.0.1

This patch release covers 3 issues and 5 pull requests.

Bugs fixed

• Ordered sublists inside accordion have wrong numbering #596 #556
• Cross-browser issues in search bar (focus, colours, spacing, etc.) #591 #589
• Breadcrumb home icon gets duplicated when combining v4.0 injection with v3.5.2 (and below) components #595

Other changes

• Animate new search bar on open #594 #592

v4.0

This major release covers 4 issues and 22 pull requests. Before you upgrade, please take note of the following breaking changes, which may affect your site:

Breaking changes!

• ✨ The Filtered Listing component has been significantly refactored. Check out the full list of breaking changes and make sure you understand the updated documentation and code samples.

• #️⃣ The JavaScript class-manipulation helpers hasClass, addClass, removeClass and toggleClass have been removed in favour of the Element.classList property (which returns a DOMTokenList). All references in the design system have been replaced, and a polyfill has been added for IE support #566 #560. If your site contains custom code that makes use of the old functions, update it as follows:

  // BEFORE
  if (elem.hasClass('foo')) {...}
  elem.addClass('foo');
  elem.addClass('foo bar');
  elem.removeClass('foo');
  elem.toggleClass('foo');
  elem.toggleClass('foo', true);
  
  // AFTER
  if (elem.classList.contains('foo')) {...}
  elem.classList.add('foo');
  elem.classList.add('foo', 'bar'); // specify each class as a separate parameter
  elem.classList.remove('foo'); // also accepts multiple classes
  elem.classList.toggle('foo'); // accepts only one class
  elem.classList.toggle('foo', true);

• Search forms are now implemented as inline forms. The search-button class has been removed. #565 #330

New features

• Add Tealium script to injection #573

Bug fixes

• Mobile tables not centred #569
• Regression in staff listing tables on mobile #572
• Modal dialog gets visually cropped at the top when content is taller than viewport #577 #571
• Janky scrolling in Firefox 45 when jump-nav is active #578 #574

Other changes

• ✨ New in-header search box! The search button now opens a search box at the top instead of the unimelb sitemap panel. #562
• Update and fix documentation site in preparation for new app, which will bring editable, syntax-highlighted examples and other general improvements #572 #570

v3.9

This minor release covers 2 pull requests.

New feature

• #️⃣ Allow Staff Hub announcements to be re-bound after page load with window.UOMbind('announcement');

Other changes

• Document use of custom icons and hidden labels #537

v3.8.1

This patch release covers 4 issues and 13 pull requests.

Bugs fixed

• Misalignment in search results when person has no contact details #539
• Regression in #509: significant misalignment of breadcrumb icons when no custom breadcrumbs are defined (i.e. when default breadcrumbs are injected) #540
• When pre-selecting a filtered listing section via the URL (?section=<section-name>), the corresponding option in the drop-down menu is not pre-selected #541
• Page jumps instead of scrolling smoothly when clicking on navigational tab in Firefox #553 #554
• Poor accessibility of tabs (cropped focus outline, hidden horizontal scrollbar when focused, no focus outline on arrows, order of DOM elements inconsistent with visual order) #553
• Side effects when clicking on tab: default anchor click handler invoked and default click action performed #553 #551
• Inconsistent semi-transparent gradient background on tabs' arrows in Safari #555 #552
• Box-shadow in blurred header is not smooth on Firefox and Safari #543 #542
• Regression in 0fc088e: Missing shadow under injected header on mobile #544
• Legacy background colour on elements with class half #545
• Faulty style displaying ol with bullet points inside an accordion component #557

Other changes

• Add GitHub issue template with clear headings and instructions #549
• Reduce reliance on Compass for handling vendor-prefixed CSS #538

v3.8

This minor release covers 12 issues and 18 pull requests.

New features

• ✨ Horizontal scrolling in tabs has landed!! The tabs now remain on a single row whether or not the screen/browser is wide enough to accommodate them; mobile users are no longer subjected to an unusable drop-down menu. Although there's technically no longer a limit to the number of tabs you can have and to their individual lengths, keep in mind that the same usability guidelines apply. We invite you to read them again. Note that you may tidy up your markup a little by removing class desktop-nav from the nav element, and by getting rid of the entire mobile-nav element if present. #477 #439
• ✨ Flash message: new component similar to notices, but displayed at the top of the page, which is useful for showing the result of form submissions (for more demos, check out the headerless, search and staff list layouts) #518 #529
• ✨ The open/close animation of the main menu has been fully refactored to improve performance and fix a few bugs - it is now much smoother, especially on mobile devices, and flies over the page instead of pushing it #516 #438 #440 #517
• Add multiple pins to a map (both Google Maps and OpenStreetMaps) by specifying pairs of coordinates separated by pipes | in the data-pin attribute - e.g. data-pin="-37.798535, 144.960605|-37.798048, 144.960946" #525 #524
• Sections can now be closed in single-block-open accordions #535 #532
• #️⃣ The smoothScrollTo function used by the jumpnav now accepts a callback function as second argument: window.smoothScrollTo(element, cb) (useful to avoid running resource-heavy code, like DOM manipulations and Ajax requests, while the page is scrolling) #510

Bugs fixed

• Search results overflow on mobile when URLs are too long #512 #437
• OpenStreetMap mixed content error (trying to load scripts from unsecure servers from a secure page) #514
• In-page tabs can be selected via URL hash, and change URL hash when selected (both incorrect behaviours, as they are not meant to be used for navigation) #527 #523
• When reloading while in the middle of a page, header doesn't receive class fixed until the user starts scrolling #511
• Accordion sections cannot be opened by clicking the plus/cross icon #534 #522
• Long accordion sections force footer to expand when hidden #534 #531
• Two-column layout of jumpnav on mobile is hard to read and does not order items logically (left to right instead of top to bottom) #513 #502
• Page scrolls to the top when opening the main menu #440
• Sub-menus in local navigation do not fully cover their parent (when the parent's content is taller than the viewport) #517
• Slight misalignment of breadcrumb with icon #509
• Slight misalignment of sidebar and heading in news components (e.g. Staff News layout) #507
• Photoswipe library loaded more than once on a page with multiple galleries #519
• Icons with hidden labels don't appear at all on IE8 #521

v3.7.1

This patch release covers 6 pull requests.

Bug fixes

• Fix old browsers not hiding elements with the hidden attribute.
• Fix outline issue in Chrome for buttons containing an icon with a hidden label.
• Stop immediate propagation of form submission event when validation fails.
• Fix fixed class conflict between page-header and typography module (fixed-width font).
• Fix alignment of icons in footer on mobile.

v3.7

This minor release covers 3 issues and 12 pull requests.

New features

• Profile header component and layout for People Search.
• Finalise search results component (lock icon for secure results, images floated against title, etc.), introduce new person result format for People Search, and update search layout.
• Staff news layout.

Bug fixes

• Fix spacing issues in header-less layout (h1.aligned-title + section.lead.left).
• Inject the jumpnav after div.headerless so that the blue bar always appears above the jumpnav on mobile and tablet.
• Fix single news component when used with-aside (see new staff news layout).
• Compatibility fix for new search appliance (use q param on both search systems).
• On the Editorial guidelines page, point to the new university style guide located on the Staff Hub

v3.6

This minor release covers 2 issues and 10 pull requests.

What's new

• Adds basic self-awareness to JavaScript-driven components: any call to bind events on accordion, modal, inpage-navigation and icons checks to see if events are bound already. This allows developers to rerun event bindings if the page content is updated dynamically via JS or Ajax, and add or rebind events as necessary. A globally scoped helper for this, window.UOMbind() can be used to rebind a component, e.g. UOMbind('accordion');.
• Added new smartphone icon.
• Jumpnav can now be locked to the table of contents mode, as seen on smaller screen widths.
• Documentation for new h1 style: aligned-title.
• Fixes to h1 alignment when composed with certain elements.
• Fixes to single-page event style, and reinstatement of the corresponding example layout.
• Fix on styled select regression to staff hub component.

v3.5.2

This patch release solves a critical issue with the local and global navigation menus on sites powered by Turbolinks (like Pursuit).

Since version 3.5, the state of the menus is controlled with the HTML5 History API. Unfortunately, this same API is used by Turbolinks to provide seamless navigation between pages. This release introduces a fix that allows both features to work alongside each other.