Skip to content

UISelectionFeedbackGenerator ​

UISelectionFeedbackGenerator represents a selection feedback generator: a very light tap of vibration when the selection moves from one item to another, such as a picker wheel turning one notch, a slider passing a tick mark, or the selected row of a list changing.

It only produces the vibration and knows nothing about what is selected in the UI. Your code calls selectionChanged() when the selection changes.

Inheritance: EventTarget → NSObject → UIFeedbackGenerator → UISelectionFeedbackGenerator

In the simulator, or when the user has turned off haptics, calls do not throw but produce no vibration; see When there is no vibration.

Constructor ​

It cannot be created with new; use UISelectionFeedbackGenerator.feedbackGeneratorForView(). Using new throws TypeError, and the message names the static method to use.

Static methods ​

UISelectionFeedbackGenerator.feedbackGeneratorForView()

Creates a generator bound to a view.

Instance methods ​

Also inherits prepare() from UIFeedbackGenerator.

MethodDescription
selectionChanged()Vibrates very lightly once

Examples ​

js
const page = new UIViewController();
const tick = UISelectionFeedbackGenerator.feedbackGeneratorForView(page.view);

/** @param {number} index */
function onSelect(index) {
  tick.selectionChanged();
  console.log('Selected item ' + index);
}

onSelect(2);

Effect: a very light vibration, and the console logs Selected item 2. The vibration is not verified in the simulator.

Corresponding iOS API ​

ObjCJS
[UISelectionFeedbackGenerator feedbackGeneratorForView:view]UISelectionFeedbackGenerator.feedbackGeneratorForView(view)
[generator selectionChanged]generator.selectionChanged()

See also ​