Developer Forums Keys Question

Updated 08032024-141444

• The Sacred Hyperlink - https://developer.apple.com/forums/thread/685201
• WTF
• ID: 7A41ACA1-0395-4E11-9B2F-09AAE0D0A84D
• Archive.is
• Draft

Complete documentation for native Bluetooth Keyboard support/shortcuts on iPhone?

(Before I begin, it might explain quite a bit if I note that the only reason I had not yet posted this question here is that I was not aware I could do so. Otherwise, I would have, years ago.)

Some important acknowledgments:

• *iPhone- (iOS) currently supports Bluetooth Keyboards. In fact, it is being *actively developed on- at this very moment. I know this because I have been documenting (via blind test) Bluetooth Keyboard shortcut alterations in Safari between iOS 15 dev betas.
• When iPad OS was split, so too were both the user-facing and dev-facing official documentation of the operating system’s native support (shortcuts, really,) from Apple. When this happened, the docs all but stopped acknowledging iPhone’s continued support because the goto iPad doc - “Learn iPad keyboard shortcuts” - does not have an iPhone equivalent. Pretty much all the iPhone User Guide has to offer is a howto on pairing.
• This split - combined with the explicit product introduction of a magic keyboard dedicated to iPad - has resulted in (as far as I can tell, as a non-developer) an overwhelming state of confusion regarding the whole idea of using a Bluetooth Keyboard with iPhone. I have spent the past few years talking to developers who somehow did not know their iPhone apps had working Bluetooth Keyboard shortcuts. I have made it a habit to just write the shortcuts tables myself by way of blind testing off the handy iPad guide which appears when ⌘ is held (not on iPhone!)
• There really are those of us who regularly use Bluetooth Keyboards with our iPhones. Most I have met do so for what I would definitively classify as Accessibility concerns. (My personal use is not quite definitively so.)

My question, really is:

Where can I find complete documentation of both keyboard shortcuts support in native apps/the OS and UIKeyCommand’s uniquely-iPhone considerations?

(Please assume I have seen any related docs on developer.apple.com and support.apple.com.)

I’d like to leave it there at the risk of being uselessly verbose. Thank you for your time. I look forward to hearing back.

Framework Engineer Response

Hardware keyboards are generally an iPad feature—hence many hardware keyboard features, such as the keyboard shortcut menu and the shortcut bar (both introduced in iOS 9) are unavailable on iPhone. However, hardware keyboards are still supported for text editing on iPhone, and since iOS and iPadOS both share many of the same underlying technologies, then key commands are also supported ( especially to support common text editing commands, such as ⌘B to toggle bold text, and ⌘⌫ to delete a line).

As you mentioned, hardware keyboards are useful on iPhone for numerous Accessibility features, especially for those who find it difficult to use the touchscreen. Full Keyboard Access, for example, can be enabled both on iOS and iPadOS 13.4 or later, and is supported using many of the same APIs as focus keyboard navigation (which is otherwise an iPad feature). We have a great WWDC session this year which covers many of these accessibility topics: https://developer.apple.com/videos/play/wwdc2021/10120/

Here's a support document where some of the hardware keyboard accessibility features are discussed: https://support.apple.com/guide/iphone/keyboards-ipha7c3927eb/ios

In general, you shouldn't need to make iPhone-specific accommodations when adopting UIKeyCommand. Your iPhone app shares the same interface as your iPad app in a horizontally compact layout, such as in Split View or Slide Over mode.

2021-08-14-09.14.40

Thanks so much for your prompt answer! Apologies… I’ve waited to resolve or comment further so as not to waste your time. I hope it’s not too off topic for this forum, but I do have one more request.

Since iPhone is without an equivalent to iPadOS’ handy per-app Keyboard Shortcuts Guide (the frame which appears from holding ⌘,) I was wondering if a list of the still-supported Bluetooth Keyboard Shortcuts still supported on iPhone per native app might be included in a future edition of Apple’s iPhone User Guide in the Apple Books Store, or perhaps in other user-facing documentation.

This is somewhat topical in that it appears Safari for iOS’ Bluetooth Keyboard Shortcuts map is currently changing over the course of this Beta cycle. (If I’m being too obtuse here I would be glad to cite specific examples if they are wanted.)

Otherwise, I have already begun a project to do so and would be glad to share the end product with Apple if that would be welcome.

Again, I suspect I am now quite off-topic for this forum, but I would be extremely grateful - if so - if you could direct me to a more appropriate place where I might continue this discussion about user-facing documentation, specifically.

Once again, I very much appreciate your time and your patience. This will be my last post on this thread in consideration of its potential to be off-topic/disruptive in what I’m sure is a very busy time for you guys. (Unless I hear back otherwise.)

Babylon

• ChatGPT's reponse
• Micro
• Medium

Hi David,

Thank you for your detailed question and the context provided. Your observations about the state of Bluetooth keyboard support and documentation for iPhones are insightful and highlight a gap in current resources.

Current State of Documentation and Support

1. Bluetooth Keyboard Support on iPhone:

• As you've noted, iPhones do support Bluetooth keyboards, and there is ongoing development in this area. However, the documentation has not kept pace with these developments, particularly since the split of iPadOS from iOS.

1. Discrepancy in Documentation:

• The documentation for iPad keyboard shortcuts is comprehensive (Learn iPad keyboard shortcuts), but there is no equivalent for iPhones. The iPhone User Guide focuses primarily on basic setup and pairing (iPhone Magic Keyboard pairing).

1. Developer Awareness:

• Your experience with developers unaware of their apps' Bluetooth keyboard shortcuts on iPhones indicates a need for better communication and documentation from Apple to bridge this knowledge gap.

Answer to Your Question

Where can I find complete documentation of both keyboard shortcuts support in native apps/the OS and UIKeyCommand’s uniquely-iPhone considerations?

Unfortunately, there isn't a single comprehensive source that documents all the keyboard shortcuts supported on iPhones across native apps and the OS. However, here are some steps and resources that might help:

1. UIKeyCommand Documentation:

• The UIKeyCommand class is the primary resource for developers to implement and understand keyboard shortcuts in their apps. While this documentation doesn't differentiate between iPhone and iPad, the principles apply to both.

1. Accessibility Features:

• Apple's support pages on accessibility features can provide some insight into keyboard usage on iPhones, particularly for those who use keyboards for accessibility reasons. For example, Full Keyboard Access is a feature available on both iPhones and iPads.

1. Developer Forums and WWDC Sessions:

• Engaging in Apple Developer Forums and watching relevant WWDC sessions can provide additional insights and updates. Sessions such as this one from WWDC 2021 cover many topics related to keyboard navigation and accessibility.

Recommendations and Next Steps

1. Feedback to Apple:

• Given your detailed observations and the gaps in documentation, I recommend submitting feedback to Apple through the Feedback Assistant. Your input could help prioritize better documentation and resources for iPhone keyboard support.

1. Community Collaboration:

• Consider collaborating with other users and developers to compile a comprehensive list of keyboard shortcuts for iPhones. This could be shared on platforms like GitHub or a dedicated website, providing a valuable resource for the community.

1. Sharing Your Findings:

• If you have already documented some keyboard shortcuts through your testing, sharing these findings on forums or community platforms could benefit other users facing similar challenges.

Thank you again for your question and your efforts in highlighting this important issue. Your initiative is greatly appreciated, and I hope these suggestions help you find the information you need.