Material Components v55.4.0

« Changelog History

Material Components v55.4.0 Release Notes

• 📚 This minor release includes better layout guide and safe area insets support to MDCAppBar's MDCAppBarContainerViewController, added customization to MDCNavigationBar title view layout, accessibility improvements and documentation.

  🆕 New deprecations

  🚚 MDCNavigationBar's property useFlexibleTopBottomInsets has been defaulted to YES and has now been deprecated. It will eventually be removed and become the default behavior.

  🆕 New features

  AppBar now allows its wrapped content view controllers to make proper use of the top layout guide and additional safe area insets APIs. This is done using the newly added property to AppBar's MDCAppBarContainerViewController named topLayoutGuideAdjustmentEnabled. An example on how to implement this behavior:

  MDCAppBarContainerViewController *appBarContainerViewController;
  UITableViewController *tableViewController =
      [[UITableViewController alloc] initWithStyle:UITableViewStylePlain];
  appBarContainerViewController =
      [[MDCAppBarContainerViewController alloc] initWithContentViewController:tableViewController];
  self.appBarContainerViewController.topLayoutGuideAdjustmentEnabled = YES;
  

  🔧 NavigationBar now allows configuration of its title view layout behavior to be either "fill" or "center". The fill behavior is the default and existing behavior, which sets the title view's frame to fill the available navigation bar space. The center behavior will always attempt to center the title view within the navigation bar's bounds. 0️⃣ The center behavior is desired by teams in the simple cases of when they want their title view to be centered within the navigation bar as best as possible. This is also the default behavior of UINavigationBar. Example usage:

  MDCNavigationBar *navBar = [[MDCNavigationBar alloc] init];
  navBar.titleView = [[UIView alloc] init];
  navBar.titleViewLayoutBehavior = MDCNavigationBarTitleViewLayoutBehaviorCenter;
  

  API changes

  AppBar

  MDCAppBarContainerViewController

  🆕 new property: topLayoutGuideAdjustmentEnabled in MDCAppBarContainerViewController

  NavigationBar

  MDCNavigationBar

  🆕 new property: titleViewLayoutBehavior in MDCNavigationBar

  🗄 deprecated property: useFlexibleTopBottomInsets in MDCNavigationBar

  🗄 | Type of change: | Deprecation message | |---|---| | From: | useFlexibleTopBottomInsets | 0️⃣ | To: | Implement proper vertical alignment with the default YES behavior. |

  🆕 new enum MDCNavigationBarTitleViewLayoutBehavior with values MDCNavigationBarTitleViewLayoutBehaviorFill and MDCNavigationBarTitleViewLayoutBehaviorCenter.

  Component changes

  AppBar

  🔄 Changes

  • Add a wrapped table view controller example. (#4336) (featherless)
  • Add example of an AppBar in a presented vc (#4351) (John Detloff)
  • Fix VoiceOver escape gesture bug. (#4360) (featherless)
  • Implement topLayoutGuideAdjustmentEnabled on the app bar container. (#4370) (featherless)
  • 🗄 [NavigationBar] Deprecate useFlexibleTopBottomInsets (#4358) (Ali Rabbani)

  Buttons

  🔄 Changes

  • Adding Accessibility labels to README and fab example. (#4330) (Randall Li)

  TextFields

  🔄 Changes

  • Add placeholderLabel accessibilityLabel to textField accessibilityValue (#4319) (Andrew Overton)
  • Tweak accessibility notification to prevent VoiceOver from cutting off (#4364) (Andrew Overton)
  • 📚 [Documentation] Update TextField README.md (#4352) (ianegordon)

  Snackbar

  🔄 Changes

  • ✅ Fix Earl Grey test (#4349) (Robert Moore)

  Slider

  🔄 Changes

  • Fix accessibilityIncrement for discrete sliders (#4327) (John Detloff)
  • Notify VoiceOver of MDCSlider value changes (#4350) (Andrew Overton)

  NavigationBar

  🔄 Changes

  • Add a titleViewLayoutBehavior API. (#4371) (featherless)
  • 🗄 Deprecate useFlexibleTopBottomInsets (#4358) (Ali Rabbani)

  BottomSheet

  🔄 Changes

  • Add a short bottom sheet example to MDCCatalog (#4318) (featherless)

  Typography

  🔄 Changes

  • [TextFields] Prevents functionally equivalent fonts from causing rendering jumps (#4344) (Will Larche)

  PageControl

  🔄 Changes

  • Make MDCPageControl minimum height adhere to accessibility requirements (#4359) (Andrew Overton)

  Collections

  🔄 Changes

  • 🚚 Remove Earl Grey tests (#4348) (Robert Moore)

  HeaderStackView

  🔄 Changes

  • Change the layout behavior in MDCHeaderStack view to accommodate a topBar with flexible height. (#4355) (Ali Rabbani)

  FlexibleHeader

  🔄 Changes

  • Fix additionalSafeAreaInsets bug when topLayoutGuideAdjustmentEnabled is enabled. (#4354) (featherless)
  • Only extract the top layout guide if the view has loaded. (#4357) (featherless)

  ---

• All Versions
• Previous v55.3.0
• Next v55.5.0
• Latest Version