CHANGELOG_ARCHIVE.md
$mdc-checkbox-ui-pct sass variable from MDCCheckboxFoundation#handleInteraction has been split into two methods: #handleClick and #handleKeydown.$mdc-checkbox-ui-pct sass variable from MDCCheckboxFoundation#handleInteraction has been split into two methods: #handleClick and #handleKeydown.<a name="2.3.1"></a>
<a name="2.3.0"></a>
<a name="2.2.0"></a>
<a name="2.1.1"></a>
<a name="2.1.0"></a>
<a name="2.0.0"></a>
isRootFocused. MDC Menu: Replaced adapter methods isRootFocused, focusRoot with focusListRoot. When using MDC List inside MDC Menu tabindex should be set on list root element where role="menu" is assigned.listElements component API now includes disabled list items which previously returned only enabled list items.setDefaultFocusState()) to set default focus state (DefaultFocusState) that will be used to focus every time when menu is opened. Also introduced new foundation & adapter methods to incorporate this change. Please use setDefaultFocusItemIndex(DefaultFocusState.FIRST_ITEM) method before menu open to retain previous behaviour.$mdc-top-app-bar-prominent-dense-title-bottom-padding is renamed to $mdc-top-app-bar-dense-prominent-title-bottom-padding<a name="1.1.1"></a>
<a name="1.1.0"></a>
<a name="1.0.1"></a>
<a name="1.0.0"></a>
transformStyleProperties export (#4453) (aa44991), closes /github.com/material-components/material-components-web/pull/4407#discussion_r258668567-core-styles (#4404) (3102351)transformStyleProperties array export has been removed from mdc-animation. Please use getCorrectPropertyName(window, 'transform') instead.getMatchesProperty() has been removed from @material/ripple/util and @material/tab-scroller/util. Use matches() from @material/dom/ponyfill instead.mdc-foo to mdc-foo-core-styles. (Importing baseline styles via mdc-foo.scss remains unaffected.)MDCListAdapter#notifyAction implementation now emits an object of type {index: number} rather than a primitive number directly.MDCMenuSurfaceAdapter#setPosition now expects an object with properties of type number rather than string. E.g., setPosition({top: '5px', left: '10px'}) is now setPosition({top: 5, left: 10}).MDCListAdapter#removeAttributeForElementIndex<a name="0.44.1"></a>
<a name="0.44.0"></a>
mdc-text-field-helper-line element. Wrappers must account for the new character-counter sub-component. See the Text Field documentation for examples and more information.handleClick and handleSelection with handleItemAction to handle list item action (i.e., list's custom event MDCList:action)followHref and used native anchor element behaviour to follow href on <kbd>Enter</kbd> & click. Components that use MDC List should use its new custom event.hasLeadingIcon, getRootBoundingClientRect, and getCheckmarkBoundingClientRect. Also adds a new foundation method: getDimensions.<a name="0.43.1"></a>
<a name="0.43.0"></a>
!default (de6c833), closes #3708isFocusInsideList for MDC List for improved accessibility.mdc-button__label element. This does not immediately break existing MDC Button usage, but updating is recommended to future-proof against potential upcoming changes.MDCTabBar#getIndexOfTab(tab: MDCTab): number is now MDCTabBar#getIndexOfTabById(id: string): number<a name="0.42.1"></a>
<a name="0.42.0"></a>
MDCCheckboxFoundation#handleChange when the checked and indeterminate properties change.setCheckedCheckboxOrRadioAtIndex and added 3 more new adapter methods for improved accessibility.mdc-fab-shape-radius for regular / mini Fab variants & mdc-fab-extended-shape-radius for Extended FAB variant.<a name="0.41.1"></a>
<a name="0.41.0"></a>
@material/foo/index. @material/foo will now resolve to UMD modules.$mdc-shape-*-surface-radius to $mdc-shape-*-component-radius<a name="0.40.1"></a>
<a name="0.40.0"></a>
mdc-dom package with Element.matches() ponyfill (#3515) (91d8fe8), closes #3413 #1104<a name="0.39.3"></a>
<a name="0.39.1"></a>
<a name="0.39.0"></a>
--box variant. Changes the box-sizing to border-box.getActiveTabIndex adapter method renamed and setActiveTab adapter method added.computeIndicatorClientRect method from MDCTabFoundationisChecked and isDisabled methods from MDCSwitchFoundation. Please update any call to MDCSwitchFoundation.handleChange so it passes in the change event. And note that isNativeControlChecked and isNativeControlDisabled are no longer required methods in MDCSwitchAdaptersetValid no longer ignores native input validation. New API useNativeValidation is introduced to enable / disable native validation for custom validity.mdc-text-field--upgraded class has been removed. mdc-text-field__input position has changed by 2px to match spec. mdc-text-field--textarea width in IE and Edge now matches other browsers.MDCChip takes an id, no longer exposes its foundation, and has selected as a property. Custom event details require a chipId instead of chipFoundation. New methods added to MDCChipSetAdapter and MDCChipSetFoundation.isFocused.<a name="0.38.2"></a>
<a name="0.38.1"></a>
[@import](https://github.com/import) for theme mixins; add screenshot tests (#3285) (553438a)<a name="0.38.0"></a>
MDCChip/MDCChipSet registerEventHandler adapter methods were removed, and corresponding handlers were made public in MDCChipFoundation/MDCChipSetFoundation.<a name="0.37.1"></a>
<a name="0.37.0"></a>
<a name="0.36.1"></a>
<a name="0.36.0"></a>
<a name="0.35.2"></a>
<a name="0.35.1"></a>
<a name="0.35.0"></a>
<a name="0.34.1"></a>
<a name="0.34.0"></a>
npm run build (#2437) (21150c7), closes #2325mdc-typography--adjust-margin CSS class and the mdc-typography-adjust-margin Sass mixinmdc-theme--primary/secondary-light/dark CSS classes and the mdc-theme-light/dark-variant Sass functionsmdc-text-field-outlined-corner-radius to mdc-text-field-outline-corner-radius. Made updateSvgPath_() private in notched-outline foundation and replaced it
with notch(). Renamed updateOutline() in text-field foundation to notchOutline().setAttr adapter method has been removed and replaced by setStyle.<a name="0.33.0"></a>
var instead of const in menu demo (#2345) (ab85736)<a name="0.32.0"></a>
var instead of const in demos/ready.js (#2343) (78408bb)mdc-chip-set--choice variant (#2215) (f89cd10)mdc-chip--activated class, mdc-chip-activated-ink-color Sass mixin, and the toggleActive methods on MDCChip/MDCChipSet have been renamed to mdc-chip--selected, mdc-chip-selected-ink-color, and toggleSelected, respectively..mdc-floating-label selector instead of .mdc-text-field__labelmdc-chip-set--filter as a variant to be set in the HTML.<a name="0.31.0"></a>
<a name="0.30.0"></a>
--stroked variant and mdc-card-stroke mixin (#2035) (76e56cf), closes #1708mdc-theme-light-or-dark and mdc-theme-darkcontainsEventTarget(target) API to the ripple adapter.mdc-chip has been added.eventTargetHasClass from the adapter.$mdc-slider-dark-theme-assumed-bg-color from slider variables.mdc-checkbox__checkmark__path to mdc-checkbox__checkmark-path.$mdc-list-divider-color-light to $mdc-list-divider-color-on-light-bg, $mdc-list-divider-color-dark to $mdc-list-divider-color-on-dark-bg<a name="0.29.0"></a>
demoReady() function (#1919) (da34cc9)Move colors for the select into a new mixins file.
MDC_WRAP_CSS_IN_JS env var now defaults to false.This change:
getComputedStyle() on page load (e.g., ripple)getIdleOutlineStyleValue method previously implemented in the text field adapter. The functionality is exactly the same and requires only small changes to accessing the outline node.<a name="0.28.0"></a>
addClassToLabel and removeClassFromLabel from MDCTextFieldAdapter implementations.registerDocumentInteractionHandler and deregisterDocumentInteractionHandler APIs have been added to the ripple adapter.mdc-elevation-transition mixin has been removed, and the mdc-elevation-transition-rule function has been renamed to mdc-elevation-transition-value, which should be used instead.hasClass method on MDCTextFieldAdapter, and change getFloatingWidth method to getWidth on MDCTextFieldLabelFoundation.mdc-permanent-drawer CSS class to mdc-drawer--permanent, renamed mdc-temporary-drawer CSS class to mdc-drawer--temporary, and renamed mdc-persistent-drawer to mdc-drawer--persistent. Also renamed all subelement classes by removing the variant from the selectors. Example:mdc-persistent-drawer__drawer --> mdc-drawer__drawer
mdc-persistent-drawer__toolbar-spacer --> mdc-drawer__toolbar-spacer
mdc-temporary-drawer__header --> mdc-drawer__header
mdc-temporary-drawer__header-content --> mdc-drawer__header-content
mdc-permanent-drawer__content --> mdc-drawer__content
MDCTextFieldAdapter.getNativeInput() has changed. See the 'NativeInputType` typedef in the adapter.floatAbovedeactivateFocussetValiditystyleFloatstyleShakesetIconAttr, eventTargetHasClass and notifyIconAction from MDCTextFieldAdapter implementations.$mdc-theme-primary-tone and friends have been removed. We now use a private function instead.__start-detail has been renamed to __graphic, and __end-detail has been renamed to __meta. In addition, meta data tiles no longer have a default width/height (fixes #1644).Also:
--primary and --accent CSS modifier classes have been removed in favor of the new mixin.layout() and adapter methods getIdleOutlineStyleValue() and isRtl() were added to MDCTextField. Added a new subcomponent MDCTextFieldOutline, and adapter method getWidth() to MDCTextFieldLabel.<a name="0.27.0"></a>
mdc-list-item__text__secondary class was renamed to mdc-list-item__secondary-text to follow BEM conventions. See the BEM FAQ for more details.<a name="0.26.0"></a>
<a name="0.25.0"></a>
--accent (#1541) (31d9d7b), closes #1148--off (#1544) (28024e9), closes #1151mdc-linear-progres--accent modifier class has been removed. Use Sass color mixins instead.mdc-slider--off modifier class has been removed as it is being removed from the spec.<a name="0.24.0"></a>
<a name="0.23.0"></a>
mdc-toolbar__icon--menu to mdc-toolbar__menu-icon<a name="0.22.0"></a>
<a name="0.21.1"></a>
<a name="0.21.0"></a>
mdc-button--primary and mdc-button--accent modifier classes. For custom and theme button implementation, use button mixins instead. See demos.scss for details.<a name="0.20.0"></a>
mdc-theme-prop accepts literal color values (#1129) (e47f3e6)<a name="0.19.0"></a>
<a name="0.18.1"></a>
<a name="0.18.0"></a>
secondary theme prop instead of accent (#1156) (d3ff8fc)accent to secondary (#1116) (2314ad5)<a name="0.17.0"></a>
<a name="0.16.0"></a>
pointer for icon element (#974) (830259c)<a name="0.15.0"></a>
<a name="0.14.0"></a>
<a name="0.13.0"></a>
addBodyClass and removeBodyClass.This is for proper alignment both in nesting and removing the restriction that margin need to be at least half size of the padding.
mdc-layout-grid-margin-#{$size}, where valid sizes are desktop, tablet and phone. The old name mdc-layout-grid-margin and mdc-layout-grid-gutter is no longer available in the new version. Sass variables change from single numeric value to Sass map to accomendate margins and gutters for different screens as well. Visually, the default value of margins and gutters change from 16px to 24px on desktop, while remain the same on tablet and mobile.getFlexibleRowElementOffsetHeight has been renamed to getFirstRowElementOffsetHeight. Please update your code accordingly.<a name="0.12.1"></a>
<a name="0.12.0"></a>
<a name="0.11.1"></a>
<a name="0.11.0"></a>
<a name="0.10.0"></a>
<a name="0.9.1"></a>
<a name="0.9.0"></a>
aria-hidden="true" attribute.style="visibility:hidden" attribute for
correct first render.trapFocusOnSurface and untrapFocusOnSurface methods must be
implemented for the adapterhasClass, setAttr, registerFocusTrappingHandler,
deregisterFocusTrappingHandler, numFocusableTargets,
setDialogFocusFirstTarget, setInitialFocus,
getFocusableElements, saveElementTabState,
restoreElementTabState, makeElementUntabbable, setBodyAttr,
rmBodyAttr, getFocusedTarget, and setFocusedTarget have all been
removed from the adapter.applyPassive, saveElementTabState, and restoreElementTabState
have all been removed from mdcDialog.util.<a name="0.8.0"></a>
<a name="0.7.0"></a>
<a name="0.6.0"></a>
getValueForOptionAtIndex(index: string) => string
should return the "value" of the option at the given index. Please add
this method to your adapter implementations.getAccurateTime
method.<a name="0.5.0"></a>
<a name="0.4.0"></a>
<a name="0.3.0"></a>
numbers import from temporary drawer. (f77951e)registerInputInputHandler and registerInputKeydownHandler. To upgrade add these methods to your adapter.<a name="0.2.0"></a>
numbers import from temporary drawer. (f77951e)mdc-fab__iconexample:
<button class="mdc-fab material-icons">
<span class="mdc-fab__icon">
favorite_border
</span>
</button>