InkWell class

A rectangular area of a Material that responds to touch.

For a variant of this widget that does not clip splashes, see InkResponse.

The following diagram shows how an InkWell looks when tapped, when using default values.

The highlight is a rectangle the size of the box.

The InkWell widget must have a Material widget as an ancestor. The Material widget is where the ink reactions are actually painted. This matches the material design premise wherein the Material is what is actually reacting to touches by spreading ink.

If a Widget uses this class directly, it should include the following line at the top of its build function to call debugCheckHasMaterial:

assert(debugCheckHasMaterial(context));

Troubleshooting

The ink splashes aren't visible!

If there is an opaque graphic, e.g. painted using a Container, Image, or DecoratedBox, between the Material widget and the InkWell widget, then the splash won't be visible because it will be under the opaque graphic. This is because ink splashes draw on the underlying Material itself, as if the ink was spreading inside the material.

The Ink widget can be used as a replacement for Image, Container, or DecoratedBox to ensure that the image or decoration also paints in the Material itself, below the ink.

If this is not possible for some reason, e.g. because you are using an opaque CustomPaint widget, alternatively consider using a second Material above the opaque widget but below the InkWell (as an ancestor to the ink well). The MaterialType.transparency material kind can be used for this purpose.

Constructors

InkWell({Key key, Widget child, GestureTapCallback onTap, GestureTapCallback onDoubleTap, GestureLongPressCallback onLongPress, GestureTapDownCallback onTapDown, GestureTapCancelCallback onTapCancel, ValueChanged<bool> onHighlightChanged, Color highlightColor, Color splashColor, InteractiveInkFeatureFactory splashFactory, double radius, BorderRadius borderRadius, ShapeBorder customBorder, bool enableFeedback: true, bool excludeFromSemantics: false }): Creates an ink well. [...]
const

Properties

borderRadius → BorderRadius: The clipping radius of the containing rect. This is effective only if customBorder is null. [...]
final, inherited
child → Widget: The widget below this widget in the tree. [...]
final, inherited
containedInkWell → bool: Whether this ink response should be clipped its bounds. [...]
final, inherited
customBorder → ShapeBorder: The custom clip border which overrides borderRadius.
final, inherited
enableFeedback → bool: Whether detected gestures should provide acoustic and/or haptic feedback. [...]
final, inherited
excludeFromSemantics → bool: Whether to exclude the gestures introduced by this widget from the semantics tree. [...]
final, inherited
hashCode → int: The hash code for this object. [...]
read-only, inherited
highlightColor → Color: The highlight color of the ink response. If this property is null then the highlight color of the theme, ThemeData.highlightColor, will be used. [...]
final, inherited
highlightShape → BoxShape: The shape (e.g., circle, rectangle) to use for the highlight drawn around this part of the material. [...]
final, inherited
key → Key: Controls how one widget replaces another widget in the tree. [...]
final, inherited
onDoubleTap → GestureTapCallback: Called when the user double taps this part of the material.
final, inherited
onHighlightChanged → ValueChanged<bool>: Called when this part of the material either becomes highlighted or stops being highlighted. [...]
final, inherited
onLongPress → GestureLongPressCallback: Called when the user long-presses on this part of the material.
final, inherited
onTap → GestureTapCallback: Called when the user taps this part of the material.
final, inherited
onTapCancel → GestureTapCallback: Called when the user cancels a tap that was started on this part of the material.
final, inherited
onTapDown → GestureTapDownCallback: Called when the user taps down this part of the material.
final, inherited
radius → double: The radius of the ink splash. [...]
final, inherited
runtimeType → Type: A representation of the runtime type of the object.
read-only, inherited
splashColor → Color: The splash color of the ink response. If this property is null then the splash color of the theme, ThemeData.splashColor, will be used. [...]
final, inherited
splashFactory → InteractiveInkFeatureFactory: Defines the appearance of the splash. [...]
final, inherited

Methods

createElement() → StatefulElement: Creates a StatefulElement to manage this widget's location in the tree. [...]
inherited
createState() → _InkResponseState<InkResponse>: Creates the mutable state for this widget at a given location in the tree. [...]
inherited
debugCheckContext(BuildContext context) → bool: Asserts that the given context satisfies the prerequisites for this class. [...]
@mustCallSuper, inherited
debugDescribeChildren() → List<DiagnosticsNode>: Returns a list of DiagnosticsNode objects describing this node's children. [...]
@protected, inherited
debugFillProperties(DiagnosticPropertiesBuilder properties) → void: Add additional properties associated with the node. [...]
inherited
getRectCallback(RenderBox referenceBox) → RectCallback: The rectangle to use for the highlight effect and for clipping the splash effects if containedInkWell is true. [...]
inherited
noSuchMethod(Invocation invocation) → dynamic: Invoked when a non-existent 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.debug }) → String: Returns a string representation of this object.
inherited
toStringDeep({String prefixLineOne: '', String prefixOtherLines, DiagnosticLevel minLevel: DiagnosticLevel.debug }) → 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 ==(dynamic other) → bool: The equality operator. [...]
inherited

material library