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。
实现步骤
- 从
onViewportChanged的bounds里取xMin/xMax,同时兼容minX/maxX。 - 用
p.x >= xMin && p.x <= xMax过滤可见 candles。边界蜡烛是否包含,按你的视觉效果决定。 - 遍历可见 candles,取
high最大值和low最小值。 - 计算 margin。常见做法是
(high - low) * 0.05,也可以叠加最小 tick 边距;high == low时给一个很小的兜底值。 - 用
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 的反馈。建议先做两件事:
- 暂时去掉恢复逻辑,只保留 Y 的动态计算,观察纯手指平移时 X 是否还跳。
- 如果必须恢复 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。
备注:内容仅供参考。
