components/Buttons/README.md - external/github.com/material-components/material-components-ios - Git at Google

 <!--docs:
 title: "Buttons"
 layout: detail
 section: components
 excerpt: "Material design buttons allow users to take actions, and make choices, with a single tap."
 iconId: button
 path: /catalog/buttons/
 api_doc_root: true
 -->

 <!-- This file was auto-generated using ./scripts/generate_readme Buttons -->

 # Buttons

 [![Open bugs badge](https://img.shields.io/badge/dynamic/json.svg?label=open%20bugs&url=https%3A%2F%2Fapi.github.com%2Fsearch%2Fissues%3Fq%3Dis%253Aopen%2Blabel%253Atype%253ABug%2Blabel%253A%255BButtons%255D&query=%24.total_count)](https://github.com/material-components/material-components-ios/issues?q=is%3Aopen+is%3Aissue+label%3Atype%3ABug+label%3A%5BButtons%5D)

 Material design buttons allow users to take actions, and make choices, with a single tap. There are
 many distinct button styles including text buttons, contained buttons, and floating action buttons.

 <img src="docs/assets/text.gif" alt="An animation showing a Material Design text button." width="115"> <img src="docs/assets/outlined.gif" alt="An animation showing a Material Design outlined button." width="115"> <img src="docs/assets/contained.gif" alt="An animation showing a Material Design contained button." width="115"> <img src="docs/assets/fab.gif" alt="An animation showing a Material Design floating action button." width="99">

 ## Design & API documentation

 <ul class="icon-list">
   <li class="icon-list-item icon-list-item--spec"><a href="https://material.io/go/design-buttons">Material Design guidelines: Buttons</a></li>
   <li class="icon-list-item icon-list-item--link">Class: <a href="https://material.io/components/ios/catalog/buttons/api-docs/Classes.html#/c:objc(cs)MDCRaisedButton">MDCRaisedButton</a></li>
   <li class="icon-list-item icon-list-item--link">Class: <a href="https://material.io/components/ios/catalog/buttons/api-docs/Classes/MDCButton.html">MDCButton</a></li>
   <li class="icon-list-item icon-list-item--link">Class: <a href="https://material.io/components/ios/catalog/buttons/api-docs/Classes/MDCFlatButton.html">MDCFlatButton</a></li>
   <li class="icon-list-item icon-list-item--link">Class: <a href="https://material.io/components/ios/catalog/buttons/api-docs/Classes/MDCFloatingButton.html">MDCFloatingButton</a></li>
   <li class="icon-list-item icon-list-item--link">Enumeration: <a href="https://material.io/components/ios/catalog/buttons/api-docs/Enums/MDCFloatingButtonImageLocation.html">MDCFloatingButtonImageLocation</a></li>
   <li class="icon-list-item icon-list-item--link">Enumeration: <a href="https://material.io/components/ios/catalog/buttons/api-docs/Enums/MDCFloatingButtonMode.html">MDCFloatingButtonMode</a></li>
   <li class="icon-list-item icon-list-item--link">Enumeration: <a href="https://material.io/components/ios/catalog/buttons/api-docs/Enums/MDCFloatingButtonShape.html">MDCFloatingButtonShape</a></li>
 </ul>

 ## Table of contents

 - [Overview](#overview)
 - [Installation](#installation)
   - [Installation with CocoaPods](#installation-with-cocoapods)
   - [Importing](#importing)
 - [Usage](#usage)
   - [Typical use: themed buttons](#typical-use-themed-buttons)
   - [Typical use: floating action buttons](#typical-use-floating-action-buttons)
   - [Customizing elevation](#customizing-elevation)
   - [Customizing floating action buttons](#customizing-floating-action-buttons)
   - [Interface Builder](#interface-builder)
 - [Extensions](#extensions)
   - [Theming](#theming)
   - [Color Theming](#color-theming)
   - [Typography Theming](#typography-theming)

 - - -

 ## Overview

 `MDCButton` is a highly-configurable UIButton implementation that provides support for shadow
 elevation, Material Design ripples, and other stateful design APIs.

 ## Installation

 <!-- Extracted from docs/../../../docs/component-installation.md -->

 ### Installation with CocoaPods

 Add the following to your `Podfile`:

 ```bash
 pod 'MaterialComponents/Buttons'
 ```
 <!--{: .code-renderer.code-renderer--install }-->

 Then, run the following command:

 ```bash
 pod install
 ```

 ### Importing

 To import the component:

 <!--<div class="material-code-render" markdown="1">-->
 #### Swift
 ```swift
 import MaterialComponents.MaterialButtons
 ```

 #### Objective-C

 ```objc
 #import "MaterialButtons.h"
 ```
 <!--</div>-->


 ## Usage

 <!-- Extracted from docs/typical-use-themed-buttons.md -->

 ### Typical use: themed buttons

 Create an instance of `MDCButton` and theme it with as one of the Material Design button styles
 using the ButtonThemer extension. Once themed, use the button like you would use a typical UIButton
 instance.

 <!--<div class="material-code-render" markdown="1">-->
 #### Swift
 ```swift
 let button = MDCButton()

 // Themed as a text button:
 MDCTextButtonThemer.applyScheme(buttonScheme, to: button)
 ```

 #### Objective-C

 ```objc
 MDCButton *button = [[MDCButton alloc] init];

 // Themed as a text button:
 [MDCTextButtonThemer applyScheme:buttonScheme toButton:button];
 ```
 <!--</div>-->

 See the [ButtonThemer documentation](docs/theming.md) for a full list of supported Material Design
 button styles.

 <!-- Extracted from docs/typical-use-floating-action-buttons.md -->

 ### Typical use: floating action buttons

 MDCFloatingButton is a subclass of MDCButton that implements the Material Design floating action
 button style and behavior. Floating action buttons should be provided with a templated image for
 their normal state.

 <!--<div class="material-code-render" markdown="1">-->
 #### Swift

 ```swift
 // Note: you'll need to provide your own image - the following is just an example.
 let plusImage = UIImage(named: "plus").withRenderingMode(.alwaysTemplate)
 let button = MDCFloatingButton()
 button.setImage(plusImage, forState: .normal)
 MDCFloatingActionButtonThemer.applyScheme(buttonScheme, to: button)
 ```

 #### Objective-C

 ```objc
 // Note: you'll need to provide your own image - the following is just an example.
 UIImage *plusImage =
     [[UIImage imageNamed:@"plus"] imageWithRenderingMode:UIImageRenderingModeAlwaysTemplate];
 MDCFloatingButton *button = [[MDCFloatingButton alloc] init];
 [button setImage:plusImage forState:UIControlStateNormal];
 [MDCFloatingActionButtonThemer applyScheme:buttonScheme toButton:button];
 ```
 <!--</div>-->

 <!-- Extracted from docs/customizing-elevation.md -->

 ### Customizing elevation

 The elevation of a button can be changed for a given control state using `setElevation:forState:`.

 See the [Material Design shadow guidelines](https://material.io/guidelines/what-is-material/elevation-shadows.html) for a detailed
 overview of different shadow elevations.

 For example, to make a button elevate on tap like a floating action button:

 <!--<div class="material-code-render" markdown="1">-->
 #### Swift
 ```swift
 button.setElevation(6, for: .normal)
 button.setElevation(12, for: .highlighted)
 ```

 #### Objective-C

 ```objc
 [button setElevation:6.0f forState:UIControlStateNormal];
 [button setElevation:12.0f forState:UIControlStateNormal];
 ```
 <!--</div>-->

 <!-- Extracted from docs/customizing-floating-action-buttons.md -->

 ### Customizing floating action buttons

 A floating action button can be configured with a combination of `shape` and `mode`. The
 `.default` shape is a 56-point circle containing a single image or short title. The `.mini` shape
 is a smaller, 40-point circle.  The `.normal` mode is a circle containing an image or short title.
 The `.expanded` mode is a "pill shape" and should include both an image and a single-word title. The
 `.expanded` mode should only be used in the largest layouts. For example, an iPad in full screen.

 While in the `.expanded` mode, a floating button can position its `imageView` to either the leading
 or trailing side of the title by setting the `imageLocation` property.

 Because of the combination of shapes and modes available to the floating action button, some
 UIButton property setters have been made unavailable and replaced with methods to set them for a
 specific mode and shape combination. Getters for these values are not available, and the normal
 getter will return the current value of the property.

 - `-setContentEdgeInsets` is replaced with `-setContentEdgeInsets:forShape:inMode:`
 - `-setHitAreaInsets` is replaced with `-setHitAreaInsets:forShape:inMode:`
 - `-setMinimumSize` is replaced with `-setMinimumSize:forShape:inMode:`
 - `-setMaximumSize` is replaced with `-setMaximumSize:forShape:inMode:`

 <!-- Extracted from docs/interface-builder.md -->

 ### Interface Builder

 MDCButton and its subclasses can be used in Interface Builder, but the button type **must** be set
 to "custom" in order for the button's highlight states to work as expected.


 ## Extensions

 <!-- Extracted from docs/theming.md -->

 ### Theming

 You can theme an MDCButton to match one of the Material Design button styles using your app's
 schemes in the ButtonThemer extension.

 You must first add the ButtonThemer extension to your project:

 ```bash
 pod 'MaterialComponents/Buttons+ButtonThemer'
 ```

 You can then import the extension and create an `MDCButtonScheme` instance. A button scheme defines
 the design parameters that you can use to theme your buttons.

 <!--<div class="material-code-render" markdown="1">-->
 #### Swift
 ```swift
 // Step 1: Import the ButtonThemer extension
 import MaterialComponents.MaterialButtons_ButtonThemer

 // Step 2: Create or get a button scheme
 let buttonScheme = MDCButtonScheme()

 // Step 3: Apply the button scheme to your component using the desired button style
 ```

 #### Objective-C

 ```objc
 // Step 1: Import the ButtonThemer extension
 #import "MaterialButtons+ButtonThemer.h"

 // Step 2: Create or get a button scheme
 MDCButtonScheme *buttonScheme = [[MDCButtonScheme alloc] init];

 // Step 3: Apply the button scheme to your component using the desired button style
 ```
 <!--</div>-->

 #### Text buttons

 <img src="docs/assets/text.gif" alt="An animation showing a Material Design text button." width="128">

 To theme a button as a Material Design text button, use `MDCTextButtonThemer`.

 <!--<div class="material-code-render" markdown="1">-->
 #### Swift
 ```swift
 MDCTextButtonThemer.applyScheme(buttonScheme, to: button)
 ```

 #### Objective-C

 ```objc
 [MDCTextButtonThemer applyScheme:buttonScheme toButton:button];
 ```
 <!--</div>-->

 #### Outlined buttons

 <img src="docs/assets/outlined.gif" alt="An animation showing a Material Design outlined button." width="115">

 To theme a button as a Material Design outlined button, use `MDCOutlinedButtonThemer`
 with an `MDCButton`.

 <!--<div class="material-code-render" markdown="1">-->
 #### Swift
 ```swift
 MDCOutlinedButtonThemer.applyScheme(buttonScheme, to: button)
 ```

 #### Objective-C

 ```objc
 [MDCOutlinedButtonThemer applyScheme:buttonScheme toButton:button];
 ```
 <!--</div>-->

 #### Contained buttons

 <img src="docs/assets/contained.gif" alt="An animation showing a Material Design contained button." width="128">

 To theme a button as a Material Design text button, use `MDCContainedButtonThemer`.

 <!--<div class="material-code-render" markdown="1">-->
 #### Swift
 ```swift
 MDCContainedButtonThemer.applyScheme(buttonScheme, to: button)
 ```

 #### Objective-C

 ```objc
 [MDCContainedButtonThemer applyScheme:buttonScheme toButton:button];
 ```
 <!--</div>-->

 #### Floating action buttons

 <img src="docs/assets/fab.gif" alt="An animation showing a Material Design floating action button." width="99">

 To theme a button as a Material Design floating action button, use `MDCFloatingActionButtonThemer`
 with an `MDCFloatingButton`.

 <!--<div class="material-code-render" markdown="1">-->
 #### Swift
 ```swift
 MDCFloatingActionButtonThemer.applyScheme(buttonScheme, to: button)
 ```

 #### Objective-C

 ```objc
 [MDCFloatingActionButtonThemer applyScheme:buttonScheme toButton:button];
 ```
 <!--</div>-->

 <!-- Extracted from docs/color-theming.md -->

 ### Color Theming

 You can theme buttons with your app's color scheme using the ColorThemer extension.

 You must first add the Color Themer extension to your project:

 ```bash
 pod 'MaterialComponents/Buttons+ColorThemer'
 ```

 <!--<div class="material-code-render" markdown="1">-->
 #### Swift
 ```swift
 // Step 1: Import the ColorThemer extension
 import MaterialComponents.MaterialButtons_ColorThemer

 // Step 2: Create or get a color scheme
 let colorScheme = MDCSemanticColorScheme()

 // Step 3: Apply the color scheme to your component using the desired button style
 MDCContainedButtonColorThemer.applySemanticColorScheme(colorScheme, to: component)
 MDCFloatingButtonColorThemer.applySemanticColorScheme(colorScheme, to: component)
 MDCTextButtonColorThemer.applySemanticColorScheme(colorScheme, to: component)
 ```

 #### Objective-C

 ```objc
 // Step 1: Import the ColorThemer extension
 #import "MaterialButtons+ColorThemer.h"

 // Step 2: Create or get a color scheme
 id<MDCColorScheming> colorScheme = [[MDCSemanticColorScheme alloc] init];

 // Step 3: Apply the color scheme to your component using the desired button style
 [MDCContainedButtonColorThemer applySemanticColorScheme:colorScheme
      toButton:component];
 [MDCFloatingButtonColorThemer applySemanticColorScheme:colorScheme
      toButton:component];
 [MDCTextButtonColorThemer applySemanticColorScheme:colorScheme
      toButton:component];
 ```
 <!--</div>-->

 <!-- Extracted from docs/typography-theming.md -->

 ### Typography Theming

 You can theme buttons with your app's typography scheme using the TypographyThemer extension.

 You must first add the Typography Themer extension to your project:

 ```bash
 pod 'MaterialComponents/Buttons+TypographyThemer'
 ```

 <!--<div class="material-code-render" markdown="1">-->
 #### Swift
 ```swift
 // Step 1: Import the TypographyThemer extension
 import MaterialComponents.MaterialButtons_TypographyThemer

 // Step 2: Create or get a typography scheme
 let typographyScheme = MDCTypographyScheme()

 // Step 3: Apply the typography scheme to your component
 MDCButtonTypographyThemer.applyTypographyScheme(typographyScheme, to: component)
 ```

 #### Objective-C

 ```objc
 // Step 1: Import the TypographyThemer extension
 #import "MaterialButtons+TypographyThemer.h"

 // Step 2: Create or get a typography scheme
 id<MDCTypographyScheming> typographyScheme = [[MDCTypographyScheme alloc] init];

 // Step 3: Apply the typography scheme to your component
 [MDCButtonTypographyThemer applyTypographyScheme:colorScheme
      toButton:component];
 ```
 <!--</div>-->
	<!--docs:
	title: "Buttons"
	layout: detail
	section: components
	excerpt: "Material design buttons allow users to take actions, and make choices, with a single tap."
	iconId: button
	path: /catalog/buttons/
	api_doc_root: true
	-->

	<!-- This file was auto-generated using ./scripts/generate_readme Buttons -->

	# Buttons

	[![Open bugs badge](https://img.shields.io/badge/dynamic/json.svg?label=open%20bugs&url=https%3A%2F%2Fapi.github.com%2Fsearch%2Fissues%3Fq%3Dis%253Aopen%2Blabel%253Atype%253ABug%2Blabel%253A%255BButtons%255D&query=%24.total_count)](https://github.com/material-components/material-components-ios/issues?q=is%3Aopen+is%3Aissue+label%3Atype%3ABug+label%3A%5BButtons%5D)

	Material design buttons allow users to take actions, and make choices, with a single tap. There are
	many distinct button styles including text buttons, contained buttons, and floating action buttons.

	<img src="docs/assets/text.gif" alt="An animation showing a Material Design text button." width="115"> <img src="docs/assets/outlined.gif" alt="An animation showing a Material Design outlined button." width="115"> <img src="docs/assets/contained.gif" alt="An animation showing a Material Design contained button." width="115"> <img src="docs/assets/fab.gif" alt="An animation showing a Material Design floating action button." width="99">

	## Design & API documentation

	<ul class="icon-list">
	<li class="icon-list-item icon-list-item--spec"><a href="https://material.io/go/design-buttons">Material Design guidelines: Buttons</a></li>
	<li class="icon-list-item icon-list-item--link">Class: <a href="https://material.io/components/ios/catalog/buttons/api-docs/Classes.html#/c:objc(cs)MDCRaisedButton">MDCRaisedButton</a></li>
	<li class="icon-list-item icon-list-item--link">Class: <a href="https://material.io/components/ios/catalog/buttons/api-docs/Classes/MDCButton.html">MDCButton</a></li>
	<li class="icon-list-item icon-list-item--link">Class: <a href="https://material.io/components/ios/catalog/buttons/api-docs/Classes/MDCFlatButton.html">MDCFlatButton</a></li>
	<li class="icon-list-item icon-list-item--link">Class: <a href="https://material.io/components/ios/catalog/buttons/api-docs/Classes/MDCFloatingButton.html">MDCFloatingButton</a></li>
	<li class="icon-list-item icon-list-item--link">Enumeration: <a href="https://material.io/components/ios/catalog/buttons/api-docs/Enums/MDCFloatingButtonImageLocation.html">MDCFloatingButtonImageLocation</a></li>
	<li class="icon-list-item icon-list-item--link">Enumeration: <a href="https://material.io/components/ios/catalog/buttons/api-docs/Enums/MDCFloatingButtonMode.html">MDCFloatingButtonMode</a></li>
	<li class="icon-list-item icon-list-item--link">Enumeration: <a href="https://material.io/components/ios/catalog/buttons/api-docs/Enums/MDCFloatingButtonShape.html">MDCFloatingButtonShape</a></li>
	</ul>

	## Table of contents

	- [Overview](#overview)
	- [Installation](#installation)
	- [Installation with CocoaPods](#installation-with-cocoapods)
	- [Importing](#importing)
	- [Usage](#usage)
	- [Typical use: themed buttons](#typical-use-themed-buttons)
	- [Typical use: floating action buttons](#typical-use-floating-action-buttons)
	- [Customizing elevation](#customizing-elevation)
	- [Customizing floating action buttons](#customizing-floating-action-buttons)
	- [Interface Builder](#interface-builder)
	- [Extensions](#extensions)
	- [Theming](#theming)
	- [Color Theming](#color-theming)
	- [Typography Theming](#typography-theming)

	- - -

	## Overview

	`MDCButton` is a highly-configurable UIButton implementation that provides support for shadow
	elevation, Material Design ripples, and other stateful design APIs.

	## Installation

	<!-- Extracted from docs/../../../docs/component-installation.md -->

	### Installation with CocoaPods

	Add the following to your `Podfile`:

	```bash
	pod 'MaterialComponents/Buttons'
	```
	<!--{: .code-renderer.code-renderer--install }-->

	Then, run the following command:

	```bash
	pod install
	```

	### Importing

	To import the component:

	<!--<div class="material-code-render" markdown="1">-->
	#### Swift
	```swift
	import MaterialComponents.MaterialButtons
	```

	#### Objective-C

	```objc
	#import "MaterialButtons.h"
	```
	<!--</div>-->


	## Usage

	<!-- Extracted from docs/typical-use-themed-buttons.md -->

	### Typical use: themed buttons

	Create an instance of `MDCButton` and theme it with as one of the Material Design button styles
	using the ButtonThemer extension. Once themed, use the button like you would use a typical UIButton
	instance.

	<!--<div class="material-code-render" markdown="1">-->
	#### Swift
	```swift
	let button = MDCButton()

	// Themed as a text button:
	MDCTextButtonThemer.applyScheme(buttonScheme, to: button)
	```

	#### Objective-C

	```objc
	MDCButton *button = [[MDCButton alloc] init];

	// Themed as a text button:
	[MDCTextButtonThemer applyScheme:buttonScheme toButton:button];
	```
	<!--</div>-->

	See the [ButtonThemer documentation](docs/theming.md) for a full list of supported Material Design
	button styles.

	<!-- Extracted from docs/typical-use-floating-action-buttons.md -->

	### Typical use: floating action buttons

	MDCFloatingButton is a subclass of MDCButton that implements the Material Design floating action
	button style and behavior. Floating action buttons should be provided with a templated image for
	their normal state.

	<!--<div class="material-code-render" markdown="1">-->
	#### Swift

	```swift
	// Note: you'll need to provide your own image - the following is just an example.
	let plusImage = UIImage(named: "plus").withRenderingMode(.alwaysTemplate)
	let button = MDCFloatingButton()
	button.setImage(plusImage, forState: .normal)
	MDCFloatingActionButtonThemer.applyScheme(buttonScheme, to: button)
	```

	#### Objective-C

	```objc
	// Note: you'll need to provide your own image - the following is just an example.
	UIImage *plusImage =
	[[UIImage imageNamed:@"plus"] imageWithRenderingMode:UIImageRenderingModeAlwaysTemplate];
	MDCFloatingButton *button = [[MDCFloatingButton alloc] init];
	[button setImage:plusImage forState:UIControlStateNormal];
	[MDCFloatingActionButtonThemer applyScheme:buttonScheme toButton:button];
	```
	<!--</div>-->

	<!-- Extracted from docs/customizing-elevation.md -->

	### Customizing elevation

	The elevation of a button can be changed for a given control state using `setElevation:forState:`.

	See the [Material Design shadow guidelines](https://material.io/guidelines/what-is-material/elevation-shadows.html) for a detailed
	overview of different shadow elevations.

	For example, to make a button elevate on tap like a floating action button:

	<!--<div class="material-code-render" markdown="1">-->
	#### Swift
	```swift
	button.setElevation(6, for: .normal)
	button.setElevation(12, for: .highlighted)
	```

	#### Objective-C

	```objc
	[button setElevation:6.0f forState:UIControlStateNormal];
	[button setElevation:12.0f forState:UIControlStateNormal];
	```
	<!--</div>-->

	<!-- Extracted from docs/customizing-floating-action-buttons.md -->

	### Customizing floating action buttons

	A floating action button can be configured with a combination of `shape` and `mode`. The
	`.default` shape is a 56-point circle containing a single image or short title. The `.mini` shape
	is a smaller, 40-point circle. The `.normal` mode is a circle containing an image or short title.
	The `.expanded` mode is a "pill shape" and should include both an image and a single-word title. The
	`.expanded` mode should only be used in the largest layouts. For example, an iPad in full screen.

	While in the `.expanded` mode, a floating button can position its `imageView` to either the leading
	or trailing side of the title by setting the `imageLocation` property.

	Because of the combination of shapes and modes available to the floating action button, some
	UIButton property setters have been made unavailable and replaced with methods to set them for a
	specific mode and shape combination. Getters for these values are not available, and the normal
	getter will return the current value of the property.

	- `-setContentEdgeInsets` is replaced with `-setContentEdgeInsets:forShape:inMode:`
	- `-setHitAreaInsets` is replaced with `-setHitAreaInsets:forShape:inMode:`
	- `-setMinimumSize` is replaced with `-setMinimumSize:forShape:inMode:`
	- `-setMaximumSize` is replaced with `-setMaximumSize:forShape:inMode:`

	<!-- Extracted from docs/interface-builder.md -->

	### Interface Builder

	MDCButton and its subclasses can be used in Interface Builder, but the button type must be set
	to "custom" in order for the button's highlight states to work as expected.


	## Extensions

	<!-- Extracted from docs/theming.md -->

	### Theming

	You can theme an MDCButton to match one of the Material Design button styles using your app's
	schemes in the ButtonThemer extension.

	You must first add the ButtonThemer extension to your project:

	```bash
	pod 'MaterialComponents/Buttons+ButtonThemer'
	```

	You can then import the extension and create an `MDCButtonScheme` instance. A button scheme defines
	the design parameters that you can use to theme your buttons.

	<!--<div class="material-code-render" markdown="1">-->
	#### Swift
	```swift
	// Step 1: Import the ButtonThemer extension
	import MaterialComponents.MaterialButtons_ButtonThemer

	// Step 2: Create or get a button scheme
	let buttonScheme = MDCButtonScheme()

	// Step 3: Apply the button scheme to your component using the desired button style
	```

	#### Objective-C

	```objc
	// Step 1: Import the ButtonThemer extension
	#import "MaterialButtons+ButtonThemer.h"

	// Step 2: Create or get a button scheme
	MDCButtonScheme *buttonScheme = [[MDCButtonScheme alloc] init];

	// Step 3: Apply the button scheme to your component using the desired button style
	```
	<!--</div>-->

	#### Text buttons

	<img src="docs/assets/text.gif" alt="An animation showing a Material Design text button." width="128">

	To theme a button as a Material Design text button, use `MDCTextButtonThemer`.

	<!--<div class="material-code-render" markdown="1">-->
	#### Swift
	```swift
	MDCTextButtonThemer.applyScheme(buttonScheme, to: button)
	```

	#### Objective-C

	```objc
	[MDCTextButtonThemer applyScheme:buttonScheme toButton:button];
	```
	<!--</div>-->

	#### Outlined buttons

	<img src="docs/assets/outlined.gif" alt="An animation showing a Material Design outlined button." width="115">

	To theme a button as a Material Design outlined button, use `MDCOutlinedButtonThemer`
	with an `MDCButton`.

	<!--<div class="material-code-render" markdown="1">-->
	#### Swift
	```swift
	MDCOutlinedButtonThemer.applyScheme(buttonScheme, to: button)
	```

	#### Objective-C

	```objc
	[MDCOutlinedButtonThemer applyScheme:buttonScheme toButton:button];
	```
	<!--</div>-->

	#### Contained buttons

	<img src="docs/assets/contained.gif" alt="An animation showing a Material Design contained button." width="128">

	To theme a button as a Material Design text button, use `MDCContainedButtonThemer`.

	<!--<div class="material-code-render" markdown="1">-->
	#### Swift
	```swift
	MDCContainedButtonThemer.applyScheme(buttonScheme, to: button)
	```

	#### Objective-C

	```objc
	[MDCContainedButtonThemer applyScheme:buttonScheme toButton:button];
	```
	<!--</div>-->

	#### Floating action buttons

	<img src="docs/assets/fab.gif" alt="An animation showing a Material Design floating action button." width="99">

	To theme a button as a Material Design floating action button, use `MDCFloatingActionButtonThemer`
	with an `MDCFloatingButton`.

	<!--<div class="material-code-render" markdown="1">-->
	#### Swift
	```swift
	MDCFloatingActionButtonThemer.applyScheme(buttonScheme, to: button)
	```

	#### Objective-C

	```objc
	[MDCFloatingActionButtonThemer applyScheme:buttonScheme toButton:button];
	```
	<!--</div>-->

	<!-- Extracted from docs/color-theming.md -->

	### Color Theming

	You can theme buttons with your app's color scheme using the ColorThemer extension.

	You must first add the Color Themer extension to your project:

	```bash
	pod 'MaterialComponents/Buttons+ColorThemer'
	```

	<!--<div class="material-code-render" markdown="1">-->
	#### Swift
	```swift
	// Step 1: Import the ColorThemer extension
	import MaterialComponents.MaterialButtons_ColorThemer

	// Step 2: Create or get a color scheme
	let colorScheme = MDCSemanticColorScheme()

	// Step 3: Apply the color scheme to your component using the desired button style
	MDCContainedButtonColorThemer.applySemanticColorScheme(colorScheme, to: component)
	MDCFloatingButtonColorThemer.applySemanticColorScheme(colorScheme, to: component)
	MDCTextButtonColorThemer.applySemanticColorScheme(colorScheme, to: component)
	```

	#### Objective-C

	```objc
	// Step 1: Import the ColorThemer extension
	#import "MaterialButtons+ColorThemer.h"

	// Step 2: Create or get a color scheme
	id<MDCColorScheming> colorScheme = [[MDCSemanticColorScheme alloc] init];

	// Step 3: Apply the color scheme to your component using the desired button style
	[MDCContainedButtonColorThemer applySemanticColorScheme:colorScheme
	toButton:component];
	[MDCFloatingButtonColorThemer applySemanticColorScheme:colorScheme
	toButton:component];
	[MDCTextButtonColorThemer applySemanticColorScheme:colorScheme
	toButton:component];
	```
	<!--</div>-->

	<!-- Extracted from docs/typography-theming.md -->

	### Typography Theming

	You can theme buttons with your app's typography scheme using the TypographyThemer extension.

	You must first add the Typography Themer extension to your project:

	```bash
	pod 'MaterialComponents/Buttons+TypographyThemer'
	```

	<!--<div class="material-code-render" markdown="1">-->
	#### Swift
	```swift
	// Step 1: Import the TypographyThemer extension
	import MaterialComponents.MaterialButtons_TypographyThemer

	// Step 2: Create or get a typography scheme
	let typographyScheme = MDCTypographyScheme()

	// Step 3: Apply the typography scheme to your component
	MDCButtonTypographyThemer.applyTypographyScheme(typographyScheme, to: component)
	```

	#### Objective-C

	```objc
	// Step 1: Import the TypographyThemer extension
	#import "MaterialButtons+TypographyThemer.h"

	// Step 2: Create or get a typography scheme
	id<MDCTypographyScheming> typographyScheme = [[MDCTypographyScheme alloc] init];

	// Step 3: Apply the typography scheme to your component
	[MDCButtonTypographyThemer applyTypographyScheme:colorScheme
	toButton:component];
	```
	<!--</div>-->