1
0
Fork 0
mirror of https://github.com/juce-framework/JUCE.git synced 2026-01-28 02:30:05 +00:00
JUCE/modules/juce_gui_basics/components
reuk 2fc7d12ae7 TextEditor: Add option to dismiss the virtual keyboard on touches outside
Previously, individual components had to ask the peer to hide and show
the keyboard, by calling textInputRequired() and
dismissPendingTextInput() respectively. When an onscreen keyboard (OSK)
was required, most Peer implementation would directly hide/show the OSK
inside these function. However, the iOS ComponentPeer implementation
instead listened to the application's global keyboard focus, and only
opened the OSK when the focused component was also a TextInputTarget
with active input.

The iOS scheme seems like a better design, as it enforces that the OSK
hiding and showing is synced with the keyboard focus of the application.
In the other implementations, it was possible for a Component to call
textInputRequired even when it didn't have the keyboard focus, putting
the application into an inconsistent state. The iOS scheme also makes
the TextInputTarget interface more useful, as it enforces that the OSK
will only display for components that implement TextInputTarget, and
return true from isTextInputActive().

This patch changes all Peer implementations to match the iOS
implementation, improving consistency. Each time the global keyboard
focus changes, refreshTextInputTarget is called automatically, and the
OSK is shown if the focused component is a TextInputTarget that returns
true from isTextInputActive, and hidden otherwise. Components can also
call refreshTextInputTarget manually. This should be done whenever the
component updates the return value of isTextInputActive(). Effectively,
the Peer is now responsible for keeping track of the focused
TextInputTarget, rather than allowing individual components to hide and
show the OSK at will.

Additionally, this patch adds an option to the TextEditor to
automatically dismiss the OSK when the mouse is clicked outside of the
editor. This should improve user experience on mobile platforms, where
touches on sibling components may cause a TextEditor to gain keyboard
focus and unnecessarily display the OSK.
2022-06-08 19:51:11 +01:00
..
juce_CachedComponentImage.h Updated all license headers 2020-06-29 08:30:22 +01:00
juce_Component.cpp TextEditor: Add option to dismiss the virtual keyboard on touches outside 2022-06-08 19:51:11 +01:00
juce_Component.h Disable the effect of setPaintingIsUnclipped on components with children 2022-03-17 22:06:04 +00:00
juce_ComponentListener.cpp Updated all license headers 2020-06-29 08:30:22 +01:00
juce_ComponentListener.h Updated all license headers 2020-06-29 08:30:22 +01:00
juce_ComponentTraverser.h Accessibility: Added VoiceOver (macOS) and Narrator (Windows) accessibility screen reader support to juce_gui_basics 2021-05-10 10:53:14 +01:00
juce_FocusTraverser.cpp Take MessageManagerLock in FocusTraverser and KeyboardFocusTraverser unit tests 2021-09-29 11:45:06 +01:00
juce_FocusTraverser.h Accessibility: Added VoiceOver (macOS) and Narrator (Windows) accessibility screen reader support to juce_gui_basics 2021-05-10 10:53:14 +01:00
juce_ModalComponentManager.cpp Whitespace 2021-07-28 16:03:22 +01:00
juce_ModalComponentManager.h ModalCallbackFunction: Use NullCheckedInvocation helper to fix potential crash due to calling null std::function 2021-07-22 16:33:42 +01:00