Commit c0283d85 authored by Dan Field's avatar Dan Field Committed by Flutter GitHub Bot

Deprecate UpdateLiveRegionEvent (#45940)

parent df0b3fed
......@@ -788,12 +788,10 @@ class SemanticsProperties extends DiagnosticableTree {
/// If non-null, whether the node should be considered a live region.
///
/// On Android, when a live region semantics node is first created TalkBack
/// will make a polite announcement of the current label. This announcement
/// occurs even if the node is not focused. Subsequent polite announcements
/// can be made by sending a [UpdateLiveRegionEvent] semantics event. The
/// announcement will only be made if the node's label has changed since the
/// last update.
/// On Android, when the label changes on a live region semantics node,
/// TalkBack will make a polite announcement of the current label. This
/// announcement occurs even if the node is not focused, but only if the label
/// has changed since the last update.
///
/// On iOS, no announcements are made but the node is marked as
/// `UIAccessibilityTraitUpdatesFrequently`.
......@@ -807,7 +805,6 @@ class SemanticsProperties extends DiagnosticableTree {
///
/// * [SemanticsFlag.liveRegion], the semantics flag this setting controls.
/// * [SemanticsConfiguration.liveRegion], for a full description of a live region.
/// * [UpdateLiveRegionEvent], to trigger a polite announcement of a live region.
final bool liveRegion;
/// The maximum number of characters that can be entered into an editable
......@@ -3522,12 +3519,10 @@ class SemanticsConfiguration {
/// Whether the semantics node is a live region.
///
/// On Android, when a live region semantics node is first created TalkBack
/// will make a polite announcement of the current label. This announcement
/// occurs even if the node is not focused. Subsequent polite announcements
/// can be made by sending a [UpdateLiveRegionEvent] semantics event. The
/// announcement will only be made if the node's label has changed since the
/// last update.
/// On Android, when the label changes on a live region semantics node,
/// TalkBack will make a polite announcement of the current label. This
/// announcement occurs even if the node is not focused, but only if the label
/// has changed since the last update.
///
/// An example of a live region is the [Snackbar] widget. When it appears
/// on the screen it may be difficult to focus to read the label. A live
......
......@@ -144,6 +144,12 @@ class TapSemanticEvent extends SemanticsEvent {
/// See also:
///
/// * [SemanticsFlag.liveRegion], for a description of live regions.
///
/// Deprecated. This message was never implemented, and references to it should be removed.
@Deprecated(
'This event has never been implemented and will be removed in a future version of Flutter. References to it should be removed. '
'This feature was deprecated after v1.12.16.'
)
class UpdateLiveRegionEvent extends SemanticsEvent {
/// Creates a new [UpdateLiveRegionEvent].
const UpdateLiveRegionEvent() : super('updateLiveRegion');
......
Markdown is supported
0% or
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment