Getting Started with 3D Touch
With iOS 9, new iPhone models add a third dimension to the user interface.
A user can now press your Home screen icon to immediately access functionality provided by your app.
Within your app, a user can now press views to see previews of additional content and gain accelerated access to features.
To dive right in with sample code, download the following Xcode projects:
ApplicationShortcuts: Using UIApplicationShortcutItems, which demonstrates Home screen static and dynamic quick actions
ViewControllerPreviews: Using the UIViewController previewing APIs, which demonstrates peek (preview) and pop (commit), as well as peek quick actions
TouchCanvas: Using UITouch efficiently and effectively, which demonstrates the new force properties in the
UITouch
class
Before you begin adoption, be sure to read 3D Touch in iOS Human Interface Guidelines.
Home Screen Quick Actions
A user has always been able to tap an app icon to launch it, or touch and hold any app to edit the Home screen. Now, by pressing an app icon on an iPhone 6s or iPhone 6s Plus, the user obtains a set of quick actions. When the user selects a quick action, your app activates or launches and your app delegate object receives the quick action message.
The best quick actions anticipate and accelerate a user’s interaction with your app. The iOS 9 SDK offers APIs that let you define static or dynamic quick actions, available to users with new iPhone models.
Define static quick actions in your app’s
Info.plist
file in the UIApplicationShortcutItems array.Define dynamic quick actions with the
UIApplicationShortcutItem
class and associated APIs. Add your dynamic quick actions to your app’s sharedUIApplication
object using the newshortcutItems
property.
Both types of quick action can display up to two lines of text along with an optional icon.
Peek and Pop
You can now enable the view controllers in your app (instances of the UIViewController
class) to respond to user presses of various intensities. As the user presses more deeply, interaction proceeds through three phases:
Indication that content preview is available
Display of the preview—known as a peek—with options to act on it directly—known as peek quick actions
Optional navigation to the view shown in the preview—known as a pop
When you employ peek and pop, the system determines the pressures at which one phase transitions to the next. The user can tune the transitions in Settings > General > Accessibility > 3D Touch.
Indication of peek availability
With a light press, surrounding content blurs to tell the user a preview of additional content—the peek—is available.
Peek
Press a bit more deeply and the view transitions to show the peek, a view which you typically configure to display more content—as the Mail app does here.
If the user ends the touch at this point, the peek disappears and the app returns to its state before the interaction started.
Alternatively at this point, the user can press deeper still on the peek itself to navigate, using the system-provided pop transition, to the view being previewed as a peek: The pop view then fills your app’s root view and displays a button to navigate back to where the interaction began. (This final phase—display of the pop view—is not shown here.)
Peek quick actions
If instead of ending the touch, the user swipes the peek upward, the system shows the peek quick actions you’ve associated with the peek.
Each peek quick action is a deep link into your app. With a peek’s quick actions visible, the user can end the touch and the peek remains onscreen. This allows the user to tap a quick action, invoking the associated deep link.
You can also enable peek and pop for links in web views, as described in Web View Peek and Pop.
Force Properties
In iOS 9, the UITouch
class has two new properties to support custom implementation of 3D Touch in your app: force
and maximumPossibleForce
. For the first time on iOS devices, these properties let you detect and respond to touch pressure in the UIEvent
objects your app receives.
The force of a touch has a high dynamic range, available as a floating point value to your app.
Accessibility and Human Interface Guidelines for 3D Touch
To ensure that all your users can access your app’s features, branch your code depending on whether 3D Touch is available. See Checking for 3D Touch Availability.
When 3D Touch is available, take advantage of its capabilities. When it is not available, provide alternatives such as by employing touch and hold.
3D Touch features support VoiceOver. To learn about VoiceOver, read Accessibility Programming Guide for iOS.
For important guidance on the new features available with 3D Touch, read 3D Touch in iOS Human Interface Guidelines.
Development Environment
Xcode 7 supports 3D Touch development. All the debugging features of Xcode are available for implementing the new features. Starting with Xcode 7.1 you can configure 3D Touch segues using Interface Builder as described in Adding 3D Touch Segues.
Be sure to test your app with 3D Touch both enabled and disabled, ensuring that all features are available to all users. On a 3D Touch device, you can disable 3D Touch in Settings > General > Accessibility > 3D Touch.
Copyright © 2018 Apple Inc. All rights reserved. Terms of Use | Privacy Policy | Updated: 2016-09-13