Changelog

v4.4.5

Bug Fixes

ItemContainer

• Fixed an issue causing us to get stuck in the pointer-down state.

v4.4.4

Bug Fixes

ItemContainer

• Fixed a null-ref exception.

v4.4.3

Bug Fixes

ListView

• Fixed a faulty PointerCancel event registration.

v4.4.1

Bug Fixes

General

• Added "print" and "share" icons.
• Fixed an issue where string concatenation was occurring instead of numeric addition.
• getRelativeLeft() now properly uses offsetParent instead of parentNode in its implementation.

AppBar

• AppBar no longer moves to the incorrect position when switching between software keyboards.

Flyout

• Flyout no longer tries to read _currentPosition before initialization.

FlipView

• FlipView now properly centers its content after touch manipulation - previously, users sometimes could not scroll all the way from the last item to the first item with a sufficient number of items.

ListView

• ListView no longer crashes the app when you refresh a page containing a ListView.

Pivot

• Adding a new PivotItem to a Pivot with zero items no longer attempts to operate on a null header.

SplitView

• SplitView no longer moves over the top toolbar on an open pane.

Tooltip

• Tooltips now work properly in CommandingSurface and Menu.

Xbox

• Users no longer have to press A and B twice to reveal and dismiss the software keyboard.

v4.4

Highlights

Improving Cross Browser responsiveness

• WinJS controls that need to be re-laid out when their root element changes size, can now do so automatically in all supported browsers instead of just IE and Edge.

ListView

• ListView now automatically responds to its element being resized in all supported browsers. Not just IE and Edge

FlipView

• FlipView now automatically responds to its element being resized in all supported browsers. Not just IE and Edge

Pivot

• Pivot now automatically responds to its element being resized in all supported browsers. Not just IE and Edge

Semantic Zoom

• Semantic Zoom now automatically responds to its element being resized in all supported browsers. Not just IE and Edge

ViewBox

• ViewBox now automatically responds to its element being resized in all supported browsers. Not just IE and Edge.
• ViewBox now only responds to size changes to its element. If any changes are made to the ViewBox internal elements via DOM operations, and should cause the ViewBox to re-layout any part of itself, developers will have to call ViewBox.forceLayout() to trigger the re-layout manually.

Hub

• Hub now automatically responds to its element being resized in all supported browsers. Not just IE and Edge.
• forceLayout API added to Hub, use to manually trigger re-layouts.
• Hub now only responds to size changes to its element. If any changes are made to the Hub internal elements directly via DOM operations, and should cause the Hub to re-layout any part of itself, developers will have to call Hub.forceLayout() to trigger the re-layout manually.

v4.3.1

Bug Fixes

General

• Added getNavManager helper to avoid errors when running in Windows 8 compat mode (#1479)

v4.3.0

Highlights

Accessibility Improvements

• Intrinsic controls are more accessible in high contrast mode
• AppBar/ToolBar are more accessible to narrator users
• Menu is more accessible to narrator users
• Pivot is more accessible in high contrast mode
• ToggleSwitch is more accessible in high contrast mode

TV/Xbox UI Controls

• We now build tv.js and ui-light-tv.css and ui-dark-tv.css, respectively. This file currently only contains the ScrollViewer control which is a scrolling container control, optimized for gamepad input modality.

Bug Fixes

General

• Fixed the detection logic for CommonJS (#1354)
• Fixed a crash when loading WinJS in a WebView (#1324)

AppBar/ToolBar

• Fixed an issue where narrator would excessively announce MenuCommands (#1381, #1400)

ListView

• Disabled ListView/ItemContainer pressed animations as the animations have been causing issues with invocation/selection near the edge of the control (#1319)

Pivot

• PivotItems measurements are now more accurate (#1356)
• Fixed an issue where the header focus visual would not display (#1383)

Rating

• Fixed an issue where using arrow keys to change the ratings would not work (#1365)

SplitView

• Fixed an issue with tabbing through and closing the SplitView (#1367)

XYFocus

• IFrames with just a focusable body are now focusable with XYFocus (#1339)
• Fixes an issue where preventDefault would not stop XYFocus from executing (#1378)

v4.2

New features

• Added the SplitViewCommand control (6113bbc)
• Added the VUI utility (adae969)

Deprecations

• Deprecated the NavBar, NavBarContainer and NavBarCommand controls (02266ee)

Notable changes

AppBar

• Fixed: Elements may be rendered on top of a closed AppBar (7fecf50, #1203)
• Fixed: Focuses wrong command when programmatically opened (46f7228, #1300)
• Fixed: Improve logic for displaying the overflow button (7cb5776, #982, #1170, #1340)
• Fixed: Tabbing should not move focus out of opened AppBar (2619e6f, #1073)
• Fixed: Toggling hidden property on Commands now properly animates (7b2da7a, #1055)

ContentDialog

• Fixed: Improve response to the InputPane (5a1dc55, #1149, #910)
• Fixed: Make the title a header (cf7098f, #1176)

Hub

• Fixed: Hub doesn't leave room for the app title (288cffc, #1224)
• Fixed: Mousewheel scrolling issue on Chrome (ca91896, #1273)

NavBar

• Fixed: Elements may be rendered on top of a closed NavBar (7fecf50, #1203)

Pivot

• Fixed: Header animation goes the wrong direction (63f6140, #1264)
• Fixed: selectionchanged event fired before the selectionIndex is updated (8973734, #1317)
• Fixed: Touch not being able to interact with custom headers (549b60f, #1263)

SplitView

• Fixed: Add public invoked event to SplitViewCommand (6f9f4f2)
• Fixed: Make SplitViewCommand work great when put inside a SplitView pane (05b83d9, #1258)
• Fixed: SplitViewCommand has the wrong background color (32fc70e, #1309)

Styling

• Fixed: Add a spacer element to the end of the overflow area to create 24px of space after the last menu command in AppBar and ToolBar (26bee7a)
• Fixed: Disabled submit buttons color (dda39e6, #1304)
• Fixed: Update SplitView for high contrast (9f942f0)
• Fixed: Update SplitViewPaneToggle for high contrast (cdc550a)

ToolBar

• Fixed: Focuses wrong command when programmatically opened (46f7228, #1300)
• Fixed: Improve logic for displaying the overflow button (7cb5776, #916, #982, #1170, #1210, #1340)
• Fixed: Tabbing should not move focus out of opened ToolBar (2619e6f, #1073)
• Fixed: Toggling hidden property on Commands now properly animates (7b2da7a, #1055)

Typography

• Fixed: Globalization fonts were missing from the intrinsics CSS (c95741c, #1282)

XYFocus

• Fixed: Exception when using XYFocus with no active elements (2bc9a40, #1311)
• Fixed: Exception thrown when an iframe is removed from the DOM before the XYFocus registration message is handled (0d4f090, #1312)
• Fixed: Input elements are automatically treated as toggle mode enabled (ddf9627)
• Fixed: Un-registering disposed iframes (702e625, #1291)
• Implemented a toggle mode (52a7b49)

v4.1

Deprecations

• Fixed: Added deprecation warning to createResultSuggestionImage API for SearchBox (2c6b4d0, #1268)

Notable changes

AppBar

• Fixed: Fails to overflow when closedDisplayMode === "none" (4000e32, #1183)
• Fixed: Initializing with closedDisplayMode: minimal will layout commands incorrectly (4000e32, #1220)

Core

• Fixed: Type-To-Search related crash when involving iframes (c2e5c92, #1131)

Flyout

• Added showAt API (d6a622a)
• Fixed: Click-eater blocks light dismissal until closed (14bc964, #1256)

Hub

• Fixed: Crashes when the header is an element with no classList API (7004d49, #1254)

ListView

• Disabled animations when ListView or ItemContainer are in selection mode (61d854d)

Menu

• Added showAt API (d6a622a)

Pivot

• Implemented new animations (1ed0d4a)

Styling

• Fixed: WinJS crashes when loaded in a display: none iframe on Firefox by defaulting to ui-light.css (a045428, #1253)
• Updated AppBar for high contrast (189d656)
• Updated ContentDialog for high contrast (e9cf1c6)
• Updated range control styling (a88502d)
• Updated ToggleSwitch styles (60522c1)
• Updated ToolBar for high contrast (189d656)

XYFocus

• Fixed: Crashes when loaded in a WebWorker (0b06c40, #1250)

v4.0.1

Core

• Fixed: Accent color sometimes not applied (d3c0820, #1202)

v4.0

New features

• Added the AutoSuggestBox control
• Added the ContentDialog control
• Added Pivot custom header areas
• Added the SplitView control
• Added the ToolBar control
• Added the XYFocus utility
• Added the ability to zebra stripe ListView items
• Added granular ListView virtualization options
• Added the SplitViewPaneToggle control
• Added a new ListView selection model

Breaking changes

Core

• (from 4.0-Preview) WinJS.js has been split back into base.js and ui.js

Styling

• Styling of intrinsic elements is no longer by default

Utilities

• The WinJS.Utilities.isPhone property will return undefined

AppBar

• Removed the disabled property
• Removed the hideCommands method
• Removed the layout property
• Removed the showCommands method
• Removed the sticky property. Set the closedDisplayMode property to compact or full to replicate similar behavior.
• Removed the .win-commandlayout CSS class
• Renamed the commands property to data
• Renamed the hidden property to opened
• Renamed the hide method to close
• Renamed the onafterhide event to onafterclose
• Renamed the onaftershow event to onafteropen
• Renamed the onbeforehide event to onbeforeclose
• Renamed the onbeforeshow event to onbeforeopen
• Renamed the show method to open
• Renamed the .win-appbar-hidden CSS class to .win-appbar-closed

NavBar

• Removed the disabled property
• Removed the layout property
• Removed the sticky property
• Renamed the onafterhide event to onafterclose
• Renamed the onaftershow event to onafteropen
• Renamed the onbeforehide event to onbeforeclose
• Renamed the onbeforeshow event to onbeforeopen
• Renamed the hide method to close
• Renamed the show method to open
• Renamed the hidden property to opened

SplitView

• (from 4.0-Preview) Renamed the HiddenDisplayMode enum to ClosedDisplayMode
• (from 4.0-Preview) Renamed the hiddenDisplayMode property to closedDisplayMode
• (from 4.0-Preview) Renamed the hidePane method to closePane
• (from 4.0-Preview) Renamed the onafterhide event to onafterclose
• (from 4.0-Preview) Renamed the onaftershow event to onafteropen
• (from 4.0-Preview) Renamed the onbeforehide event to onbeforeclose
• (from 4.0-Preview) Renamed the onbeforeshow event to onbeforeopen
• (from 4.0-Preview) Renamed the paneHidden property to paneOpened
• (from 4.0-Preview) Renamed the ShownDisplayMode enum to OpenedDisplayMode
• (from 4.0-Preview) Renamed the shownDisplayMode property to openedDisplayMode
• (from 4.0-Preview) Renamed the showPane method to openPane
• (from 4.0-Preview) Renamed the .win-splitview-pane-shown CSS class to .win-splitview-pane-opened
• (from 4.0-Preview) Renamed the .win-splitview-pane-hidden CSS class to .win-splitview-pane-closed

Typography

• Renamed the .win-type-xx-large class to .win-type-header or .win-h1
• Renamed the .win-type-x-large class to .win-type-subheader or .win-h2
• Renamed the .win-type-large class to .win-type-title or .win-h3
• Renamed the .win-type-medium class to .win-type-subtitle or .win-h4
• Renamed the .win-type-small class to .win-type-body or .win-h6
• Renamed the .win-type-x-small class to .win-type-base or .win-h5
• Renamed the .win-type-xx-small class to .win-type-caption

XYFocus

XYFocus is now enabled by default

• (from 4.0-Preview) Removed the enableXYFocus method
• (from 4.0-Preview) Removed the disableXYFocus method

Deprecations

• Deprecated the swipeBehavior property of ItemContainer and ListView
• Deprecated the SettingsFlyout control
• Deprecated the SearchBox control. Instead, use the AutoSuggestBox.
• Deprecated the values global and selection from the section property in AppBarCommand

Notable changes

Utilities

• Added the values NavigationView, NavigationMenu, NavigationUp, NavigationDown, NavigationLeft, NavigationRight, NavigationAccept, NavigationCancel, GamepadA, GamepadB, GamepadX, GamepadY, GamepadRightShoulder, GamepadLeftShoulder, GamepadLeftTrigger, GamepadRightTrigger, GamepadDPadUp, GamepadDPadDown, GamepadDPadLeft, GamepadDPadRight, GamepadMenu, GamepadView, GamepadLeftThumbstick, GamepadRightThumbstick, GamepadLeftThumbStickUp, GamepadLeftThumbstickDown, GamepadLeftThumbstickRight, GamepadLeftThumbstickLeft, GamepadRightThumbstickUp, GamepadRightThumbstickDown, GamepadRightThumbstickRight, GamepadRightThumbstickLeft to the Key enum

AppBar

• Added the ICommand interface
• Added the ClosedDisplayMode enum
• Added the Placement enum
• Added the forceLayout method
• Added the closedDisplayMode property

AppBarCommand

• Added the priority property
• Added the values primary and secondary to the section property

ListView

• Added the values item, header, and footer to the ObjectType enum
• Added the footer property
• Added the header property
• Added the maxLeadingPages property
• Added the maxTrailingPages property

Pivot

• Added the customLeftHeader property
• Added the customRightHeader property

SplitViewTogglePane

• Added the .win-splitviewpanetoggle class

Typography

• Added the .win-type-body class
• Added the .win-link class
• Added the .win-code class
• Added the .win-ellipsis class
• Added the .win-button class
• Added the .win-button-primary class
• Added the .win-button-file class
• Added the .win-textbox class
• Added the .win-textarea class
• Added the .win-dropdown class
• Added the .win-checkbox class
• Added the .win-radio class
• Added the .win-progress-bar class
• Added the .win-progress-ring class
• Added the .win-slider class
• Added the .win-vertical class

XYFocus

• Added the .win-xbox class