hitTestChildren method

@override bool hitTestChildren(BoxHitTestResult result, { required Offset position, })

Override this method to check whether any children are located at the given position.

Subclasses should return true if at least one child reported a hit at the specified position.

Typically children should be hit-tested in reverse paint order so that hit tests at locations where children overlap hit the child that is visually "on top" (i.e., paints later).

The caller is responsible for transforming position from global coordinates to its location relative to the origin of this RenderBox. Likewise, this RenderBox is responsible for transforming the position that it passes to its children when it calls hitTest on each child.

If transforming is necessary, BoxHitTestResult.addWithPaintTransform, BoxHitTestResult.addWithPaintOffset, or BoxHitTestResult.addWithRawTransform need to be invoked by subclasses to record the required transform operations in the BoxHitTestResult. These methods will also help with applying the transform to position.

Used by hitTest. If you override hitTest and do not call this function, then you don't need to implement this function.

Implementation

@override
bool hitTestChildren(BoxHitTestResult result, { required Offset position }) {
  // The x, y parameters have the top left of the node's box as the origin.
  // Get the sliver content scrolling offset.
  final Offset currentOffset = Offset(scrollLeft, scrollTop);

  // The z-index needs to be sorted, and higher-level nodes are processed first.
  for (int i = paintingOrder.length - 1; i >= 0; i--) {
    RenderBox child = paintingOrder[i];
    // Ignore detached render object.
    if (!child.attached) continue;

    final ContainerBoxParentData childParentData = child.parentData as ContainerBoxParentData<RenderBox>;
    final bool isHit = result.addWithPaintOffset(
      offset: childParentData.offset + currentOffset,
      position: position,
      hitTest: (BoxHitTestResult result, Offset transformed) {
        return child.hitTest(result, position: transformed);
      },
    );
    if (isHit) return true;
  }

  return false;
}