[TextFields] Deprecate MDCTextField and its associated classes/protocols

andrewoverton · material-automation · commit a29eb2c3c740 · 2021-03-02T09:48:45.000-08:00
PiperOrigin-RevId: 360449716
diff --git a/components/TextFields/src/MDCIntrinsicHeightTextView.h b/components/TextFields/src/MDCIntrinsicHeightTextView.h
@@ -22,6 +22,8 @@
  NOTE: UITextView is a subclass of UIScrollView. That's why it has a contentSize.
  */
 
-@interface MDCIntrinsicHeightTextView : UITextView
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @interface MDCIntrinsicHeightTextView : UITextView
 
 @end
diff --git a/components/TextFields/src/MDCMultilineTextField.h b/components/TextFields/src/MDCMultilineTextField.h
@@ -29,8 +29,10 @@
   Material Design themed mutiline text field (multiline text input).
   https://www.google.com/design/spec/components/text-fields.html#text-fields-multi-line-text-field
  */
-@interface MDCMultilineTextField
-    : UIView <MDCTextInput, MDCMultilineTextInput, MDCElevatable, MDCElevationOverriding>
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @interface MDCMultilineTextField
+    : UIView<MDCTextInput, MDCMultilineTextInput, MDCElevatable, MDCElevationOverriding>
 
 /** A mirror of the same property that already exists on UITextField, UITextView, and UILabel. */
 @property(nonatomic, assign) BOOL adjustsFontForContentSizeCategory;
diff --git a/components/TextFields/src/MDCMultilineTextInputDelegate.h b/components/TextFields/src/MDCMultilineTextInputDelegate.h
@@ -19,7 +19,9 @@
 
 #import <UIKit/UIKit.h>
 
-@protocol MDCMultilineTextInputDelegate <NSObject>
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @protocol MDCMultilineTextInputDelegate<NSObject>
 
 @optional
 
diff --git a/components/TextFields/src/MDCMultilineTextInputLayoutDelegate.h b/components/TextFields/src/MDCMultilineTextInputLayoutDelegate.h
@@ -16,7 +16,9 @@
 
 @protocol MDCMultilineTextInput;
 
-@protocol MDCMultilineTextInputLayoutDelegate <NSObject>
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @protocol MDCMultilineTextInputLayoutDelegate<NSObject>
 
 @optional
 /**
diff --git a/components/TextFields/src/MDCTextField.h b/components/TextFields/src/MDCTextField.h
@@ -27,8 +27,10 @@ extern NSString *_Nonnull const MDCTextInputDidToggleEnabledNotification;
   Material Design compliant single-line text input.
   https://www.google.com/design/spec/components/text-fields.html#text-fields-single-line-text-field
  */
-@interface MDCTextField
-    : UITextField <MDCTextInput, MDCLeadingViewTextInput, MDCElevatable, MDCElevationOverriding>
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @interface MDCTextField
+    : UITextField<MDCTextInput, MDCLeadingViewTextInput, MDCElevatable, MDCElevationOverriding>
 
 /** MDCTextField does not implement borders that conform to UITextBorderStyle. */
 @property(nonatomic, assign) UITextBorderStyle borderStyle NS_UNAVAILABLE;
diff --git a/components/TextFields/src/MDCTextFieldPositioningDelegate.h b/components/TextFields/src/MDCTextFieldPositioningDelegate.h
@@ -21,7 +21,9 @@
  Usually, these methods are direct mirrors of internal methods with the addition of a default value.
  */
 
-@protocol MDCTextInputPositioningDelegate <NSObject>
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @protocol MDCTextInputPositioningDelegate<NSObject>
 
 @optional
 
diff --git a/components/TextFields/src/MDCTextInput.h b/components/TextFields/src/MDCTextInput.h
@@ -42,7 +42,9 @@ typedef NS_ENUM(NSUInteger, MDCTextInputTextInsetsMode) {
 @protocol MDCTextInputPositioningDelegate;
 
 /** Common API for Material Design compliant text inputs. */
-@protocol MDCTextInput <NSObject>
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @protocol MDCTextInput<NSObject>
 
 /**
  The attributed text string of the placeholder label.
@@ -232,7 +234,9 @@ Common API for text inputs that support having a leading view.
 MDCTextField implements this protocol but MDCMultilineTextField does not because the designers
 determined multiline text fields should only have trailing views.
 */
-@protocol MDCLeadingViewTextInput <MDCTextInput>
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @protocol MDCLeadingViewTextInput<MDCTextInput>
 
 /**
  An overlay view on the leading side.
diff --git a/components/TextFields/src/MDCTextInputBorderView.h b/components/TextFields/src/MDCTextInputBorderView.h
@@ -14,7 +14,9 @@
 
 #import <UIKit/UIKit.h>
 
-@interface MDCTextInputBorderView : UIView <NSCopying>
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @interface MDCTextInputBorderView : UIView<NSCopying>
 
 /**
  The color of the area inside the border.
diff --git a/components/TextFields/src/MDCTextInputCharacterCounter.h b/components/TextFields/src/MDCTextInputCharacterCounter.h
@@ -23,7 +23,9 @@
  of context), this object can instead choose to do sophisticated counting (ie: ignoring whitespace,
  ignoring url strings, ignoring usernames, etc).
  */
-@protocol MDCTextInputCharacterCounter <NSObject>
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @protocol MDCTextInputCharacterCounter<NSObject>
 
 /**
  Returns the count of characters for the text field.
@@ -41,6 +43,8 @@
 
  MDCTextInputAllCharactersCounter is naive (counts each character regardless of context).
  */
-@interface MDCTextInputAllCharactersCounter : NSObject <MDCTextInputCharacterCounter>
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @interface MDCTextInputAllCharactersCounter : NSObject<MDCTextInputCharacterCounter>
 
 @end
diff --git a/components/TextFields/src/MDCTextInputController.h b/components/TextFields/src/MDCTextInputController.h
@@ -20,7 +20,9 @@
 @protocol MDCTextInputCharacterCounter;
 
 /** Controllers that manipulate styling and animation of text inputs. */
-@protocol MDCTextInputController <NSObject, NSCopying, MDCTextInputPositioningDelegate>
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @protocol MDCTextInputController<NSObject, NSCopying, MDCTextInputPositioningDelegate>
 
 /**
  Color for decorations that indicates the input is currently editing.
diff --git a/components/TextFields/src/MDCTextInputControllerBase.h b/components/TextFields/src/MDCTextInputControllerBase.h
@@ -57,7 +57,9 @@
  placeholder as distinct from `label text`. The placeholder-related properties of this class most
  closely align with the "label text" as described in the guidance.
 */
-@interface MDCTextInputControllerBase : NSObject <MDCTextInputControllerFloatingPlaceholder>
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @interface MDCTextInputControllerBase : NSObject<MDCTextInputControllerFloatingPlaceholder>
 
 /**
  The color behind the input and label that defines the preferred tap zone.
diff --git a/components/TextFields/src/MDCTextInputControllerFilled.h b/components/TextFields/src/MDCTextInputControllerFilled.h
@@ -55,6 +55,8 @@
  placeholder as distinct from `label text`. The placeholder-related properties of this class most
  closely align with the "label text" as described in the guidance.
  */
-@interface MDCTextInputControllerFilled : MDCTextInputControllerBase
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @interface MDCTextInputControllerFilled : MDCTextInputControllerBase
 
 @end
diff --git a/components/TextFields/src/MDCTextInputControllerFloatingPlaceholder.h b/components/TextFields/src/MDCTextInputControllerFloatingPlaceholder.h
@@ -21,7 +21,9 @@
  placeholder as distinct from `label text`. The placeholder-related properties of this class most
  closely align with the "label text" as described in the guidance.
  */
-@protocol MDCTextInputControllerFloatingPlaceholder <MDCTextInputController>
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @protocol MDCTextInputControllerFloatingPlaceholder<MDCTextInputController>
 
 /**
  The color applied to the placeholder when floating and the text field is first responder. However,
diff --git a/components/TextFields/src/MDCTextInputControllerFullWidth.h b/components/TextFields/src/MDCTextInputControllerFullWidth.h
@@ -52,7 +52,9 @@
 
  Underline View Mode - While editing
  */
-@interface MDCTextInputControllerFullWidth : NSObject <MDCTextInputController>
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @interface MDCTextInputControllerFullWidth : NSObject<MDCTextInputController>
 
 /**
  Color for background for the various views making up a text field.
diff --git a/components/TextFields/src/MDCTextInputControllerLegacyDefault.h b/components/TextFields/src/MDCTextInputControllerLegacyDefault.h
@@ -61,6 +61,8 @@
  placeholder as distinct from `label text`. The placeholder-related properties of this class most
  closely align with the "label text" as described in the guidance.
 */
-@interface MDCTextInputControllerLegacyDefault : MDCTextInputControllerBase
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @interface MDCTextInputControllerLegacyDefault : MDCTextInputControllerBase
 
 @end
diff --git a/components/TextFields/src/MDCTextInputControllerLegacyFullWidth.h b/components/TextFields/src/MDCTextInputControllerLegacyFullWidth.h
@@ -54,6 +54,8 @@
  placeholder as distinct from `label text`. The placeholder-related properties of this class most
  closely align with the "label text" as described in the guidance.
  */
-@interface MDCTextInputControllerLegacyFullWidth : MDCTextInputControllerFullWidth
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @interface MDCTextInputControllerLegacyFullWidth : MDCTextInputControllerFullWidth
 
 @end
diff --git a/components/TextFields/src/MDCTextInputControllerOutlined.h b/components/TextFields/src/MDCTextInputControllerOutlined.h
@@ -59,6 +59,8 @@
  placeholder as distinct from `label text`. The placeholder-related properties of this class most
  closely align with the "label text" as described in the guidance.
  */
-@interface MDCTextInputControllerOutlined : MDCTextInputControllerBase
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @interface MDCTextInputControllerOutlined : MDCTextInputControllerBase
 
 @end
diff --git a/components/TextFields/src/MDCTextInputControllerOutlinedTextArea.h b/components/TextFields/src/MDCTextInputControllerOutlinedTextArea.h
@@ -67,6 +67,8 @@
  closely align with the "label text" as described in the guidance.
  */
 
-@interface MDCTextInputControllerOutlinedTextArea : MDCTextInputControllerBase
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @interface MDCTextInputControllerOutlinedTextArea : MDCTextInputControllerBase
 
 @end
diff --git a/components/TextFields/src/MDCTextInputControllerUnderline.h b/components/TextFields/src/MDCTextInputControllerUnderline.h
@@ -54,6 +54,8 @@
  placeholder as distinct from `label text`. The placeholder-related properties of this class most
  closely align with the "label text" as described in the guidance.
  */
-@interface MDCTextInputControllerUnderline : MDCTextInputControllerBase
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @interface MDCTextInputControllerUnderline : MDCTextInputControllerBase
 
 @end
diff --git a/components/TextFields/src/MDCTextInputUnderlineView.h b/components/TextFields/src/MDCTextInputUnderlineView.h
@@ -18,7 +18,9 @@
  A view that draws the underline effect for an instance of MDCTextInput. The underline has 2
  possible states enabled and disabled. Disabled shows a dotted line instead of solid.
  */
-@interface MDCTextInputUnderlineView : UIView <NSCopying>
+__deprecated_msg(
+    "MDCTextField and its associated classes are deprecated. Please use TextControls instead.")
+    @interface MDCTextInputUnderlineView : UIView<NSCopying>
 
 @property(nonatomic, strong) UIColor *color;
 @property(nonatomic, strong) UIColor *disabledColor;
