# GuidanceStylist

Artifact: [androidx.leanback:leanback](https://developer.android.com/jetpack/androidx/releases/leanback) [View Source](https://cs.android.com/search?q=file:androidx/leanback/widget/GuidanceStylist.java+class:androidx.leanback.widget.GuidanceStylist) Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

*** ** * ** ***


```
class GuidanceStylist : FragmentAnimationProvider
```

<br />

*** ** * ** ***

GuidanceStylist is used within a `https://developer.android.com/reference/kotlin/androidx/leanback/app/GuidedStepFragment` to display contextual information for the decision(s) required at that step.

Many aspects of the base GuidanceStylist can be customized through theming; see the theme attributes below. Note that these attributes are not set on individual elements in layout XML, but instead would be set in a custom theme. See [Styles and Themes](http://developer.android.com/guide/topics/ui/themes.html) for more information.

If these hooks are insufficient, this class may also be subclassed. Subclasses may wish to override the `https://developer.android.com/reference/kotlin/androidx/leanback/widget/GuidanceStylist#onProvideLayoutId()` method to change the layout file used to display the guidance; more complex layouts may be supported by also providing a subclass of `https://developer.android.com/reference/kotlin/androidx/leanback/widget/GuidanceStylist.Guidance` with extra fields.

Note: If an alternate layout is provided, the following view IDs should be used to refer to base elements:

- 
- 
- 
- 

View IDs are allowed to be missing, in which case the corresponding views will be null.

| See also |
|---|---|
| `https://developer.android.com/reference/kotlin/androidx/leanback/app/GuidedStepFragment` |   |
| `https://developer.android.com/reference/kotlin/androidx/leanback/widget/GuidanceStylist.Guidance` |   |

## Summary

| ### Nested types |
|---|
| `class https://developer.android.com/reference/kotlin/androidx/leanback/widget/GuidanceStylist.Guidance` A data class representing contextual information for a `https://developer.android.com/reference/kotlin/androidx/leanback/app/GuidedStepFragment`. |

| ### Public constructors |
|---|
| `https://developer.android.com/reference/kotlin/androidx/leanback/widget/GuidanceStylist#GuidanceStylist()()` |

| ### Public functions |
|---|---|
| `https://developer.android.com/reference/android/widget/TextView.html?` | `https://developer.android.com/reference/kotlin/androidx/leanback/widget/GuidanceStylist#getBreadcrumbView()()` Returns the view displaying the breadcrumb of the guidance. |
| `https://developer.android.com/reference/android/widget/TextView.html?` | `https://developer.android.com/reference/kotlin/androidx/leanback/widget/GuidanceStylist#getDescriptionView()()` Returns the view displaying the description of the guidance. |
| `https://developer.android.com/reference/android/widget/ImageView.html?` | `https://developer.android.com/reference/kotlin/androidx/leanback/widget/GuidanceStylist#getIconView()()` Returns the view displaying the icon of the guidance. |
| `https://developer.android.com/reference/android/widget/TextView.html?` | `https://developer.android.com/reference/kotlin/androidx/leanback/widget/GuidanceStylist#getTitleView()()` Returns the view displaying the title of the guidance. |
| `https://developer.android.com/reference/android/view/View.html` | `https://developer.android.com/reference/kotlin/androidx/leanback/widget/GuidanceStylist#onCreateView(android.view.LayoutInflater,android.view.ViewGroup,androidx.leanback.widget.GuidanceStylist.Guidance)( inflater: https://developer.android.com/reference/android/view/LayoutInflater.html, container: https://developer.android.com/reference/android/view/ViewGroup.html?, guidance: https://developer.android.com/reference/kotlin/androidx/leanback/widget/GuidanceStylist.Guidance )` Creates an appropriately configured view for the given Guidance, using the provided inflater and container. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/leanback/widget/GuidanceStylist#onDestroyView()()` Called when destroy the View created by GuidanceStylist. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/leanback/widget/GuidanceStylist#onImeAppearing(java.util.List<android.animation.Animator>)(animators: (https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-mutable-list/index.html)https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html<https://developer.android.com/reference/android/animation/Animator.html!>)` Animates the fragment in response to the IME appearing. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-unit/index.html` | `https://developer.android.com/reference/kotlin/androidx/leanback/widget/GuidanceStylist#onImeDisappearing(java.util.List<android.animation.Animator>)(animators: (https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-mutable-list/index.html)https://kotlinlang.org/api/core/kotlin-stdlib/kotlin.collections/-list/index.html<https://developer.android.com/reference/android/animation/Animator.html!>)` Animates the fragment in response to the IME disappearing. |
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | `https://developer.android.com/reference/kotlin/androidx/leanback/widget/GuidanceStylist#onProvideLayoutId()()` Provides the resource ID of the layout defining the guidance view. |

## Public constructors

### GuidanceStylist

Added in 1.1.0

```
GuidanceStylist()
```

## Public functions

### getBreadcrumbView

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
fun getBreadcrumbView(): TextView?
```

Returns the view displaying the breadcrumb of the guidance.

| Returns |
|---|---|
| `https://developer.android.com/reference/android/widget/TextView.html?` | The text view object for the breadcrumb. |

### getDescriptionView

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
fun getDescriptionView(): TextView?
```

Returns the view displaying the description of the guidance.

| Returns |
|---|---|
| `https://developer.android.com/reference/android/widget/TextView.html?` | The text view object for the description. |

### getIconView

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
fun getIconView(): ImageView?
```

Returns the view displaying the icon of the guidance.

| Returns |
|---|---|
| `https://developer.android.com/reference/android/widget/ImageView.html?` | The image view object for the icon. |

### getTitleView

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
fun getTitleView(): TextView?
```

Returns the view displaying the title of the guidance.

| Returns |
|---|---|
| `https://developer.android.com/reference/android/widget/TextView.html?` | The text view object for the title. |

### onCreateView

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
fun onCreateView(
    inflater: LayoutInflater,
    container: ViewGroup?,
    guidance: GuidanceStylist.Guidance
): View
```

Creates an appropriately configured view for the given Guidance, using the provided inflater and container.

*Note: Does not actually add the created view to the container; the caller should do this.*

| Parameters |
|---|---|
| `inflater: https://developer.android.com/reference/android/view/LayoutInflater.html` | The layout inflater to be used when constructing the view. |
| `container: https://developer.android.com/reference/android/view/ViewGroup.html?` | The view group to be passed in the call to `LayoutInflater.inflate`. |
| `guidance: https://developer.android.com/reference/kotlin/androidx/leanback/widget/GuidanceStylist.Guidance` | The guidance data for the view. |

| Returns |
|---|---|
| `https://developer.android.com/reference/android/view/View.html` | The view to be added to the caller's view hierarchy. |

### onDestroyView

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
fun onDestroyView(): Unit
```

Called when destroy the View created by GuidanceStylist.

### onImeAppearing

```
fun onImeAppearing(animators: (Mutable)List<Animator!>): Unit
```

Animates the fragment in response to the IME appearing.

### onImeDisappearing

```
fun onImeDisappearing(animators: (Mutable)List<Animator!>): Unit
```

Animates the fragment in response to the IME disappearing.

### onProvideLayoutId

Added in [1.1.0](https://developer.android.com/jetpack/androidx/releases/leanback#1.1.0)

```
fun onProvideLayoutId(): Int
```

Provides the resource ID of the layout defining the guidance view. Subclasses may override to provide their own customized layouts. The base implementation returns . If overridden, the substituted layout should contain matching IDs for any views that should be managed by the base class; this can be achieved by starting with a copy of the base layout file.

| Returns |
|---|---|
| `https://kotlinlang.org/api/core/kotlin-stdlib/kotlin/-int/index.html` | The resource ID of the layout to be inflated to define the guidance view. |