Skip to content

Commit

Permalink
docs: Add TextBox Placeholder and Header breaking change section
Browse files Browse the repository at this point in the history
  • Loading branch information
eriklimakc committed Jul 16, 2024
1 parent 1745f99 commit 0d113d0
Showing 1 changed file with 27 additions and 0 deletions.
27 changes: 27 additions & 0 deletions doc/material-migration.md
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,33 @@ uid: Uno.Themes.Material.Migration

The Uno Material v5 packages introduce a new dependency on the [Uno Themes](https://www.nuget.org/packages/Uno.Themes.WinUI) package. Uno Themes is the base library for all design system implementations going forward. As a result, the following changes have been made:

### Upgrading to Uno Themes 5.1

#### TextBox `PlaceholderText` and `Header`

Previously, the `PlaceholderText` property acted as a header, displaying in the normal state and animating upwards when the text is set or being entered. And, the `Header` property did nothing. Now, both `PlaceholderText` and `Header` are supported and their behaviors have changed.

##### New Behavior

- **PlaceholderText**: Displays inside the TextBox when it's empty. Disappears when text is entered.
- **Header**: Acts as a label. Animates upwards when the TextBox is focused.

##### Example

**Old Usage:**

```xml
<TextBox PlaceholderText="Enter your name" />
```

**New Usage:**

```xml
<TextBox PlaceholderText="Enter your name" Header="Name" />
```

Update your TextBox elements to use `Header` for labels and `PlaceholderText` for placeholders.

### Converters

All Converters were moved to the base `Uno.Themes` library, and the new `namespace` is `Uno.Themes`.
Expand Down

0 comments on commit 0d113d0

Please sign in to comment.