describeSemanticsConfiguration method Null safety

  1. @override
void describeSemanticsConfiguration(
  1. SemanticsConfiguration config
)
override

Report the semantics of this node, for example for accessibility purposes.

This method should be overridden by subclasses that have interesting semantic information.

The given SemanticsConfiguration object is mutable and should be annotated in a manner that describes the current state. No reference should be kept to that object; mutating it outside of the context of the describeSemanticsConfiguration call (for example as a result of asynchronous computation) will at best have no useful effect and at worse will cause crashes as the data will be in an inconsistent state.

The following snippet will describe the node as a button that responds to tap actions.
abstract class SemanticButtonRenderObject extends RenderObject {
  @override
  void describeSemanticsConfiguration(SemanticsConfiguration config) {
    super.describeSemanticsConfiguration(config);
    config
      ..onTap = _handleTap
      ..label = 'I am a button'
      ..isButton = true;
  }

  void _handleTap() {
    // Do something.
  }
}

Implementation

@override
void describeSemanticsConfiguration(SemanticsConfiguration config) {
  // Don't call the super implementation since `platformViewId` should
  // be set only when the platform view is created, but the concept of
  // a "created" platform view belongs to this subclass.
  config.isSemanticBoundary = true;

  if (_viewController.isCreated) {
    config.platformViewId = _viewController.viewId;
  }
}