Theme 1.26 & SDK 1.12 (November '21 Release)

We are excited to announce our Answers Hitchhikers Theme 1.26 and Answers Search UI SDK 1.12!

Updates

With the new Answers Hitchhikers Theme 1.26 and Answers Search UI SDK 1.12, we’ve added new feedback buttons, WCAG support, bug fixes, and more.

You can find the full list of features and bug fixes below, with additional details available in their linked Community posts.

New Features:

  • Feedback Buttons on Theme Cards: You now have the ability to add thumbs up and thumbs down feedback buttons to all entity cards.
  • Send New Attributes with Analytics Events on Thumbs Up/Down: We’ve added entity ID (among others) to the attributes that we pass for any thumbs up / down clicks, so you can associate clicks with a specific entity (on both Direct Answers and regular cards).
  • SDK Support for Token and the Visitor: We have added support for passing a jwt in the authorization header and passing visitor information to analytics; more to come on these features with the release of Consumer Auth in our upcoming Winter Release!

Additional WCAG Support:

  • Pagination Controls Work with Keyboard Enter: Users can now hit ‘enter’ to activate controls when tabbing through pagination.
  • Navigation Incorporates aria-current: We have added aria-current="page" to the current tab since the link to the current page is indicated visually.
  • Updated Hover Color on Search Bar: The hover color of the search bar has been updated so that the clear button and search bar icon have clear focus states.
  • Improved Screen Reader Support for the Search Bar: We have added additional WCAG support to the search bar for screen readers to support autocomplete.
  • AutoComplete aria-live Label Present on Page Load: Screen readers will announce the number of results on page load, even with empty content.
  • AutoComplete Incorporates aria-activedescendant: as the user traverses autocomplete options, the id of the currently highlighted option is referenced by aria-activedescendant on the text field.

Bug Fixes:

Looking to upgrade to this version? It is very important to read the following section for instructions and upgrade considerations.

To learn more about how to do a theme upgrade, check out the Upgrading Your Experience Theme and SDK module.

Upgrade Call Outs

We recommend reading the details within each update item post to understand this theme’s upgrade considerations. Implications—namely re-forking certain files or cards, as well as adding a new variable—will only apply for the following updates:

Feedback Buttons on Theme Cards

If you forked your cards, you will need to re-fork them to get this functionality.

Also note the functionality is in a shared partial under themes/answers-hitchhiker-theme/cards/common-partials/thumbsfeedback.hbs. If you want to customize functionality for a specific card, re-fork the card and remove the reference to the shared partial in the handlebars file. Then copy the partial and paste it inline before customizing the code.

Pagination Controls Work with Keyboard Enter

If you wrote a custom pagination component, you will need to update it with the latest changes.

Navigation Incorporates aria-current

If you wrote a custom template for the navigation component, you will need to update it with the latest changes.

Updated Hover Color on Search Bar

If you want this update, you’ll need to set the --yxt-searchbar-button-background-color-hover variable in answers.scss to #e9e9e9 instead of white.

Improved Screen Reader Support for the Search Bar

If you wrote a custom template for the search bar component (or autocomplete or filtersearch), you’ll need to update it with the latest changes.

AutoComplete aria-live Label Present on Page Load

If you wrote a custom template for the search bar component (or autocomplete or filtersearch), you’ll need to update it with the latest changes.

AutoComplete Incorporates aria-activedescendant

If you wrote a custom template for the search bar component (or autocomplete or filtersearch) , you’ll need to update it with the latest changes.

Full Page Map on iFrame Integrations

If you forked the vertical full page map previously, you will need to re-fork to get this fix.

Add allow=microphone to iFrame JS

if you forked iframe-common.js, you’ll need to re-fork.

Resize Custom Submit Icons

If you added custom styling to the search bar icon or forked the theme’s static/scss/answers/legacy-aeb/lanswers-overrides.scss file, you may not get the fix. You will need to remove the custom styling so that it does not override the default styling.

Update Styling in More Tab

If you forked the scss/answers/theme.scss file, you may need to re-fork, or add this update, to get this fix.

Null Check for Direct Answers documentsearch-standard Card

If you forked formatters-internal.js, you should refresh the getUrlWithTextHighlight formatter to the latest version. EIther replace the formatter with the latest version in the theme formatter-internal.js file or re-fork the file and copy over your customizations.

Align Distance on Professional Location Cards

If you previously forked either the financial-professional-location or professional-location card, you’ll need to re-fork to get the fix.