|
| 1 | +# 94.5.0 |
| 2 | + |
| 3 | +This minor release introduces new APIs to AppBar, FlexibleHeader and Dialogs. AppBar and |
| 4 | +FlexibleHeader adds behavior to mimic the behavior of UINavigationController's |
| 5 | +`setNavigationBarHidden:`. Dialogs exposes transition APIs to customize the presentation animations. |
| 6 | +We also deprecated some themers for Chips and Buttons. |
| 7 | + |
| 8 | +## New deprecations |
| 9 | + |
| 10 | +### Chips |
| 11 | + |
| 12 | +####MDCChipViewColorThemer |
| 13 | + |
| 14 | +Use Chips+Theming to theme the ChipView instead. |
| 15 | + |
| 16 | +####MDCChipViewShapeThemer |
| 17 | + |
| 18 | +Use Chips+Theming to theme the ChipView instead. |
| 19 | + |
| 20 | +### Buttons |
| 21 | + |
| 22 | +#### MDCFloatingButtonColorThemer |
| 23 | + |
| 24 | +Please use [MDCFloatingButton applySecondaryThemeWithScheme:] instead. |
| 25 | + |
| 26 | +#### MDCContainedButtonColorThemer |
| 27 | + |
| 28 | +Please use [MDCButton applyContainedThemeWithScheme:] instead. |
| 29 | + |
| 30 | +## New features |
| 31 | + |
| 32 | +###AppBar |
| 33 | + |
| 34 | +The new `shouldSetNavigationBarHiddenHideAppBar` flag allows view controllers to control the |
| 35 | +visibility of their app bar via the standard UINavigationController setNavigationBarHidden: APIs |
| 36 | + |
| 37 | +```swift |
| 38 | + let contentViewController = PresentedViewController() |
| 39 | + let navigationController = MDCAppBarNavigationController() |
| 40 | + navigationController.shouldSetNavigationBarHiddenHideAppBar = true |
| 41 | + navigationController.delegate = self |
| 42 | + navigationController.pushViewController(contentViewController, animated: false) |
| 43 | +``` |
| 44 | + |
| 45 | +###FlexibleHeader |
| 46 | + |
| 47 | +This new shift behavior mode enables the flexible header to mimic the behavior of |
| 48 | +UINavigationController's `setNavigationBarHidden:`. |
| 49 | + |
| 50 | +#### Swift |
| 51 | + |
| 52 | +```swift |
| 53 | +headerViewController.headerView.shiftBehavior = .hideable |
| 54 | +// You can now toggle visibility of the header view using the following invocations: |
| 55 | +headerViewController.headerView.shiftHeaderOffScreen(animated: true) |
| 56 | +headerViewController.headerView.shiftHeaderOnScreen(animated: true) |
| 57 | +override func childViewControllerForStatusBarHidden() -> UIViewController? { |
| 58 | + return headerViewController |
| 59 | +} |
| 60 | +``` |
| 61 | + |
| 62 | +#### Objective-C |
| 63 | + |
| 64 | +```objc |
| 65 | +headerViewController.headerView.shiftBehavior = MDCFlexibleHeaderShiftBehaviorHideable; |
| 66 | +// You can now toggle visibility of the header view using the following invocations: |
| 67 | +[headerViewController.headerView shiftHeaderOffScreenAnimated:YES]; |
| 68 | +[headerViewController.headerView shiftHeaderOnScreenAnimated:YES]; |
| 69 | +- (UIViewController *)childViewControllerForStatusBarHidden { |
| 70 | + return _headerViewController; |
| 71 | +} |
| 72 | +``` |
| 73 | + |
| 74 | +## API changes |
| 75 | + |
| 76 | +### AppBar |
| 77 | + |
| 78 | +*new* property: `navigationBarHidden` in MDCAppBarNavigationController |
| 79 | +*new* property: `shouldSetNavigationBarHiddenHideAppBar; |
| 80 | + |
| 81 | +### Chips |
| 82 | + |
| 83 | +*deprecated* class: MDCChipViewColorThemer. Use Chips+Theming instead. |
| 84 | +*deprecated* class: MDCChipViewShapeThemer. Use Chips+Theming instead. |
| 85 | + |
| 86 | +### Dialogs |
| 87 | + |
| 88 | +*new* property: `dialogTransform` in MDCDialogPresentationController |
| 89 | + |
| 90 | +*new* property: `opacityAnimationDuration` in MDCDialogTransitionController |
| 91 | +*new* property: `scaleAnimationDuration` in MDCDialogTransitionController |
| 92 | +*new* property: `dialogInitialScaleFactor` in MDCDialogTransitionController |
| 93 | + |
| 94 | +### Flexible header |
| 95 | + |
| 96 | +*new* enum value: `MDCFlexibleHeaderShiftBehaviorHideable` in MDCFlexibleHeaderShiftBehavior |
| 97 | + |
| 98 | +### Ripple |
| 99 | + |
| 100 | +*new* property: `usesSuperviewShadowLayerAsMask` in MDCRippleView |
| 101 | + |
| 102 | +## Component changes |
| 103 | + |
| 104 | +## Changes |
| 105 | + |
| 106 | +### ActionSheet |
| 107 | + |
| 108 | +* [Refactor edge insets API snapshot tests. (#9035)](https://github.com/material-components/material-components-ios/commit/c87d65330f840a57ede6aaef03a08bddbb118238) (Robert Moore) |
| 109 | + |
| 110 | +### AppBar |
| 111 | + |
| 112 | +* [Add a shouldSetNavigationBarHiddenHideAppBar behavior flag. (#9001)](https://github.com/material-components/material-components-ios/commit/ae532421091d416476fdc39b9dc7ff0be6bd973c) (featherless) |
| 113 | +* [Rename test cases to match component conventions. (#9038)](https://github.com/material-components/material-components-ios/commit/d0322ef8c2eb2bbf967b9afda77dd9fb76800663) (featherless) |
| 114 | + |
| 115 | +### Banner |
| 116 | + |
| 117 | +* [Fix top layout constraint in Autolayout example on pre iOS 11 OSes. (#9042)](https://github.com/material-components/material-components-ios/commit/5e98e17c9767c4c0a395c1524618a599af3626bd) (Wenyu Zhang) |
| 118 | + |
| 119 | +### Buttons |
| 120 | + |
| 121 | +* [Deprecating MDCContainedButtonColorThemer (#9051)](https://github.com/material-components/material-components-ios/commit/0ff791396ea53caf817ffe42bfd0509d147b754f) (Galia Kaufman) |
| 122 | +* [Deprecating MDCFloatingButtonColorThemer (#9050)](https://github.com/material-components/material-components-ios/commit/75e616f915f0f8c6e5213a0d7514de841d45a136) (Galia Kaufman) |
| 123 | + |
| 124 | +### Chips |
| 125 | + |
| 126 | +* [Mark MDCChipViewColorThemer and MDCChipViewShapeThemer as deprecated (#9040)](https://github.com/material-components/material-components-ios/commit/c360df15878ab0b510dcfc634217650bd11e538b) (Bryan Oltman) |
| 127 | + |
| 128 | +### Dialogs |
| 129 | + |
| 130 | +* [Add configuration options to MDCDialogTransitionController (#9033)](https://github.com/material-components/material-components-ios/commit/0aba80cfdfda07f8d79aa7c115cd0ba55812034d) (Bryan Oltman) |
| 131 | + |
| 132 | +### FlexibleHeader |
| 133 | + |
| 134 | +* [Add MDCFlexibleHeaderShiftBehaviorHideable. (#9026)](https://github.com/material-components/material-components-ios/commit/a24c11f7fc637252c50334fa89fb081a77752137) (featherless) |
| 135 | +* [Add test that validates all defaults. (#9036)](https://github.com/material-components/material-components-ios/commit/337af58b066ca1868d1f0dfc44afd9a692265d12) (featherless) |
| 136 | +* [Document the default value of shiftBehavior. (#9037)](https://github.com/material-components/material-components-ios/commit/10c2b1205e13fca4e25ec0b6aba0fb83c9465a80) (featherless) |
| 137 | + |
| 138 | +### Ripple |
| 139 | + |
| 140 | +* [Add usesSuperviewShadowLayerAsMask flag. (#8822)](https://github.com/material-components/material-components-ios/commit/9d60c22e29802d2a5e5df6433aa26287e5c75a83) (featherless) |
| 141 | + |
| 142 | +--- |
| 143 | + |
1 | 144 | # 94.4.0 |
2 | 145 |
|
3 | 146 | This minor release introduces new APIs to ActionSheet, BottomSheet and FlexibleHeader. Additionally, it includes new theming extensions for TextControls component. |
|
0 commit comments