Version History

The style guide is versioned and adheres to semantic versioning in the format major.minor.patch.

  • Major release: Includes changes to specifications that are incompatible with existing specifications.
  • Minor release: Adds new specifications that are backwards-compatible.
  • Patch release: Includes bug fixes and/or minor specification clarifications.
    1.2.4

    September 20, 2022

    • Added/Modified an introduction phrase at the top of demos (Matching).
    • Added draggable text object demo (Matching).
    • Added color-swatch samples next to color and hue codes as in this example for Equation Editor (Equation Editor).
    • Added Icon image samples next to icon descriptions as in this example for Multimedia controls (Multimedia Controls).
    • Added/Modified an introduction phrase at the top of demos as in this example for Intro & Exit Screen (Intro & Exit Screens).
    • Moved the demo full-size phrase below the demos as in this examples for Matching (Matching).
    • Added a Change Theme and Read Aloud explanation under the demos as in this example Typography (Typography).
    • Added Hover over Messages on Change Theme/TTS icons at the top right corner of the page.
    • Aligned and centered left and right directional pad arrows. (Directional Pads).
    • Added an example for Content-based Screens. (Intro & Exit Screens).
    • Dialog button title is changed from Launch to View Dialog at Dialogs (Dialogs).
    • Standardized the use of the asterisk throughout the guide.
    • Standardized phrasing and provided clarity throughout the guide.
    • Missing Scroll up/down buttons were updated at the Scrollbar section at Navigation. (Navigation).
    1.2.3

    July 9, 2021

    • Replaced Overview landing page with a redirect to the Introduction section (Introduction).
    • Added new copy for Introduction section conflating information with previous Overview landing page (Introduction).
    • Removed Media and Item Development tabs.
    • Removed Multi-media Variant from the Response Types: Select-in-stimulus section (Select-in-stimulus).
    • Added blue asterisk icon to Numeric Entry indicating SBT-specific style in the Response Types: Text Entry section (Text Entry).
    1.2.2

    June 20, 2019

    • Added a table of contents page for viewing all UX pages.
    • Overhaul of style guide left-navigation.
    • Improved the visibility of page location by clearly displaying the selected primary and sub navigation related to each page within the browser’s viewport.
    1.2.1

    August 16, 2018

    • Matching item sources now reappear in the source tray when replaced in single-use drop targets (Matching).
    • Text-to-speech behavior for IICs now more explicitly specified (Text-to-speech).
    • Dialogs now resize on zoom (Dialogs).
    • Text-to-speech no longer remains active when navigating to a new item in the zoom demo (Zoom).
    • Writing editor context menu no longer resizes on zoom (Writing Editor).
    • Writing area now vertically resizes as content is added (Writing Editor).
    • Figure transformation sources now have disabled states (Figure Transformation).
    • Images in zones demo no longer theme (Zones).
    • Various minor keyboard navigation fixes.
    • Various minor edits throughout the guide.
    1.2.0

    August 5, 2018

    • Added figure transformation and shape builder response types (Figure Transformation, Shape Builder).
    • Added circular variant to fraction model response type (Fraction Model).
    • Added pre-populated bars to bar graph response type (Bar Graph).
    • Fixed cursor for radio buttons and checkboxes in disabled state (Checkboxes & Radios).
    • Fixed system toolbar button color in disabled state in dark theme (System Toolbar).
    • Various minor edits throughout the guide.
    1.1.1

    June 29, 2018

    • Moved specifications for information flags to their own page (Information Flags).
    • Moved specifications for directional pads to their own page (Directional Pads).
    • Various minor edits throughout the guide to ensure consistent introductions for all elements.
    1.1.0

    June 26, 2018

    1.1.0-pre

    June 17, 2018

    1.0.1

    May 31, 2018

    1.0.0

    May 22, 2018

    • Made slider track colors contrast conformant (Slider).
    • Converted select-in-passage page to select-in-stimulus to account for multimedia selections (Select-in-stimulus).
    • Updated character dialogue TTS behavior to match that of other text in system (Characters & Dialogue).
    • Updated Equation Editor keyboard behavior and visual state for EE-active text fields (Equation Editor).
    • Made scroll indicator keyboard navigable (Indicators).
    • Reverted grades 4 and 8 equation editors to versions used in prior administrations (Equation Editor).
    • Added specifications for interaction between Numeric Entry item type and Equation Editor (Equation Editor).
    • Added Cognitive Numeric Entry Validation dialog demo (Dialogs).
    • Made editorial corrections across the guide.
    1.0.0-pre

    May 1, 2018

    • Removed color palettes from Colors page until a normative color palette is created (Colors).
    • Added timing specs to inline-choice dropdown TTS behavior (Text-to-speech).
    • Updated touch target size specifications to match WCAG 2.1 (Touch Targets).
    • Updated button styling to establish a consistent semantic schema (Buttons, Look-back Buttons, Navigation, Short-text Pop-ups, Characters & Dialogue, Dialogs, Calls to Action).
    • Revised SBT task character voiceover button size and styling to better align with the global button schema and improve accessibility (Characters & Dialogue).
    • Revised SBT task character voiceover interaction with text-to-speech to improve accessibility (Characters & Dialogue).
    • Added specifications for Numeric Entry validation in cognitive subjects (Text Entry).
    • Updated height specification for Numeric Entry fields (Text Entry).
    • Updated system toolbar Back and Next buttons to increase salience (System Toolbar).
    • Updated Equation Editor styling, layout, and behavior to improve usability and accessibility (Equation Editor).
    • Updated text entry field focus and disabled states to improve differentiation (Text Entry).
    • Updated review screen icons and layout to improve accessibility and informational hierarchy (Review Screen).
    • Added warning icon to End-of-section and SBT-submit-confirmation dialogs (Dialogs).
    • Added End of Assessment dialog demo (Dialogs).
    • Added specifications for SBT Submit Confirmation dialog content (Dialogs).
    • Updated option column width specification for the grid response type (Grid).
    • Added wizards in new instructional section (Wizards).
    • Increased calculator size to comply with WCAG 2.1 minimum target size (Calculators).
    • Added demo with tiles to zones response type page (Zones).
    • Added image-based and two-column variants of the multiple-choice response type (Multiple-choice).
    • Changed scrollbar size to match eNAEP’s scrollbars (Navigation).
    • Browser spell check, auto-correct, auto-capitalize, and auto-complete are now disallowed in text entry fields (Text Entry).
    • Hover states no longer remain visible after a touch event.
    0.2.1

    March 19, 2018

    • Added SBT Submit Confirmation dialog to dialogs page (Dialogs).
    • SBT Submit Confirmation dialog width now correct (Dialogs).
    • Backgrounds of intro and exit screen content containers now theme correctly (Intro & Exit Screens).
    0.2.0

    March 2, 2018

    • Added prohibited and info icons to icon set (Icons).
    • Intro and exit screen content containers are now fully opaque (Intro & Exit Screens).
    • Corrected spec for ruler IIC border color (Ruler).
    • Backgrounds of text-based select-in-stimulus selections no longer change color in the beige theme (Select-in-stimulus).
    • Close buttons for text-based select-in-stimulus selections are now contrast compliant in the dark theme (Select-in-stimulus).
    • Calls-to-action for the Next button are now focusable (Calls to Action).
    0.1.3

    January 20, 2018

    • Updated color contrast specifications based on changes to WCAG 2.1 SC 1.4.11 (Colors).
    • Updated button colors in ruler demo based on latest specifications (Ruler).
    • Added link to WAI-ARIA 1.1 on keyboard navigability page (Keyboard Navigability).
    0.1.2

    January 15, 2018

    • Changed versioning from global to section-specific.
    • Added links to UX version history page.
    0.1.1

    January 7, 2018

    • Improved alignment of alert message icon for >2 lines of text (Alert Messages).
    • Added context menu specs and demo to writing editor page (Writing Editor).
    • Added inverted variant to calls-to-action page (Calls to Action).
    0.1.0

    December 18, 2017

    • Initial version.
    • UX section drafted, except for interactive item components.