BannerAdView class

A widget that displays a banner ad using an Android AdView PlatformView.

The widget requires a bounded height. Provide an explicit height, or wrap it in a SizedBox/AspectRatio. Adaptive banners resolve their own height natively; the height you provide is the reserved slot in the Flutter layout (collapsed size for collapsible banners).

On Android this uses Hybrid Composition (initSurfaceAndroidView) so collapsible expand overlays are not trapped inside a Virtual Display texture.

On non-Android platforms this widget renders placeholder (or an empty box).

Inheritance

Constructors

BannerAdView({Key? key, required String adUnitId, required AdSize size, double? height, AdRequest request = const AdRequest(), BannerAdListener? listener, BannerAdController? controller, Widget? placeholder})
Creates a BannerAdView.
const

Properties

adUnitId String
The AdMob ad unit ID.
final
controller BannerAdController?
Optional controller for manual BannerAdController.refresh.
final
hashCode int
The hash code for this object.
no setterinherited
height double?
Reserved height in dp. Required for adaptive sizes; for fixed sizes it defaults to the size's own height.
final
key Key?
Controls how one widget replaces another widget in the tree.
finalinherited
listener BannerAdListener?
Lifecycle callbacks.
final
placeholder Widget?
Widget shown when the ad fails to load, or on unsupported platforms.
final
request AdRequest
Per-request targeting and extras (for example collapsible configuration).
final
runtimeType Type
A representation of the runtime type of the object.
no setterinherited
size AdSize
The requested AdSize.
final

Methods

createElement() StatefulElement
Creates a StatefulElement to manage this widget's location in the tree.
inherited
createState() State<BannerAdView>
Creates the mutable state for this widget at a given location in the tree.
override
debugDescribeChildren() List<DiagnosticsNode>
Returns a list of DiagnosticsNode objects describing this node's children.
inherited
debugFillProperties(DiagnosticPropertiesBuilder properties) → void
Add additional properties associated with the node.
inherited
noSuchMethod(Invocation invocation) → dynamic
Invoked when a nonexistent method or property is accessed.
inherited
toDiagnosticsNode({String? name, DiagnosticsTreeStyle? style}) DiagnosticsNode
Returns a debug representation of the object that is used by debugging tools and by DiagnosticsNode.toStringDeep.
inherited
toString({DiagnosticLevel minLevel = DiagnosticLevel.info}) String
A string representation of this object.
inherited
toStringDeep({String prefixLineOne = '', String? prefixOtherLines, DiagnosticLevel minLevel = DiagnosticLevel.debug, int wrapWidth = 65}) String
Returns a string representation of this node and its descendants.
inherited
toStringShallow({String joiner = ', ', DiagnosticLevel minLevel = DiagnosticLevel.debug}) String
Returns a one-line detailed description of the object.
inherited
toStringShort() String
A short, textual description of this widget.
inherited

Operators

operator ==(Object other) bool
The equality operator.
inherited