animated_digit

• 3.3.3 release

这个版本基本由 github copilot 生成 This version is basically generated by github copilot.

• 拉取合并 #27 修复当整数位数不足补零时个位刷新的bug；去除默认黑色字体
• 修复 #16：避免极小数值显示为科学计数法（如1e-7.00000000）的渲染异常。
• 新增 animateUnchangedDigits 参数（默认为 false），支持数值更新时对未变化数字的可选滚动效果。
• 优化热重载重建路径：在 reassemble期间缓存显示值，减少临时状态丢失导致的闪烁现象（关联 #28 ）。
• merged #27 to fix the bug of refreshing the last digit when the integer digits are insufficient and padded with zeros; removed default black font color.
• fix #16: avoid scientific-notation rendering artifacts such as 1e-7.00000000 for tiny decimals.
• add animateUnchangedDigits (default false) to support optional unchanged-digit rolling behavior for value updates. (related to #26)
• improve hot-reload rebuild path by caching display value during reassemble to reduce temporary state loss flashes. (related to #28)

• merge #24 remove debug print.

• 从 3.3.0 起（包含），需要 flutter 版本 >= 3.16
• v3.3.0+ need flutter >= v3.16+
• 优化了颜色和增减数字位的过渡动画
• Optimized color transitions and digit increment/decrement animations.

• 增加了最小整数位支持 enableMinIntegerDigits，当数字 >= 0 <= 9 时，左边补 0，默认 false，不启用。如果为 true，且 fractionDigits 必须为 0，则启用，以满足需求 #20

• Added support for minimum integer digit with enableMinIntegerDigits: when the number is between 0 and 9 (inclusive), it left-pads with 0. Defaults to false (disabled). If set to true, fractionDigits must be 0 for this feature to be enabled, meeting specific requirements #20.

• support sdk >=3.0.0+, if your sdk version is < 3.0.0, use 3.2+ instead.
• fix #15 #18

• fix #18 and merge pull.
• 🍓 告知：这个 <3.3+ 是 sdk: <3.0.0 以下的支持版本，sdk: >= 3.0.0+ 的版本在 3.3+ 后续发布
• 🍓 Notification: This applies to versions < 3.3+ (supporting sdk: < 3.0.0). Versions with sdk: >= 3.0.0+ will be included in subsequent releases starting from 3.3+.

• upgrade: 'window' is deprecated and shouldn't be used. Look up the current FlutterView from the context via View.of(context) or consult the PlatformDispatcher directly instead. Deprecated to prepare for the upcoming multi-window support. This feature was deprecated after v3.7.0-32.0.pre.

final window = WidgetsBinding.instance.window; // deprecated

• FIX: #10

• adapted Flutter 2 ~ 3
• added change color based on value. ex

int value = 9999; // or use Controller.value
AnimatedDigitWidget(
  value: value,
  textStyle: TextStyle(
    color: Colors.orange[200],
    fontSize: 30,
  ),
  valueColors: [
    ValueColor(
      //When value <= 0 , the color changes to red
      condition: () => value <= 0,
      color: Colors.red,
    ),
    // you can add more ...，but always take the last eligible.
  ],
),

• 3.1.3 release
• fix _setValue null error

• 3.1.2 release
• cancel prefix and suffix middle of space.
• added negative symbol animation.

• 3.1.0 release
• 优化自动伸缩尺寸的动画
• optimization autoSize animation
• added Controller API minusValue
• added Controller API timesValue
• added Controller API divideValue
• added prefix
• widget params name change | 参数名称变更
  • enableDigitSplit => enableSeparator
  • digitSplitSymbol => separateSymbol
  • separatorDigits => separateLength
• change loop default value => true (orgin false)
• change autoSize default value => true (orgin false)
• remove singleBuilder

• 3.0.0 release
• added loop (default false), example:

AnimatedDigitWidget(
  value: 2022,
  loop: true,
),

• added singleBuilder, example:

AnimatedDigitWidget(
  value: 2022,
  loop: true,
  separatorDigits: 1,
  digitSplitSymbol: "#",
  enableDigitSplit: true,
  singleBuilder: (size, value, isNumber, defaultBuilder) {
    return isNumber ? defaultBuilder() : FlutterLogo();
  },
),

run result

• added SingleDigitProvider Widget, this is InheritedWidget.

它可以控制每个数字或符号的包装盒的大小和改变显示它们的方式，它比 singleBuilder 权利更大

it can control the size of every digit/symbol wrapper box and change the way of display them, more powerful than singleBuilder

example

SingleDigitProvider(
  data: SingleDigitData(
    syncContainerValueSize: false,
    size: Size.fromRadius(15),
    builder: (size, value, isNumber, defaultBuilder) {
      return isNumber ? defaultBuilder() : FlutterLogo(size: 20);
    },
  ),
  child: AnimatedDigitWidget(
    controller: _controller,
    textStyle: TextStyle(color: Colors.pink[200], fontSize: 30),
    separatorDigits: 1,
    digitSplitSymbol: "#",
    enableDigitSplit: true,
    loop: true,
    duration: const Duration(seconds: 1),
  ),
),

• added autoSize (default false).

resolve https://github.com/mingsnx/animated_digit/pull/3#issuecomment-1005552717

• added animateAutoSize (default false)

• 2.2.0 release
• ✅ null-safety Version!.
• ✅ Fix use MediaQueryData.textScaleFactor
• 🍇 added formatter, example:

AnimatedDigitWidget(
  value: 2022,
  formatter: (val) => "Hello ~ $val",
),
// => Hello ~ 2022

• 🍓 cancel assert separatorDigits >= 2, change to separatorDigits >= 1

• added decimalSeparator
• added suffix

• 2.1.0 release
• ✅ null-safety Version!.
• ✅ use late final scrollController resolve init null value

• 2.0.8 release
• ✅ null-safety Version!.
• ✅ fix scrollController null check
• ✅ 修复 scrollController 空检查

• 2.0.6 release
• ✅ null-safety Version!.
• ✅ When you don’t need a controller, you can use the value field
• ✅ 当不需要控制器时，可以使用 value 字段

• 2.0.4 release
• ✅ null-safety Version!.
• ✅ resolve textScaleFactor
• ✅ 解决设备字体因 textScaleFactor 改变的影响
• • duration field

• 2.0.2 release
• ✅null-safety Version!.
• ✅Fix the effect of digitSplitSymbol after negative numbers
• ✅修复负数后digitSplitSymbol的影响

• 2.0.1 release
• ✅not null-safety Version!.
• ✅Fix the effect of digitSplitSymbol after negative numbers
• ✅修复负数后digitSplitSymbol的影响

• 2.0.0 release
• ✅Migrate to null-safety.
• ✅迁移至空安全

• 1.0.6 release
• ✅Cannot scroll after calling'addValue' or'resetValue' for the second time
• ✅第二次调用“ addValue”或“ resetValue”后无法滚动

• 1.0.5 release
• Add assert、annotation
• Part param default handler
• Prevent ScrollController not attached to any scroll views

• 1.0.5+1 release
• (property modify error) <= 1.0.4 digitSplitSymbol => (1.0.5)❌digitSplitNumber => (now)✅digitSplitSymbol

• 1.0.4 release
• 修复支持整数

• 1.0.3 release
• 区分分隔字符和数字的Size计算

• 1.0.2 release.
• solve digital precision
• 引入 number_precision 解决数字精度git add .

• 1.0.1 release.
• reset bug

• 1.0.0 release.