Start Debugging
RU
2026-09-28 errorsdotnetdotnet-10maui Edit on GitHub

Исправление: .NET MAUI Entry с Keyboard.Numeric показывает маленькую цифровую панель, а затем полную клавиатуру на iPadOS 26

В iPadOS 26 MAUI сопоставляет Keyboard.Numeric с UIKeyboardType.DecimalPad, который теперь открывается как плавающая мини-панель с цифрами. Добавьте маппер, переключающий iPad на NumbersAndPunctuation, и проверяйте ввод самостоятельно.

Автор: Marius Bughiu · 7 мин на чтение ·

Если Entry с Keyboard="Numeric" в .NET MAUI 10 при первом касании на iPad открывает маленькую плавающую цифровую панель, а при следующем касании полноразмерную клавиатуру на странице цифр (иногда без десятичной точки, без знака минус или с клавишами, которые вводят не ту цифру), то клавиатуры переключает не MAUI. Это делает iPadOS 26. MAUI сопоставляет Keyboard.Numeric с UIKeyboardType.DecimalPad, а в iPadOS 26 этот тип клавиатуры отображается как компактная плавающая панель, если закреплённой клавиатуры ещё нет. Работающее сегодня исправление: добавить маппинг в EntryHandler.Mapper, чтобы числовые поля на iPad получали UIKeyboardType.NumbersAndPunctuation, и затем проверять текст самостоятельно, потому что на этой клавиатуре можно ввести и буквы. iPhone не затронут и сохраняет обычную десятичную панель.

Ошибка в контексте

Исключения нет. Симптом: клавиатура меняет вид между событиями получения фокуса. На iPad с iPadOS 26.0 или 26.1 и обычным числовым Entry в MAUI:

// .NET 10, Microsoft.Maui.Controls 10.0.x, iPad (10th gen), iPadOS 26.1
1st tap on Entry   -> small floating number pad (digits + decimal key), no Done bar
tap outside        -> keypad dismisses
2nd tap on Entry   -> full-width keyboard, numbers-and-symbols page
type "12.5"        -> field shows unexpected characters on some devices
switch to ABC page and back to 123 -> digits register correctly again

Те, кто ищет решение, обычно описывают лишь часть проблемы: “Keyboard.Numeric not working on iOS”, “no decimal point on iPad numeric keyboard”, “numeric keypad floating on iPad”, “MAUI Done button missing on iPad” или “numbers type random characters on iPad”. Отслеживающая задача MAUI: dotnet/maui#32288 (iPad 8-го поколения, iOS 26.0.1, MAUI 10.0.0-rc.2, помечена как регрессия и всё ещё открыта в бэклоге). То же поведение проявляется во Flutter как flutter/flutter#178096 и в нативных приложениях на UIKit, что и выдаёт: это не баг MAUI.

Почему iPadOS 26 подменяет клавиатуру под числовым Entry в MAUI

Сопоставление клавиатур MAUI для iOS короткое. В KeyboardExtensions.cs в ветке main метод ApplyKeyboard для числового случая делает следующее:

// .NET MAUI main (10.0.x and 11 previews), src/Core/src/Platform/iOS/KeyboardExtensions.cs
else if (keyboard == Keyboard.Numeric)
    textInput.SetKeyboardType(UIKeyboardType.DecimalPad);
else if (keyboard == Keyboard.Telephone)
    textInput.SetKeyboardType(UIKeyboardType.PhonePad);

До iPadOS 26 DecimalPad на iPad просто открывал обычную полную клавиатуру на странице цифр, потому что у iPad никогда не было отдельной цифровой панели. iPadOS 26 это изменил: decimalPad и numberPad теперь показывают компактную плавающую панель только с цифрами. Разработчики столкнулись с тремя отдельными проблемами:

  1. Плавающая панель появляется, только если нет закреплённой клавиатуры. Если пользователь печатал в текстовом поле и переводит фокус на числовое, закреплённая клавиатура остаётся на месте и переключается на страницу цифр. Если числовое поле становится first responder первым, вы получаете плавающую панель. Задача во Flutter документирует именно это: всё работает, когда фокус переходит из текстового поля, и ломается, когда числовое поле получает фокус первым. Поэтому и кажется, что клавиатура “переключается” в зависимости от того, куда пользователь нажал до этого.
  2. Плавающая панель скрывает inputAccessoryView. MAUI прикрепляет собственный MauiDoneAccessoryView к каждому Entry на iOS в EntryHandler.CreatePlatformView(). Тема 801458 на Apple Developer Forums сообщает, что плавающая панель не показывает панель аксессуаров, так что ваша панель Done и любая собственная панель Next/Previous исчезают.
  3. Закрытие и повторный фокус дают полную клавиатуру с некорректным вводом. Тема 808114 (FB21144039) воспроизводит это в собственном приложении Apple “Контакты” на iPadOS с 26.0 по 26.1: нажмите на числовое поле, получите маленькую панель, закройте её, нажмите снова, получите полную клавиатуру на странице цифр, и клавиши будут вводить не те символы, пока вы не переключитесь на страницу букв и обратно.

Ничто из этого MAUI не контролирует, и в UIKit нет API, позволяющего отказаться от плавающей панели. Контролировать можно то, какой UIKeyboardType запрашивает текстовое поле.

Минимальное воспроизведение

<!-- .NET 10, Microsoft.Maui.Controls 10.0.x, run on an iPad with iPadOS 26.0 or 26.1 -->
<ContentPage xmlns="http://schemas.microsoft.com/dotnet/2021/maui"
             xmlns:x="http://schemas.microsoft.com/winfx/2009/xaml"
             x:Class="KeyboardRepro.MainPage">
    <VerticalStackLayout Padding="24" Spacing="16">
        <Entry Placeholder="Amount" Keyboard="Numeric" />
        <Entry Placeholder="Notes" />
    </VerticalStackLayout>
</ContentPage>

Запустите приложение и сначала нажмите на “Amount”: плавающая цифровая панель. Нажмите за пределами поля, снова нажмите на “Amount”: полная клавиатура. Теперь сначала нажмите на “Notes”, затем на “Amount”: закреплённая клавиатура на странице цифр, никакой плавающей панели. Один и тот же код, три разные клавиатуры, и всё определяется исключительно историей фокуса.

Исправление 1: сопоставьте числовые поля с NumbersAndPunctuation на iPad

Это обходной путь, к которому пришли на форуме Apple, переведённый в маппинг обработчика MAUI. NumbersAndPunctuation всегда закрепляется, оставляет панель аксессуаров видимой, имеет десятичный разделитель и знак минус и ведёт себя на iPad одинаково уже много релизов iOS.

Добавьте это в MauiProgram.cs:

// .NET 10, Microsoft.Maui.Controls 10.0.x, iOS/iPadOS 26
using Microsoft.Maui.Handlers;
#if IOS
using UIKit;
#endif

public static class MauiProgram
{
    public static MauiApp CreateMauiApp()
    {
        var builder = MauiApp.CreateBuilder();
        builder.UseMauiApp<App>();

#if IOS
        // Runs after MAUI's own "Keyboard" mapping, so it overrides DecimalPad.
        EntryHandler.Mapper.AppendToMapping(nameof(IEntry.Keyboard), (handler, entry) =>
        {
            if (entry.Keyboard != Keyboard.Numeric)
                return;

            if (UIDevice.CurrentDevice.UserInterfaceIdiom != UIUserInterfaceIdiom.Pad)
                return;

            if (!OperatingSystem.IsIOSVersionAtLeast(26))
                return;

            handler.PlatformView.KeyboardType = UIKeyboardType.NumbersAndPunctuation;
            handler.PlatformView.ReloadInputViews();
        });
#endif

        return builder.Build();
    }
}

Здесь важны три детали:

OperatingSystem.IsIOSVersionAtLeast(26) возвращает true на iPadOS, потому что iPadOS представляется как iOS. Проверка версии оставляет iPad, всё ещё работающие на iPadOS 18, на старом, корректном пути с DecimalPad. Верхнюю границу я намеренно не добавил: Apple не документировала изменение поведения, поэтому проверяйте заново на каждом новом релизе iPadOS, прежде чем удалять маппинг, вместо того чтобы гадать, в какой версии проблема исчезнет.

Исправление 2: проверяйте текст, потому что NumbersAndPunctuation не только для цифр

NumbersAndPunctuation это страница цифр полной клавиатуры. Пользователь может нажать “ABC” и ввести буквы, а также ввести несколько десятичных разделителей. DecimalPad никогда этого не допускал, поэтому код, который делал decimal.Parse(entry.Text) без проверки, начнёт выбрасывать FormatException.

Это исправляет небольшое поведение (behavior), отклоняющее всё, что не может стать числом:

// .NET 10, Microsoft.Maui.Controls 10.0.x
using System.Globalization;

public sealed class DecimalInputBehavior : Behavior<Entry>
{
    protected override void OnAttachedTo(Entry entry)
    {
        entry.TextChanged += OnTextChanged;
        base.OnAttachedTo(entry);
    }

    protected override void OnDetachingFrom(Entry entry)
    {
        entry.TextChanged -= OnTextChanged;
        base.OnDetachingFrom(entry);
    }

    static void OnTextChanged(object? sender, TextChangedEventArgs e)
    {
        if (sender is not Entry entry || string.IsNullOrEmpty(e.NewTextValue))
            return;

        // Appending "0" lets partial input like "-", "12." or "," pass while typing.
        var candidate = e.NewTextValue + "0";
        var ok = decimal.TryParse(
            candidate,
            NumberStyles.AllowLeadingSign | NumberStyles.AllowDecimalPoint,
            CultureInfo.CurrentCulture,
            out _);

        if (!ok)
            entry.Text = e.OldTextValue;
    }
}
<!-- .NET 10, Microsoft.Maui.Controls 10.0.x -->
<Entry Placeholder="Amount" Keyboard="Numeric" ReturnType="Done">
    <Entry.Behaviors>
        <local:DecimalInputBehavior />
    </Entry.Behaviors>
</Entry>

Есть две причины делать это в общем слое, а не перехватывать UITextField.ShouldChangeCharacters на iOS. EntryHandler в MAUI уже владеет этим делегатом, чтобы обеспечивать MaxLength (а на iOS 26 использует более новый вариант с несколькими диапазонами), так что его замена молча ломает MaxLength. Кроме того, поведение защищает и Android с Windows, где с аппаратной клавиатуры в числовое поле можно ввести что угодно.

Разбор с CultureInfo.CurrentCulture важен. На немецком iPad страница цифр показывает запятую, и "12,5" должно успешно разбираться. Если ваш бэкенд ожидает инвариантный ввод, преобразуйте значение один раз при чтении, а не во время ввода.

Исправление 3: верните клавишу Done на iPad

С DecimalPad на iPhone MauiDoneAccessoryView из MAUI даёт вам кнопку Done, потому что у десятичной панели iPhone нет клавиши return. У NumbersAndPunctuation клавиша return есть, так что задайте ReturnType="Done" (как в XAML выше) и обработайте Completed:

// .NET 10, Microsoft.Maui.Controls 10.0.x
AmountEntry.Completed += (_, _) =>
{
    AmountEntry.Unfocus();
    // Commit the value, move focus to the next field, etc.
};

На iPhone ничего не меняется: маппинг из исправления 1 там никогда не выполняется, десятичная панель остаётся, и панель аксессуаров с Done продолжает работать.

Включение для отдельных Entry вместо глобального

Глобальный маппинг меняет каждый числовой Entry в приложении, включая те, что находятся внутри сторонних элементов управления. Если нужно применить его только к некоторым полям, создайте подкласс Entry и проверяйте тип в маппинге:

// .NET 10, Microsoft.Maui.Controls 10.0.x
public class AmountEntry : Entry
{
    public AmountEntry() => Keyboard = Keyboard.Numeric;
}

#if IOS
EntryHandler.Mapper.AppendToMapping(nameof(IEntry.Keyboard), (handler, entry) =>
{
    if (entry is AmountEntry &&
        UIDevice.CurrentDevice.UserInterfaceIdiom == UIUserInterfaceIdiom.Pad &&
        OperatingSystem.IsIOSVersionAtLeast(26))
    {
        handler.PlatformView.KeyboardType = UIKeyboardType.NumbersAndPunctuation;
        handler.PlatformView.ReloadInputViews();
    }
});
#endif

Маппер по-прежнему глобальный (это статический член EntryHandler), но проверка типа ограничивает эффект. Это тот же шаблон, который MAUI использует для любой платформенной настройки, не вынесенной в свойство; документация по настройке обработчиков на Microsoft Learn подробно описывает порядок выполнения AppendToMapping.

Подводные камни и похожие проблемы

Связанные материалы

Источники

2026-09-27 errorsdotnetdotnet-10
Исправление: MediaPicker.CapturePhotoAsync возвращает PNG вместо JPEG в .NET MAUI 10
На iOS MAUI 10 перекодирует снимки с камеры в PNG, если CompressionQuality равно 90 или выше и не задан MaximumWidth/Height, что включает значение по умолчанию. Установите CompressionQuality на 89 или ниже либо добавьте MaximumWidth только для iOS.
2026-09-16 errorsdotnetdotnet-10
Исправление: UIKitThreadAccessException в MediaPicker.PickPhotosAsync при выборе нескольких фотографий в .NET MAUI iOS
Выбор 2 и более фотографий в iOS вызывает UIKitThreadAccessException в MAUI 10.0.100 и 10.0.101. MAUI читает PHPickerResult.ItemProvider после await, вне главного потока. Зафиксируйте 10.0.90, обновитесь до 10.0.110 или вызовите PHPicker сами.
2026-08-30 errorsef-coremaui
Исправление: Model building is not supported when publishing with NativeAOT в сборке .NET MAUI для iOS
Сборки для iOS выставляют DynamicCodeSupport=false, поэтому EF Core отказывается строить модель, даже если вы никогда не включали NativeAOT. Поставляйте скомпилированную модель и предкомпилированные запросы либо снова включите интерпретатор.

Comments

Sign in with GitHub to comment. Reactions and replies thread back to the comments repo.

< Назад