Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 2 additions & 0 deletions docs/user-interface/controls/editor.md
Original file line number Diff line number Diff line change
Expand Up @@ -106,6 +106,8 @@ The following screenshot shows the resulting <xref:Microsoft.Maui.Controls.Edito

:::image type="content" source="media/editor/editor.png" alt-text="Screenshot of a basic Editor on Android.":::

[!INCLUDE [Keyboard autoscroll manager](includes/keyboardautomanagerscroll.md)]

Entered text can be accessed by reading the `Text` property, and the `TextChanged` and `Completed` events signal that the text has changed or been completed.

The `TextChanged` event is raised when the text in the <xref:Microsoft.Maui.Controls.Editor> changes, and the `TextChangedEventArgs` provide the text before and after the change via the `OldTextValue` and `NewTextValue` properties:
Expand Down
2 changes: 2 additions & 0 deletions docs/user-interface/controls/entry.md
Original file line number Diff line number Diff line change
Expand Up @@ -114,6 +114,8 @@ The following screenshot shows the resulting <xref:Microsoft.Maui.Controls.Entry

:::image type="content" source="media/entry/entry.png" alt-text="Screenshot of a basic Entry on Android.":::

[!INCLUDE [Keyboard autoscroll manager](includes/keyboardautomanagerscroll.md)]

Entered text can be accessed by reading the `Text` property, and the `TextChanged` and `Completed` events signal that the text has changed or been completed.

The `TextChanged` event is raised when the text in the <xref:Microsoft.Maui.Controls.Entry> changes, and the `TextChangedEventArgs` provide the text before and after the change via the `OldTextValue` and `NewTextValue` properties:
Expand Down
11 changes: 11 additions & 0 deletions docs/user-interface/controls/includes/keyboardautomanagerscroll.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,11 @@
---
ms.topic: include
ms.date: 10/21/2023
---

::: moniker range=">=net-maui-8.0"

> [!NOTE]
> On iOS, the soft input keyboard can cover a text input field when the field is near the bottom of the screen, making it difficult to enter text. However, in a .NET MAUI iOS app, pages automatically scroll when the soft input keyboard would cover a text entry field, so that the field is above the soft input keyboard. The `KeyboardAutoManagerScroll.Disconnect` method, in the `Microsoft.Maui.Platform` namespace, can be called to disable this default behavior. The `KeyboardAutoManagerScroll.Connect` method can be called to re-enable the behavior after it's been disabled.

::: moniker-end
2 changes: 2 additions & 0 deletions docs/user-interface/controls/searchbar.md
Original file line number Diff line number Diff line change
Expand Up @@ -102,6 +102,8 @@ The equivalent C# code is:
SearchBar searchBar = new SearchBar { Placeholder = "Search items..." };
```

[!INCLUDE [Keyboard autoscroll manager](includes/keyboardautomanagerscroll.md)]

## Perform a search with event handlers

A search can be executed using the <xref:Microsoft.Maui.Controls.SearchBar> control by attaching an event handler to one of the following events:
Expand Down
1 change: 1 addition & 0 deletions docs/whats-new/dotnet-8.md
Original file line number Diff line number Diff line change
Expand Up @@ -55,6 +55,7 @@ The following behavior has changed from the previous release:

- Use of the <xref:Microsoft.Maui.Controls.Maps.Map> control from XAML now requires the following `xmlns` namespace declaration: `xmlns:maps="http://schemas.microsoft.com/dotnet/2021/maui/maps"`.
- Image caching is disabled on Android when loading an image from a stream with the [`ImageSource.FromStream`](xref:Microsoft.Maui.Controls.ImageSource.FromStream%2A) method. This is due to the lack of data from which to create a reasonable cache key.
- On iOS, pages automatically scroll when the soft input keyboard would cover a text entry field, so that the field is above the soft input keyboard. The `KeyboardAutoManagerScroll.Disconnect` method, in the `Microsoft.Maui.Platform` namespace, can be called to disable this default behavior. The `KeyboardAutoManagerScroll.Connect` method can be called to re-enable the behavior after it's been disabled.

<!-- ## Performance

Expand Down