PAYATHON 2026

Flutter braven_charts 禁用 Y 轴平移并按可见蜡烛高低点动态设置 Y 轴范围

数据小陈

在 braven_charts ^0.18.0 里,建议不要依赖 Y 轴自动缩放。更稳妥的做法是根据 onViewportChanged 返回的 X 可见范围,计算当前 candles 的 highest high 和 lowest low,加上 margin 后写成 YAxisConfig(min: _yMin, max: _yMax)。如果该版本没有提供 disableYAxisPan 之类的单轴平移开关,固定或动态覆盖 Y 的 min/max 就是最接近 MT4 的效果。不要在 onViewportChanged 里无条件 setViewport 去锁 Y,否则容易形成回调反馈,反而放大你遇到的 X 轴 teleport。

原因

braven_charts 的 pan 通常是 viewport 级交互。YAxisConfig.min/max 决定轴范围,但不同版本对手势修改内部 Y viewport 的处理不完全一样。你日志里已经看到,X 跳变来自 _BravenChartPlusState._handleViewportChanged → onViewportChanged,不是宿主直接 setViewport。因此,把 onViewportChanged 当成“可见范围变化通知”,只用来计算并固定 Y,不要在这个回调里反复恢复 X。

实现步骤

  1. 从 onViewportChanged 的 bounds 里取 xMin/xMax,同时兼容 minX/maxX。
  2. 用 p.x >= xMin && p.x <= xMax 过滤可见 candles。边界蜡烛是否包含,按你的视觉效果决定。
  3. 遍历可见 candles,取 high 最大值和 low 最小值。
  4. 计算 margin。常见做法是 (high - low) * 0.05,也可以叠加最小 tick 边距;high == low 时给一个很小的兜底值。
  5. 用 setState 更新 _yMin/_yMax,再传给 YAxisConfig。纵向拖动如果只改变 Y、不改变 X,上面的逻辑不会更新 Y,Y 轴会保持在当前计算范围。
class _Mt4LikeChartState extends State<Mt4LikeChart> {
  final _group = ChartInteractionGroupController();

  double? _yMin;
  double? _yMax;

  void _onViewportChanged(Map<String, double> bounds) {
    final xMin = bounds['xMin'] ?? bounds['minX'];
    final xMax = bounds['xMax'] ?? bounds['maxX'];
    if (xMin == null || xMax == null) return;

    final visible = widget.points
        .where((p) => p.x >= xMin && p.x <= xMax)
        .toList();
    if (visible.isEmpty) return;

    double high = visible.first.high;
    double low = visible.first.low;
    for (final p in visible) {
      if (p.high > high) high = p.high;
      if (p.low < low) low = p.low;
    }

    final double raw = high - low;
    final double margin = raw == 0
        ? (high.abs() * 0.001).clamp(1e-9, double.infinity).toDouble()
        : raw * 0.05;

    final double newYMin = low - margin;
    final double newYMax = high + margin;

    if (_yMin == newYMin && _yMax == newYMax) return;

    setState(() {
      _yMin = newYMin;
      _yMax = newYMax;
    });
  }

  @override
  Widget build(BuildContext context) {
    return BravenChartPlus(
      series: [
        CandlestickChartSeries(
          id: 'price',
          name: 'Price',
          points: widget.points,
        ),
      ],
      xAxisConfig: XAxisConfig(
        min: -0.5,
        max: (widget.points.length - 1).toDouble() + 0.5,
        tickCount: 8,
      ),
      yAxis: YAxisConfig(
        position: YAxisPosition.right,
        min: _yMin,
        max: _yMax,
      ),
      interactionConfig: InteractionConfig(
        enablePan: true,
        enableZoom: true,
        touch: const TouchInteractionConfig(
          profile: TouchInteractionProfile.explore,
          enablePan: true,
          enablePinchZoom: true,
        ),
        onViewportChanged: _onViewportChanged,
      ),
      interactionGroupController: _group,
    );
  }
}

代码里 CandlestickDataPoint 的字段名请按项目实际类型替换;如果你的数据点不是 high/low 而是 max/min,相应调整即可。

关于禁用垂直平移

如果 braven_charts ^0.18.0 没有暴露类似 enableYAxisPan: false 的配置,就不要假设它存在。可以这样做:

  • 始终给 YAxisConfig 传固定的 min/max,让 Y 轴由你控制。
  • 只在 X 可见范围变化时更新 Y;由 Y 拖动触发的回调不要把结果写回 Y。
  • 如果包内部仍允许纵向手势改变 viewport,但 YAxisConfig 会覆盖显示范围,视觉上也能接近 MT4。
  • 若固定 YAxisConfig 仍不能阻止内部 Y 变化,就需要检查该版本源码是否有轴级手势配置;没有的话,只能在手势层拦截纵向拖动,或者升级到提供该能力的版本。

关于 X 轴 teleport

你现在的 onViewportChanged 里有一个“跳太多就 _group.setViewport(previous)”的恢复逻辑。这个逻辑会在回调里再次触发 viewport 变更,容易形成 onViewportChanged → setViewport → onViewportChanged 的反馈。建议先做两件事:

  1. 暂时去掉恢复逻辑,只保留 Y 的动态计算,观察纯手指平移时 X 是否还跳。
  2. 如果必须恢复 X,用 bool _restoringViewport 做防重入,并放到 WidgetsBinding.instance.addPostFrameCallback 里执行,不要在回调里同步调用 setViewport。

多面板场景下,价格图和 oscillator 共享 ChartInteractionGroupController 可以同步 X,但不要让 oscillator 的回调参与价格图的 Y 计算。oscillator 固定 min: 0, max: 100 即可,或者给它单独的 handler 分支处理。

注意事项

  • 不要在 onViewportChanged 里每次都 setState 更新 X,再 setViewport 回写 X,这很容易让包内部状态和你的状态互相打架。
  • setViewport 适合做初始窗口或按钮缩放,不适合做每帧手势同步。
  • 初始 viewport 只设置一次即可;后台历史刷新不要顺手调用 setViewport。
  • 如果移除 CategoryAxisConfig 后瞬移表现发生变化,说明该版本 categories 和 autoViewport 的组合仍有边界问题;先用数值 X 轴确认 Y 逻辑稳定,再决定是否恢复 categories。

备注:内容仅供参考。