[material_ui] Global context menu builder override

packages/material_ui/lib/src/search_anchor.dart

@@ -32,6 +32,7 @@ import 'material_state.dart';
 import 'search_bar_theme.dart';
 import 'search_view_theme.dart';
 import 'text_field.dart';
+import 'text_selection_theme.dart';
 import 'text_theme.dart';
 import 'theme.dart';
 
@@ -241,7 +242,7 @@ class SearchAnchor extends StatefulWidget {
     TextInputAction? textInputAction,
     TextInputType? keyboardType,
     EdgeInsets scrollPadding,
-    EditableTextContextMenuBuilder contextMenuBuilder,
+    EditableTextContextMenuBuilder? contextMenuBuilder,
     bool enabled,
     SmartDashesType? smartDashesType,
     SmartQuotesType? smartQuotesType,
@@ -1309,7 +1310,7 @@ class _SearchAnchorWithSearchBar extends SearchAnchor {
     super.textInputAction,
     super.keyboardType,
     EdgeInsets scrollPadding = const EdgeInsets.all(20.0),
-    EditableTextContextMenuBuilder contextMenuBuilder = SearchBar._defaultContextMenuBuilder,
+    EditableTextContextMenuBuilder? contextMenuBuilder = SearchBar._defaultContextMenuBuilder,
     super.enabled,
     super.smartDashesType,
     super.smartQuotesType,
@@ -1812,6 +1813,12 @@ class _SearchBarState extends State<SearchBar> {
         )
         .toList();
 
+    final EditableTextContextMenuBuilder? resolvedContextMenuBuilder =
+        widget.contextMenuBuilder == SearchBar._defaultContextMenuBuilder
+        ? (TextSelectionTheme.of(context).contextMenuBuilder ??
+              SearchBar._defaultContextMenuBuilder)
+        : widget.contextMenuBuilder;
+
     return ConstrainedBox(
       constraints: widget.constraints ?? searchBarTheme.constraints ?? defaults.constraints!,
       child: Opacity(
@@ -1875,7 +1882,7 @@ class _SearchBarState extends State<SearchBar> {
                             textInputAction: widget.textInputAction,
                             keyboardType: widget.keyboardType,
                             scrollPadding: widget.scrollPadding,
-                            contextMenuBuilder: widget.contextMenuBuilder,
+                            contextMenuBuilder: resolvedContextMenuBuilder,
                             smartDashesType: widget.smartDashesType,
                             smartQuotesType: widget.smartQuotesType,
                           ),

packages/material_ui/lib/src/selectable_text.dart

@@ -20,6 +20,7 @@ import 'adaptive_text_selection_toolbar.dart';
 import 'desktop_text_selection.dart';
 import 'magnifier.dart';
 import 'text_selection.dart';
+import 'text_selection_theme.dart';
 import 'theme.dart';
 
 // Examples can assume:
@@ -757,12 +758,20 @@ class _SelectableTextState extends State<SelectableText>
         widget.style ?? _controller._textSpan.style,
       );
     }
+
     final TextScaler? effectiveScaler =
         widget.textScaler ??
         switch (widget.textScaleFactor) {
           null => null,
           final double textScaleFactor => TextScaler.linear(textScaleFactor),
         };
+
+    final EditableTextContextMenuBuilder? resolvedContextMenuBuilder =
+        widget.contextMenuBuilder == SelectableText._defaultContextMenuBuilder
+        ? (TextSelectionTheme.of(context).contextMenuBuilder ??
+              SelectableText._defaultContextMenuBuilder)
+        : widget.contextMenuBuilder;
+
     final Widget child = RepaintBoundary(
       child: EditableText(
         key: editableTextKey,
@@ -805,7 +814,7 @@ class _SelectableTextState extends State<SelectableText>
         scrollPhysics: widget.scrollPhysics,
         scrollBehavior: widget.scrollBehavior,
         autofillHints: null,
-        contextMenuBuilder: widget.contextMenuBuilder,
+        contextMenuBuilder: resolvedContextMenuBuilder,
       ),
     );
 

packages/material_ui/lib/src/text_field.dart

@@ -29,6 +29,7 @@ import 'material_state.dart';
 import 'selectable_text.dart' show iOSHorizontalOffset;
 import 'spell_check_suggestions_toolbar.dart';
 import 'text_selection.dart';
+import 'text_selection_theme.dart';
 import 'theme.dart';
 
 export 'package:flutter/services.dart'
@@ -888,6 +889,8 @@ class TextField extends StatefulWidget {
   ///  * [AdaptiveTextSelectionToolbar], which is built by default.
   ///  * [BrowserContextMenu], which allows the browser's context menu on web to
   ///    be disabled and Flutter-rendered context menus to appear.
+  ///  * [ThemeData.textSelectionTheme], which provides a way to override the
+  ///    default context menu.
   final EditableTextContextMenuBuilder? contextMenuBuilder;
 
   /// Determine whether this text field can request the primary focus.
@@ -1696,6 +1699,12 @@ class _TextFieldState extends State<TextField>
         };
     }
 
+    final EditableTextContextMenuBuilder? resolvedContextMenuBuilder =
+        widget.contextMenuBuilder == TextField._defaultContextMenuBuilder
+        ? (TextSelectionTheme.of(context).contextMenuBuilder ??
+              TextField._defaultContextMenuBuilder)
+        : widget.contextMenuBuilder;
+
     Widget child = RepaintBoundary(
       child: UnmanagedRestorationScope(
         bucket: bucket,
@@ -1767,7 +1776,7 @@ class _TextFieldState extends State<TextField>
           enableIMEPersonalizedLearning: widget.enableIMEPersonalizedLearning,
           enableInlinePrediction: widget.enableInlinePrediction,
           contentInsertionConfiguration: widget.contentInsertionConfiguration,
-          contextMenuBuilder: widget.contextMenuBuilder,
+          contextMenuBuilder: resolvedContextMenuBuilder,
           spellCheckConfiguration: spellCheckConfiguration,
           magnifierConfiguration:
               widget.magnifierConfiguration ?? TextMagnifier.adaptiveMagnifierConfiguration,

packages/material_ui/lib/src/text_form_field.dart

@@ -12,6 +12,7 @@ import 'adaptive_text_selection_toolbar.dart';
 import 'input_decorator.dart';
 import 'material_state.dart';
 import 'text_field.dart';
+import 'text_selection_theme.dart';
 
 export 'package:flutter/services.dart' show SmartDashesType, SmartQuotesType;
 
@@ -246,6 +247,12 @@ class TextFormField extends FormField<String> {
              onChanged?.call(value);
            }
 
+           final EditableTextContextMenuBuilder? resolvedContextMenuBuilder =
+               contextMenuBuilder == _defaultContextMenuBuilder
+               ? (TextSelectionTheme.of(field.context).contextMenuBuilder ??
+                     _defaultContextMenuBuilder)
+               : contextMenuBuilder;
+
            return UnmanagedRestorationScope(
              bucket: field.bucket,
              child: TextField(
@@ -309,7 +316,7 @@ class TextFormField extends FormField<String> {
                scrollController: scrollController,
                enableIMEPersonalizedLearning: enableIMEPersonalizedLearning,
                mouseCursor: mouseCursor,
-               contextMenuBuilder: contextMenuBuilder,
+               contextMenuBuilder: resolvedContextMenuBuilder,
                spellCheckConfiguration: spellCheckConfiguration,
                magnifierConfiguration: magnifierConfiguration,
                undoController: undoController,

packages/material_ui/lib/src/text_selection_theme.dart

@@ -36,7 +36,12 @@ import 'theme.dart';
 @immutable
 class TextSelectionThemeData with Diagnosticable {
   /// Creates the set of properties used to configure [TextField]s.
-  const TextSelectionThemeData({this.cursorColor, this.selectionColor, this.selectionHandleColor});
+  const TextSelectionThemeData({
+    this.cursorColor,
+    this.selectionColor,
+    this.selectionHandleColor,
+    this.contextMenuBuilder,
+  });
 
   /// The color of the cursor in the text field.
   ///
@@ -58,17 +63,31 @@ class TextSelectionThemeData with Diagnosticable {
   /// containing your [TextField] or [SelectableText] with a [CupertinoTheme].
   final Color? selectionHandleColor;
 
+  /// {@macro flutter.widgets.EditableText.contextMenuBuilder}
+  ///
+  /// Provides a way to globally override the default Flutter context menu for
+  /// text fields and selectable text.
+  ///
+  /// See also:
+  ///
+  ///  * [AdaptiveTextSelectionToolbar], which is built by default.
+  ///  * [BrowserContextMenu], which allows the browser's context menu on web to
+  ///    be disabled and Flutter-rendered context menus to appear.
+  final EditableTextContextMenuBuilder? contextMenuBuilder;
+
   /// Creates a copy of this object with the given fields replaced with the
   /// specified values.
   TextSelectionThemeData copyWith({
     Color? cursorColor,
     Color? selectionColor,
     Color? selectionHandleColor,
+    EditableTextContextMenuBuilder? contextMenuBuilder,
   }) {
     return TextSelectionThemeData(
       cursorColor: cursorColor ?? this.cursorColor,
       selectionColor: selectionColor ?? this.selectionColor,
       selectionHandleColor: selectionHandleColor ?? this.selectionHandleColor,
+      contextMenuBuilder: contextMenuBuilder ?? this.contextMenuBuilder,
     );
   }
 
@@ -89,11 +108,23 @@ class TextSelectionThemeData with Diagnosticable {
       cursorColor: Color.lerp(a?.cursorColor, b?.cursorColor, t),
       selectionColor: Color.lerp(a?.selectionColor, b?.selectionColor, t),
       selectionHandleColor: Color.lerp(a?.selectionHandleColor, b?.selectionHandleColor, t),
+      contextMenuBuilder: _lerpContextMenuBuilder(a, b, t),
     );
   }
 
+  /// Linear interpolation doesn't make much sense between two context menu builders,
+  /// so instead of interpolating, choose one based on the value of 't'.
+  static EditableTextContextMenuBuilder? _lerpContextMenuBuilder(
+    TextSelectionThemeData? a,
+    TextSelectionThemeData? b,
+    double t,
+  ) {
+    return t < 0.5 ? a?.contextMenuBuilder : b?.contextMenuBuilder;
+  }
+
   @override
-  int get hashCode => Object.hash(cursorColor, selectionColor, selectionHandleColor);
+  int get hashCode =>
+      Object.hash(cursorColor, selectionColor, selectionHandleColor, contextMenuBuilder);
 
   @override
   bool operator ==(Object other) {
@@ -106,7 +137,8 @@ class TextSelectionThemeData with Diagnosticable {
     return other is TextSelectionThemeData &&
         other.cursorColor == cursorColor &&
         other.selectionColor == selectionColor &&
-        other.selectionHandleColor == selectionHandleColor;
+        other.selectionHandleColor == selectionHandleColor &&
+        other.contextMenuBuilder == contextMenuBuilder;
   }
 
   @override
@@ -115,6 +147,13 @@ class TextSelectionThemeData with Diagnosticable {
     properties.add(ColorProperty('cursorColor', cursorColor, defaultValue: null));
     properties.add(ColorProperty('selectionColor', selectionColor, defaultValue: null));
     properties.add(ColorProperty('selectionHandleColor', selectionHandleColor, defaultValue: null));
+    properties.add(
+      DiagnosticsProperty<EditableTextContextMenuBuilder?>(
+        'contextMenuBuilder',
+        contextMenuBuilder,
+        defaultValue: null,
+      ),
+    );
   }
 }
 

packages/material_ui/pending_changelogs/change_2026_09_11_1789133831528.yaml

@@ -0,0 +1,3 @@
+changelog: |
+  - Adds a global context menu builder override to TextSelectionThemeData.
+version: minor