[TextControls] Add text area example (#9772)
This PR adds a text area example. I may refine some layout stuff before I start migrating people to use it. Gradient/top and bottom padding specifically.
Here's a gif:
Closes #9407.
diff --git a/components/TextControls/BUILD b/components/TextControls/BUILD
index d214552..0d863d1 100644
--- a/components/TextControls/BUILD
+++ b/components/TextControls/BUILD
@@ -146,8 +146,12 @@
name = "ObjcExamples",
deps = [
":BaseTextFields",
+ ":FilledTextAreas",
+ ":FilledTextAreasTheming",
":FilledTextFields",
":FilledTextFieldsTheming",
+ ":OutlinedTextAreas",
+ ":OutlinedTextAreasTheming",
":OutlinedTextFields",
":OutlinedTextFieldsTheming",
"//components/Buttons",
diff --git a/components/TextControls/examples/supplemental/MDCTextControlTextAreaConfiguratorExample.h b/components/TextControls/examples/supplemental/MDCTextControlTextAreaConfiguratorExample.h
new file mode 100644
index 0000000..db5350d
--- /dev/null
+++ b/components/TextControls/examples/supplemental/MDCTextControlTextAreaConfiguratorExample.h
@@ -0,0 +1,23 @@
+// Copyright 2020-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 "MDCTextControlConfiguratorExample.h"
+
+/** This view controller manages a child view controller that contains the actual example content.
+ * It overrides the child view controller's trait collection based off the user's behavior. */
+@interface MDCTextControlTextAreaConfiguratorExample : MDCTextControlConfiguratorExample
+
+@end
diff --git a/components/TextControls/examples/supplemental/MDCTextControlTextAreaConfiguratorExample.m b/components/TextControls/examples/supplemental/MDCTextControlTextAreaConfiguratorExample.m
new file mode 100644
index 0000000..0776794
--- /dev/null
+++ b/components/TextControls/examples/supplemental/MDCTextControlTextAreaConfiguratorExample.m
@@ -0,0 +1,53 @@
+// Copyright 2020-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 "MDCTextControlTextAreaConfiguratorExample.h"
+
+#import "MDCTextControlTextAreaContentViewController.h"
+
+static NSString *const kExampleTitle = @"MDCTextControl TextAreas";
+
+@implementation MDCTextControlTextAreaConfiguratorExample
+
+#pragma mark View Controller Lifecycle
+
+- (void)viewDidLoad {
+ [super viewDidLoad];
+
+ self.title = kExampleTitle;
+}
+
+#pragma mark Setup
+
+- (void)initializeContentViewController {
+ self.contentViewController = [[MDCTextControlTextAreaContentViewController alloc] init];
+}
+
+@end
+
+#pragma mark - CatalogByConvention
+
+@implementation MDCTextControlTextAreaConfiguratorExample (CatalogByConvention)
+
++ (NSDictionary *)catalogMetadata {
+ return @{
+ @"breadcrumbs" : @[ @"Text Controls", kExampleTitle ],
+ @"primaryDemo" : @NO,
+ @"presentable" : @NO,
+ };
+}
+
+@end
diff --git a/components/TextControls/examples/supplemental/MDCTextControlTextAreaContentViewController.h b/components/TextControls/examples/supplemental/MDCTextControlTextAreaContentViewController.h
new file mode 100644
index 0000000..a257896
--- /dev/null
+++ b/components/TextControls/examples/supplemental/MDCTextControlTextAreaContentViewController.h
@@ -0,0 +1,20 @@
+// Copyright 2020-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 "MDCTextControlContentViewController.h"
+
+@interface MDCTextControlTextAreaContentViewController : MDCTextControlContentViewController
+@end
diff --git a/components/TextControls/examples/supplemental/MDCTextControlTextAreaContentViewController.m b/components/TextControls/examples/supplemental/MDCTextControlTextAreaContentViewController.m
new file mode 100644
index 0000000..4ebbb7a
--- /dev/null
+++ b/components/TextControls/examples/supplemental/MDCTextControlTextAreaContentViewController.m
@@ -0,0 +1,186 @@
+// Copyright 2020-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 "MDCTextControlTextAreaContentViewController.h"
+
+#import "MaterialButtons.h"
+
+#import "MDCBaseTextArea.h"
+#import "MaterialButtons+Theming.h"
+#import "MaterialColorScheme.h"
+
+#import "MDCFilledTextArea+MaterialTheming.h"
+#import "MDCFilledTextArea.h"
+#import "MDCOutlinedTextArea+MaterialTheming.h"
+#import "MDCOutlinedTextArea.h"
+
+@interface MDCTextControlTextAreaContentViewController () <UITextViewDelegate>
+@end
+
+@implementation MDCTextControlTextAreaContentViewController
+
+#pragma mark Setup
+
+- (MDCFilledTextArea *)createMaterialFilledTextArea {
+ MDCFilledTextArea *textArea = [[MDCFilledTextArea alloc] init];
+ textArea.textView.delegate = self;
+ textArea.labelBehavior = MDCTextControlLabelBehaviorFloats;
+ textArea.label.text = @"Phone number";
+ textArea.leadingAssistiveLabel.text = @"This is a string.";
+ [textArea applyThemeWithScheme:self.containerScheme];
+ return textArea;
+}
+
+- (MDCOutlinedTextArea *)createMaterialOutlinedTextArea {
+ MDCOutlinedTextArea *textArea = [[MDCOutlinedTextArea alloc] init];
+ textArea.textView.delegate = self;
+ textArea.label.text = @"Phone number";
+ [textArea applyThemeWithScheme:self.containerScheme];
+ return textArea;
+}
+
+- (MDCBaseTextArea *)createDefaultBaseTextArea {
+ MDCBaseTextArea *textArea = [[MDCBaseTextArea alloc] init];
+ textArea.textView.delegate = self;
+ textArea.label.text = @"This is a floating label";
+ return textArea;
+}
+
+- (void)textViewDidChange:(UITextView *)textView {
+ [self.view setNeedsLayout];
+}
+
+#pragma mark Overrides
+
+- (void)initializeScrollViewSubviewsArray {
+ [super initializeScrollViewSubviewsArray];
+
+ NSArray *textAreaRelatedScrollViewSubviews = @[
+ [self createLabelWithText:@"MDCFilledTextArea:"],
+ [self createMaterialFilledTextArea],
+ [self createLabelWithText:@"MDCOutlinedTextArea:"],
+ [self createMaterialOutlinedTextArea],
+ [self createLabelWithText:@"MDCBaseTextArea:"],
+ [self createDefaultBaseTextArea],
+ ];
+ NSMutableArray *mutableScrollViewSubviews = [self.scrollViewSubviews mutableCopy];
+ self.scrollViewSubviews =
+ [mutableScrollViewSubviews arrayByAddingObjectsFromArray:textAreaRelatedScrollViewSubviews];
+}
+
+- (void)applyThemesToScrollViewSubviews {
+ [super applyThemesToScrollViewSubviews];
+
+ [self applyThemesToTextAreas];
+}
+
+- (void)resizeScrollViewSubviews {
+ [super resizeScrollViewSubviews];
+
+ [self resizeTextAreas];
+}
+
+- (void)enforcePreferredFonts {
+ [super enforcePreferredFonts];
+
+ if (@available(iOS 10.0, *)) {
+ [self.allTextAreas
+ enumerateObjectsUsingBlock:^(MDCBaseTextArea *textArea, NSUInteger idx, BOOL *stop) {
+ textArea.textView.adjustsFontForContentSizeCategory = YES;
+ textArea.textView.font = [UIFont preferredFontForTextStyle:UIFontTextStyleBody
+ compatibleWithTraitCollection:textArea.traitCollection];
+ textArea.leadingAssistiveLabel.font =
+ [UIFont preferredFontForTextStyle:UIFontTextStyleCaption2
+ compatibleWithTraitCollection:textArea.traitCollection];
+ textArea.trailingAssistiveLabel.font =
+ [UIFont preferredFontForTextStyle:UIFontTextStyleCaption2
+ compatibleWithTraitCollection:textArea.traitCollection];
+ }];
+ }
+}
+
+- (void)handleResignFirstResponderTapped {
+ [super handleResignFirstResponderTapped];
+
+ [self.allTextAreas
+ enumerateObjectsUsingBlock:^(MDCBaseTextArea *textArea, NSUInteger idx, BOOL *stop) {
+ [textArea.textView resignFirstResponder];
+ }];
+}
+
+- (void)handleDisableButtonTapped {
+ [super handleDisableButtonTapped];
+
+ [self.allTextAreas enumerateObjectsUsingBlock:^(MDCBaseTextArea *_Nonnull textArea,
+ NSUInteger idx, BOOL *_Nonnull stop) {
+ textArea.enabled = !self.isDisabled;
+ }];
+}
+
+#pragma mark Private helper methods
+
+- (void)resizeTextAreas {
+ CGFloat textAreaWidth = CGRectGetWidth(self.view.frame) - (2 * self.defaultPadding);
+ [self.allTextAreas
+ enumerateObjectsUsingBlock:^(MDCBaseTextArea *textArea, NSUInteger idx, BOOL *stop) {
+ CGFloat textAreaMinX = CGRectGetMinX(textArea.frame);
+ CGFloat textAreaMinY = CGRectGetMinY(textArea.frame);
+ CGFloat viewHeight = CGRectGetHeight(textArea.frame);
+ CGRect viewFrame = CGRectMake(textAreaMinX, textAreaMinY, textAreaWidth, viewHeight);
+ textArea.frame = viewFrame;
+ [textArea sizeToFit];
+ }];
+}
+
+- (void)applyThemesToTextAreas {
+ [self.allTextAreas
+ enumerateObjectsUsingBlock:^(MDCBaseTextArea *textArea, NSUInteger idx, BOOL *stop) {
+ BOOL isEven = idx % 2 == 0;
+ if (self.isErrored) {
+ if ([textArea isKindOfClass:[MDCFilledTextArea class]]) {
+ MDCFilledTextArea *filledTextArea = (MDCFilledTextArea *)textArea;
+ [filledTextArea applyErrorThemeWithScheme:self.containerScheme];
+ } else if ([textArea isKindOfClass:[MDCOutlinedTextArea class]]) {
+ MDCOutlinedTextArea *outlinedTextArea = (MDCOutlinedTextArea *)textArea;
+ [outlinedTextArea applyErrorThemeWithScheme:self.containerScheme];
+ }
+ if (isEven) {
+ textArea.leadingAssistiveLabel.text = @"Suspendisse quam elit, mattis sit amet justo "
+ @"vel, venenatis lobortis massa. Donec metus "
+ @"dolor.";
+ } else {
+ textArea.leadingAssistiveLabel.text = @"This is an error.";
+ }
+ } else {
+ if ([textArea isKindOfClass:[MDCFilledTextArea class]]) {
+ MDCFilledTextArea *filledTextArea = (MDCFilledTextArea *)textArea;
+ [filledTextArea applyThemeWithScheme:self.containerScheme];
+ } else if ([textArea isKindOfClass:[MDCOutlinedTextArea class]]) {
+ MDCOutlinedTextArea *outlinedTextArea = (MDCOutlinedTextArea *)textArea;
+ [outlinedTextArea applyThemeWithScheme:self.containerScheme];
+ }
+ if (isEven) {
+ textArea.leadingAssistiveLabel.text = @"This is helper text.";
+ } else {
+ textArea.leadingAssistiveLabel.text = nil;
+ }
+ }
+ }];
+}
+
+- (NSArray<MDCBaseTextArea *> *)allTextAreas {
+ return [self allScrollViewSubviewsOfClass:[MDCBaseTextArea class]];
+}
+
+@end
