scheduleBuildFor method

Implementation

void scheduleBuildFor(Element element) {
  assert(element.owner == this);
  assert(element._parentBuildScope != null);
  assert(() {
    if (debugPrintScheduleBuildForStacks) {
      debugPrintStack(label: 'scheduleBuildFor() called for $element${element.buildScope._dirtyElements.contains(element) ? " (ALREADY IN LIST)" : ""}');
    }
    if (!element.dirty) {
      throw FlutterError.fromParts(<DiagnosticsNode>[
        ErrorSummary('scheduleBuildFor() called for a widget that is not marked as dirty.'),
        element.describeElement('The method was called for the following element'),
        ErrorDescription(
          'This element is not current marked as dirty. Make sure to set the dirty flag before '
          'calling scheduleBuildFor().',
        ),
        ErrorHint(
          'If you did not attempt to call scheduleBuildFor() yourself, then this probably '
          'indicates a bug in the widgets framework. Please report it:\n'
          '  https://github.com/flutter/flutter/issues/new?template=2_bug.yml',
        ),
      ]);
    }
    return true;
  }());
  final BuildScope buildScope = element.buildScope;
  assert(() {
    if (debugPrintScheduleBuildForStacks && element._inDirtyList) {
      debugPrintStack(
        label: 'BuildOwner.scheduleBuildFor() called; '
                '_dirtyElementsNeedsResorting was ${buildScope._dirtyElementsNeedsResorting} (now true); '
                'The dirty list for the current build scope is: ${buildScope._dirtyElements}',
      );
    }
    if (!_debugBuilding && element._inDirtyList) {
      throw FlutterError.fromParts(<DiagnosticsNode>[
        ErrorSummary('BuildOwner.scheduleBuildFor() called inappropriately.'),
        ErrorHint(
          'The BuildOwner.scheduleBuildFor() method called on an Element '
          'that is already in the dirty list.',
        ),
        element.describeElement('the dirty Element was'),
      ]);
    }
    return true;
  }());
  if (!_scheduledFlushDirtyElements && onBuildScheduled != null) {
    _scheduledFlushDirtyElements = true;
    onBuildScheduled!();
  }
  buildScope._scheduleBuildFor(element);
  assert(() {
    if (debugPrintScheduleBuildForStacks) {
      debugPrint("...the build scope's dirty list is now: $buildScope._dirtyElements");
    }
    return true;
  }());
}