Flutter笔记：DefaultTextStyle和DefaultTextHeightBehavior解读

static Widget merge({
  Key? key,
  TextStyle? style,
  TextAlign? textAlign,
  bool? softWrap,
  TextOverflow? overflow,
  int? maxLines,
  TextWidthBasis? textWidthBasis,
  required Widget child,
}) {
  return Builder(
    builder: (BuildContext context) {
      final DefaultTextStyle parent = DefaultTextStyle.of(context);
      return DefaultTextStyle(
        key: key,
        style: parent.style.merge(style),
        textAlign: textAlign ?? parent.textAlign,
        softWrap: softWrap ?? parent.softWrap,
        overflow: overflow ?? parent.overflow,
        maxLines: maxLines ?? parent.maxLines,
        textWidthBasis: textWidthBasis ?? parent.textWidthBasis,
        child: child,
      );
    },
  );
}

setState(() {
  currentStyle = TextStyle(color: userPreferredColor);
});

return DefaultTextStyle(
  style: currentStyle,
  child: ChildWidget(),
);

DefaultTextHeightBehavior(
  // 定义文本的高度行为，不应用高度到第一个上升和最后一个下降
  textHeightBehavior: TextHeightBehavior(
    applyHeightToFirstAscent: false, // 不应用高度到第一个上升
    applyHeightToLastDescent: false  // 不应用高度到最后一个下降
  ),
  child: MaterialApp(
    home: HomeScreen(),
  ),
);

DefaultTextHeightBehavior(
  // 定义文本的高度行为
  textHeightBehavior: TextHeightBehavior(
    applyHeightToFirstAscent: true, // 将高度应用于第一个上升
    applyHeightToLastDescent: true  // 将高度应用于最后一个下降
  ),
  // 包裹一个列布局，包含子组件
  child: Column(
    children: [
      Text("该文本遵循特定的高度行为。"), // 显示一个文本部件
      // 其他部件
    ],
  ),
);

setState(() {
  // 从用户首选项中获取应用的文本高度行为并更新当前文本高度行为
  currentTextHeightBehavior = TextHeightBehavior(
    applyHeightToFirstAscent: userPreference.applyHeightToFirstAscent, // 应用高度到第一个上升
    applyHeightToLastDescent: userPreference.applyHeightToLastDescent  // 应用高度到最后一个下降
  );
});

return DefaultTextHeightBehavior(
  textHeightBehavior: currentTextHeightBehavior, // 设置文本的高度行为
  child: ChildWidget(), // 返回包含子部件的小部件
);

import 'package:flutter/material.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: '统一主题示例',
      theme: ThemeData(
        primarySwatch: Colors.blue,
        visualDensity: VisualDensity.adaptivePlatformDensity,
      ),
      home: const DefaultTextStyle(
        // 设置默认的文本样式
        style: TextStyle(
          fontSize: 20,
          color: Colors.black,
          fontFamily: 'Georgia',
        ),
        // 设置默认的文本高度行为
        child: DefaultTextHeightBehavior(
          textHeightBehavior: TextHeightBehavior(
            applyHeightToFirstAscent: true,
            applyHeightToLastDescent: true,
          ),
          child: MyHomePage(title: '文本样式案例'),
        ),
      ),
    );
  }
}

class MyHomePage extends StatelessWidget {
  final String title;

  const MyHomePage({super.key, required this.title});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: Text(title),
      ),
      body: const Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text(
              '你好，世界！',
              style: TextStyle(
                fontSize: 24, // 这里的样式会覆盖 DefaultTextStyle 中的样式
                color: Colors.red,
              ),
            ),
            Text(
              '这是一个示例文本。',
            ),
            Text(
              '这些文本将继承应用的默认样式。',
            ),
          ],
        ),
      ),
    );
  }
}

import 'package:flutter/material.dart';

void main() {
  runApp(const MyApp());
}

class MyApp extends StatelessWidget {
  const MyApp({super.key});

  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Flutter Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
        textTheme: const TextTheme(
          bodyMedium: TextStyle(color: Colors.black, fontSize: 16),
        ),
      ),
      home: const SpecificPage(),
    );
  }
}

class SpecificPage extends StatelessWidget {
  const SpecificPage({super.key});

  @override
  Widget build(BuildContext context) {
    return Scaffold(
      appBar: AppBar(
        title: const Text("特定页面"),
      ),
      body: DefaultTextStyle.merge(
        style: const TextStyle(color: Colors.red, fontSize: 24), // 覆盖全局颜色和字体大小
        child: const Column(
          crossAxisAlignment: CrossAxisAlignment.start,
          children: [
            Text("这是特定页面的标题，红色，24号字体"),
            Text("这段文本继承了全局样式，但字体颜色和大小被覆盖"),
            Text("继续保持特定页面的样式设置"),
          ],
        ),
      ),
    );
  }
}

/// 用于应用于没有显式样式的后代 [Text] 小部件的文本样式。
///
/// ```dart
///   /// 这个示例展示了如何使用 [DefaultTextStyle.merge] 创建一个默认文本样式，
///   /// 该样式继承当前默认文本样式的样式信息并覆盖一些属性。
///   /// 
///   /// ** 请参见示例代码 examples/api/lib/widgets/text/text.0.dart **
/// ```
///
/// 另请参阅：
///
///  * [AnimatedDefaultTextStyle]，它可以在给定的持续时间内平滑地动画变化的文本样式。
///  * [DefaultTextStyleTransition]，它接受一个提供的 [Animation]，可以在一段时间内平滑地动画文本样式的变化。
class DefaultTextStyle extends InheritedTheme {
  /// 为给定的子树创建默认文本样式。
  ///
  /// 考虑使用 [DefaultTextStyle.merge] 来继承给定 [BuildContext] 的当前默认文本样式的样式信息。
  ///
  /// [maxLines] 属性可能为空（实际上默认为空），但如果它不为空，则必须大于零。
  const DefaultTextStyle({
    super.key,
    required this.style,
    this.textAlign,
    this.softWrap = true,
    this.overflow = TextOverflow.clip,
    this.maxLines,
    this.textWidthBasis = TextWidthBasis.parent,
    this.textHeightBehavior,
    required super.child,
  }) : assert(maxLines == null || maxLines > 0);

  /// 提供回退值的可常量构造的默认文本样式。
  ///
  /// 当给定的 [BuildContext] 没有封闭的默认文本样式时，从 [of] 返回。
  ///
  /// 此构造函数创建一个带有无效 [child] 的 [DefaultTextStyle]，这意味着构造的值不能合并到树中。
  const DefaultTextStyle.fallback({ super.key })
    : style = const TextStyle(),
      textAlign = null,
      softWrap = true,
      maxLines = null,
      overflow = TextOverflow.clip,
      textWidthBasis = TextWidthBasis.parent,
      textHeightBehavior = null,
      super(child: const _NullWidget());

  /// 创建一个默认文本样式，覆盖小部件树中此处的文本样式。
  ///
  /// 给定的[style]与插入小部件的[BuildContext]中的默认文本样式合并，
  /// 并且任何其他参数（不为null）都将替换该默认文本样式上的相应属性。
  ///
  /// 此构造函数不能用于覆盖祖先的[maxLines]属性，该属性的值为null，因为此处的null表示“推迟到祖先”。
  /// 若要将祖先的非null[maxLines]替换为null值（以移除对行数的限制），请手动使用[DefaultTextStyle.of]获取环境[DefaultTextStyle]，
  /// 然后直接使用[DefaultTextStyle.new]构造函数创建一个新的[DefaultTextStyle]。
  /// 请参阅下面的源代码示例，了解如何执行此操作（因为这基本上就是此构造函数的作用）。
  static Widget merge({
    Key? key,
    TextStyle? style,
    TextAlign? textAlign,
    bool? softWrap,
    TextOverflow? overflow,
    int? maxLines,
    TextWidthBasis? textWidthBasis,
    required Widget child,
  }) {
    return Builder(
      builder: (BuildContext context) {
        final DefaultTextStyle parent = DefaultTextStyle.of(context);
        return DefaultTextStyle(
          key: key,
          style: parent.style.merge(style),
          textAlign: textAlign ?? parent.textAlign,
          softWrap: softWrap ?? parent.softWrap,
          overflow: overflow ?? parent.overflow,
          maxLines: maxLines ?? parent.maxLines,
          textWidthBasis: textWidthBasis ?? parent.textWidthBasis,
          child: child,
        );
      },
    );
  }
  /// 要应用的文本样式。
  final TextStyle style; 

  /// 文本小部件中每行文本应如何在水平方向上对齐。
  final TextAlign? textAlign; 

  /// 文本是否应在软换行处中断。
  ///
  /// 如果为false，则文本中的字形将被定位，就好像有无限的水平空间一样。
  ///
  /// 这也决定了[overflow]属性的行为。如果这是true或null，
  /// 导致溢出的字形以及随后的字形将不会被呈现。
  final bool softWrap; 

  /// 应如何处理视觉溢出。
  ///
  /// 如果[softWrap]为true或null，则导致溢出的字形以及随后的字形将不会被呈现。
  /// 否则，将以给定的溢出选项显示。
  final TextOverflow overflow; 

  /// 文本跨度的可选最大行数，必要时进行换行。
  /// 如果文本超出给定行数，将根据[overflow]进行截断。
  ///
  /// 如果为1，则文本不会换行。否则，文本将在框的边缘处换行。
  ///
  /// 如果这是非null的，则即使是[Text.maxLines]的显式null值也会被覆盖。
  final int? maxLines;

  /// 计算文本宽度时要使用的策略。
  ///
  /// 可能的值及其含义，请参阅[TextWidthBasis]。
  final TextWidthBasis textWidthBasis;

  /// {@macro dart.ui.textHeightBehavior}
  final ui.TextHeightBehavior? textHeightBehavior;

  /// 包围给定上下文的最近的此类实例。
  ///
  /// 如果不存在这样的实例，则返回由[DefaultTextStyle.fallback]创建的实例，其中包含回退值。
  ///
  /// 典型用法如下：
  ///
  /// ```dart
  /// DefaultTextStyle style = DefaultTextStyle.of(context);
  /// ```
  static DefaultTextStyle of(BuildContext context) {
    return context.dependOnInheritedWidgetOfExactType<DefaultTextStyle>() ?? const DefaultTextStyle.fallback();
  }

  @override
  bool updateShouldNotify(DefaultTextStyle oldWidget) {
    return style != oldWidget.style ||
        textAlign != oldWidget.textAlign ||
        softWrap != oldWidget.softWrap ||
        overflow != oldWidget.overflow ||
        maxLines != oldWidget.maxLines ||
        textWidthBasis != oldWidget.textWidthBasis ||
        textHeightBehavior != oldWidget.textHeightBehavior;
  }

  @override
  Widget wrap(BuildContext context, Widget child) {
    return DefaultTextStyle(
      style: style,
      textAlign: textAlign,
      softWrap: softWrap,
      overflow: overflow,
      maxLines: maxLines,
      textWidthBasis: textWidthBasis,
      textHeightBehavior: textHeightBehavior,
      child: child,
    );
  }

  @override
  void debugFillProperties(DiagnosticPropertiesBuilder properties) {
    super.debugFillProperties(properties);
    style.debugFillProperties(properties);
    properties.add(EnumProperty<TextAlign>('textAlign', textAlign, defaultValue: null));
    properties.add(FlagProperty('softWrap', value: softWrap, ifTrue: 'wrapping at box width', ifFalse: 'no wrapping except at line break characters', showName: true));
    properties.add(EnumProperty<TextOverflow>('overflow', overflow, defaultValue: null));
    properties.add(IntProperty('maxLines', maxLines, defaultValue: null));
    properties.add(EnumProperty<TextWidthBasis>('textWidthBasis', textWidthBasis, defaultValue: TextWidthBasis.parent));
    properties.add(DiagnosticsProperty<ui.TextHeightBehavior>('textHeightBehavior', textHeightBehavior, defaultValue: null));
  }
}

/// 将应用于未明确设置 [Text.textHeightBehavior] 的后代 [Text] 和 [EditableText] 小部件的 [TextHeightBehavior]。
///
/// 如果此小部件下方存在具有非空 [DefaultTextStyle.textHeightBehavior] 的 [DefaultTextStyle]，
/// 则将使用 [DefaultTextStyle.textHeightBehavior] 而不是此小部件的 [TextHeightBehavior]。
///
/// 另请参阅：
///
///  * [DefaultTextStyle]，它定义了要应用于后代 [Text] 小部件的 [TextStyle]。
class DefaultTextHeightBehavior extends InheritedTheme {
  /// 为给定的子树创建默认文本高度行为。
  const DefaultTextHeightBehavior({
    super.key,
    required this.textHeightBehavior,
    required super.child,
  });

  /// {@macro dart.ui.textHeightBehavior}
  final TextHeightBehavior textHeightBehavior;

  /// 包围给定上下文的最接近的 [DefaultTextHeightBehavior] 实例，如果找不到则为 null。
  ///
  /// 如果不存在这样的实例，则此方法将返回 `null`。
  ///
  /// 调用此方法将在 [context] 中创建对最近的 [DefaultTextHeightBehavior] 的依赖，如果存在。
  ///
  /// 典型用法如下：
  ///
  /// ```dart
  /// TextHeightBehavior? defaultTextHeightBehavior = DefaultTextHeightBehavior.of(context);
  /// ```
  ///
  /// See also:
  ///
  /// * [DefaultTextHeightBehavior.maybeOf], which is similar to this method,
  ///   but asserts if no [DefaultTextHeightBehavior] ancestor is found.
  static TextHeightBehavior? maybeOf(BuildContext context) {
    return context.dependOnInheritedWidgetOfExactType<DefaultTextHeightBehavior>()?.textHeightBehavior;
  }
  /// 包围给定上下文的最接近的 [DefaultTextHeightBehavior] 实例。
  ///
  /// 如果不存在这样的实例，则此方法在调试模式下会断言，并在发布模式下抛出异常。
  ///
  /// 典型用法如下：
  ///
  /// ```dart
  /// TextHeightBehavior defaultTextHeightBehavior = DefaultTextHeightBehavior.of(context);
  /// ```
  ///
  /// 调用此方法将在 [context] 中创建对最近的 [DefaultTextHeightBehavior] 的依赖。
  ///
  /// 另请参阅：
  ///
  /// * [DefaultTextHeightBehavior.maybeOf]，类似于此方法，但如果找不到 [DefaultTextHeightBehavior] 祖先，则返回 null。
  static TextHeightBehavior of(BuildContext context) {
    final TextHeightBehavior? behavior = maybeOf(context);
    assert(() {
      if (behavior == null) {
        throw FlutterError(
          'DefaultTextHeightBehavior.of() was called with a context that does not contain a '
          'DefaultTextHeightBehavior widget.\n'
          'No DefaultTextHeightBehavior widget ancestor could be found starting from the '
          'context that was passed to DefaultTextHeightBehavior.of(). This can happen '
          'because you are using a widget that looks for a DefaultTextHeightBehavior '
          'ancestor, but no such ancestor exists.\n'
          'The context used was:\n'
          '  $context',
        );
      }
      return true;
    }());
    return behavior!;
  }

  @override
  bool updateShouldNotify(DefaultTextHeightBehavior oldWidget) {
    return textHeightBehavior != oldWidget.textHeightBehavior;
  }

  @override
  Widget wrap(BuildContext context, Widget child) {
    return DefaultTextHeightBehavior(
      textHeightBehavior: textHeightBehavior,
      child: child,
    );
  }

  @override
  void debugFillProperties(DiagnosticPropertiesBuilder properties) {
    super.debugFillProperties(properties);
    properties.add(DiagnosticsProperty<ui.TextHeightBehavior>('textHeightBehavior', textHeightBehavior, defaultValue: null));
  }
}