Yarden Eitan f58c3451f5 adds a11y support for page control with next button example (#8932)
PageControlAnimationBlockExample has too-low contrast in the controls. It also does not disable the next button even when it has no effect.

Updated colors to have an accessible contrast ratio, and updated the state of the button to show correct interactivity (enabled/disabled)

Before:
![Simulator Screen Shot - iPhone 7 - 2019-11-15 at 12 12 34](https://user-images.githubusercontent.com/4066863/68961835-3cd5e000-07a1-11ea-99fd-83fd7a1e481b.png)


After:
![Simulator Screen Shot - iPhone 7 - 2019-11-15 at 11 40 59](https://user-images.githubusercontent.com/4066863/68959927-1ada5e80-079d-11ea-9b84-7e8d2cfe1ff7.png)


Closes #8904
2019-11-15 12:22:49 -05:00

187 lines
6.8 KiB
Objective-C

// Copyright 2015-present the Material Components for iOS authors. All Rights Reserved.
//
// Licensed under the Apache License, Version 2.0 (the "License");
// you may not use this file except in compliance with the License.
// You may obtain a copy of the License at
//
// http://www.apache.org/licenses/LICENSE-2.0
//
// Unless required by applicable law or agreed to in writing, software
// distributed under the License is distributed on an "AS IS" BASIS,
// WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
// See the License for the specific language governing permissions and
// limitations under the License.
#import <UIKit/UIKit.h>
#import "MaterialPageControl.h"
@interface PageControlButtonExample : UIViewController <UIScrollViewDelegate>
@end
@implementation PageControlButtonExample {
UIScrollView *_scrollView;
MDCPageControl *_pageControl;
UIButton *_nextButton;
NSArray *_pages;
}
- (void)viewDidLoad {
[super viewDidLoad];
CGFloat boundsWidth = CGRectGetWidth(self.view.bounds);
CGFloat boundsHeight = CGRectGetHeight(self.view.bounds);
NSArray *pageColors = @[
[UIColor colorWithWhite:(CGFloat)0.7 alpha:1], [UIColor colorWithWhite:(CGFloat)0.6 alpha:1],
[UIColor colorWithWhite:(CGFloat)0.5 alpha:1], [UIColor colorWithWhite:(CGFloat)0.4 alpha:1],
[UIColor colorWithWhite:(CGFloat)0.3 alpha:1]
];
// Scroll view configuration
_scrollView = [[UIScrollView alloc] initWithFrame:self.view.bounds];
_scrollView.autoresizingMask = UIViewAutoresizingFlexibleWidth | UIViewAutoresizingFlexibleHeight;
_scrollView.delegate = self;
_scrollView.pagingEnabled = YES;
_scrollView.contentSize = CGSizeMake(boundsWidth * pageColors.count, boundsHeight);
_scrollView.showsHorizontalScrollIndicator = NO;
[self.view addSubview:_scrollView];
NSMutableArray *pages = [NSMutableArray array];
// Add pages to scrollView.
for (NSUInteger i = 0; i < pageColors.count; i++) {
CGRect pageFrame = CGRectOffset(self.view.bounds, i * boundsWidth, 0);
UILabel *page = [[UILabel alloc] initWithFrame:pageFrame];
page.text = [NSString stringWithFormat:@"Page %lu", (unsigned long)(i + 1)];
page.font = [UIFont systemFontOfSize:50];
page.textColor = [UIColor colorWithWhite:0 alpha:(CGFloat)0.8];
page.textAlignment = NSTextAlignmentCenter;
page.backgroundColor = pageColors[i];
page.autoresizingMask =
UIViewAutoresizingFlexibleTopMargin | UIViewAutoresizingFlexibleBottomMargin;
[_scrollView addSubview:page];
[pages addObject:page];
}
_pages = [pages copy];
// Page control configuration.
_pageControl = [[MDCPageControl alloc] init];
_pageControl.numberOfPages = pageColors.count;
_pageControl.currentPageIndicatorTintColor = UIColor.whiteColor;
_pageControl.pageIndicatorTintColor = UIColor.lightGrayColor;
// We want the page control to span the bottom of the screen.
CGSize pageControlSize = [_pageControl sizeThatFits:self.view.bounds.size];
_pageControl.frame =
CGRectMake(0, boundsHeight - pageControlSize.height, boundsWidth, pageControlSize.height);
[_pageControl addTarget:self
action:@selector(didChangePage:)
forControlEvents:UIControlEventValueChanged];
_pageControl.autoresizingMask =
UIViewAutoresizingFlexibleTopMargin | UIViewAutoresizingFlexibleWidth;
[self.view addSubview:_pageControl];
_nextButton = [UIButton buttonWithType:UIButtonTypeCustom];
[_nextButton setTitle:@"Next Page" forState:UIControlStateNormal];
_nextButton.autoresizingMask =
UIViewAutoresizingFlexibleTopMargin | UIViewAutoresizingFlexibleLeftMargin;
[_nextButton addTarget:self
action:@selector(didTapButton:)
forControlEvents:UIControlEventTouchUpInside];
[_nextButton setTitleColor:UIColor.lightGrayColor forState:UIControlStateDisabled];
[self.view addSubview:_nextButton];
}
#pragma mark - Frame changes
- (void)viewWillLayoutSubviews {
[super viewWillLayoutSubviews];
NSInteger pageBeforeFrameChange = _pageControl.currentPage;
NSInteger pageCount = _pages.count;
CGFloat boundsWidth = CGRectGetWidth(self.view.bounds);
CGFloat boundsHeight = CGRectGetHeight(self.view.bounds);
for (NSInteger i = 0; i < pageCount; i++) {
UILabel *page = [_pages objectAtIndex:i];
page.frame = CGRectOffset(self.view.bounds, i * boundsWidth, 0);
}
_scrollView.contentSize = CGSizeMake(boundsWidth * pageCount, boundsHeight);
CGPoint offset = _scrollView.contentOffset;
offset.x = pageBeforeFrameChange * boundsWidth;
// This non-anmiated change of offset ensures we keep the same page
[_scrollView setContentOffset:offset animated:NO];
// We want the page control to span the bottom of the screen.
CGRect standardizedFrame = CGRectStandardize(self.view.frame);
[_pageControl sizeThatFits:standardizedFrame.size];
UIEdgeInsets edgeInsets = UIEdgeInsetsZero;
if (@available(iOS 11.0, *)) {
// Accommodate insets for iPhone X.
edgeInsets = self.view.safeAreaInsets;
}
CGFloat yOffset =
CGRectGetHeight(self.view.frame) - CGRectGetHeight(_pageControl.frame) - edgeInsets.bottom;
_pageControl.frame =
CGRectMake(0, yOffset, CGRectGetWidth(self.view.frame), CGRectGetHeight(_pageControl.frame));
[_nextButton sizeToFit];
CGFloat buttonCenterX =
boundsWidth - CGRectGetWidth(_nextButton.frame) / 2 - 16 - edgeInsets.right;
_nextButton.center = CGPointMake(buttonCenterX, _pageControl.center.y);
[self updateButtonState];
}
- (void)updateButtonState {
if (_pageControl.currentPage == _pageControl.numberOfPages - 1) {
_nextButton.enabled = NO;
} else {
_nextButton.enabled = YES;
}
}
#pragma mark - UIScrollViewDelegate
- (void)scrollViewDidScroll:(UIScrollView *)scrollView {
[_pageControl scrollViewDidScroll:scrollView];
}
- (void)scrollViewDidEndDecelerating:(UIScrollView *)scrollView {
[_pageControl scrollViewDidEndDecelerating:scrollView];
[self updateButtonState];
}
- (void)scrollViewDidEndScrollingAnimation:(UIScrollView *)scrollView {
[_pageControl scrollViewDidEndScrollingAnimation:scrollView];
}
#pragma mark - User events
- (void)didChangePage:(MDCPageControl *)sender {
CGPoint offset = _scrollView.contentOffset;
offset.x = sender.currentPage * _scrollView.bounds.size.width;
[_scrollView setContentOffset:offset animated:YES];
}
- (void)didTapButton:(id)sender {
NSUInteger nextPage = MIN(_pageControl.currentPage + 1, _pageControl.numberOfPages - 1);
CGPoint offset = _scrollView.contentOffset;
offset.x = nextPage * CGRectGetWidth(_scrollView.frame);
[_scrollView setContentOffset:offset animated:YES];
[_pageControl setCurrentPage:nextPage animated:YES];
[self updateButtonState];
}
#pragma mark - CatalogByConvention
+ (NSDictionary *)catalogMetadata {
return @{
@"breadcrumbs" : @[ @"Page Control", @"Page Control with Next Button" ],
@"primaryDemo" : @NO,
@"presentable" : @NO,
};
}
@end