binding.dart 2.33 KB
Newer Older
Ian Hickson's avatar
Ian Hickson committed
1
// Copyright 2014 The Flutter Authors. All rights reserved.
2 3 4
// Use of this source code is governed by a BSD-style license that can be
// found in the LICENSE file.

5
import 'dart:ui' as ui show AccessibilityFeatures, SemanticsUpdateBuilder;
6 7 8

import 'package:flutter/foundation.dart';

9 10
import 'debug.dart';

11
export 'dart:ui' show AccessibilityFeatures;
12 13 14

/// The glue between the semantics layer and the Flutter engine.
// TODO(jonahwilliams): move the remaining semantic related bindings here.
15
mixin SemanticsBinding on BindingBase {
16
  /// The current [SemanticsBinding], if one has been created.
17 18
  static SemanticsBinding? get instance => _instance;
  static SemanticsBinding? _instance;
19 20 21 22 23

  @override
  void initInstances() {
    super.initInstances();
    _instance = this;
24
    _accessibilityFeatures = window.accessibilityFeatures;
25 26 27 28
  }

  /// Called when the platform accessibility features change.
  ///
29
  /// See [dart:ui.PlatformDispatcher.onAccessibilityFeaturesChanged].
30 31
  @protected
  void handleAccessibilityFeaturesChanged() {
32
    _accessibilityFeatures = window.accessibilityFeatures;
33 34
  }

35 36 37 38 39 40 41 42 43 44
  /// Creates an empty semantics update builder.
  ///
  /// The caller is responsible for filling out the semantics node updates.
  ///
  /// This method is used by the [SemanticsOwner] to create builder for all its
  /// semantics updates.
  ui.SemanticsUpdateBuilder createSemanticsUpdateBuilder() {
    return ui.SemanticsUpdateBuilder();
  }

45 46 47 48 49 50
  /// The currently active set of [AccessibilityFeatures].
  ///
  /// This is initialized the first time [runApp] is called and updated whenever
  /// a flag is changed.
  ///
  /// To listen to changes to accessibility features, create a
51 52
  /// [WidgetsBindingObserver] and listen to
  /// [WidgetsBindingObserver.didChangeAccessibilityFeatures].
53
  ui.AccessibilityFeatures get accessibilityFeatures => _accessibilityFeatures;
54
  late ui.AccessibilityFeatures _accessibilityFeatures;
55 56 57

  /// The platform is requesting that animations be disabled or simplified.
  ///
58
  /// This setting can be overridden for testing or debugging by setting
59 60 61 62 63
  /// [debugSemanticsDisableAnimations].
  bool get disableAnimations {
    bool value = _accessibilityFeatures.disableAnimations;
    assert(() {
      if (debugSemanticsDisableAnimations != null)
64
        value = debugSemanticsDisableAnimations!;
65 66 67 68 69
      return true;
    }());
    return value;
  }
}