You need to enable JavaScript to run this app. 能否将flutter_markdown自定义builder与expandable可折叠组件结合使用?
优惠活动
大模型
产品
解决方案
定价
更多

能否将flutter_markdown自定义builder与expandable可折叠组件结合使用?

可以实现,推荐通过「AST预处理+自定义ElementBuilder」的方案来做,比直接用单个标签的builder更稳定,不会出现节点归属混乱的问题,具体实现步骤和代码如下:

实现方案

步骤1:依赖引入

在pubspec.yaml中添加所需依赖:

dependencies:
  flutter:
    sdk: flutter
  flutter_markdown: ^0.6.18
  expandable: ^5.0.1
  markdown: ^7.1.0

步骤2:预处理Markdown AST

将解析后的原始AST节点进行重组,把h2标签和它后续所有非h2的节点打包为自定义的expandable_section组节点,明确每个折叠块的范围:

import 'package:markdown/markdown.dart' as md;

List<md.Node> preprocessMarkdownAst(String markdownContent) {
  final document = md.Document(encodeHtml: false);
  final nodes = document.parse(markdownContent);
  final processedNodes = <md.Node>[];
  md.Element? currentExpandableSection;

  for (final node in nodes) {
    if (node is md.Element && node.tag == 'h2') {
      // 遇到新h2,先存储上一个折叠组
      if (currentExpandableSection != null) {
        processedNodes.add(currentExpandableSection);
      }
      // 新建折叠组,将当前h2作为组内第一个节点
      currentExpandableSection = md.Element('expandable_section', [node]);
    } else if (currentExpandableSection != null) {
      // 非h2节点归入当前折叠组的内容区
      currentExpandableSection.children!.add(node);
    } else {
      // 未遇到第一个h2的节点直接保留
      processedNodes.add(node);
    }
  }
  // 存入最后一个未处理的折叠组
  if (currentExpandableSection != null) {
    processedNodes.add(currentExpandableSection);
  }
  return processedNodes;
}

步骤3:自定义折叠组件的ElementBuilder

为自定义的expandable_section标签实现专属渲染逻辑,结合expandable组件实现折叠效果:

import 'package:flutter/material.dart';
import 'package:flutter_markdown/flutter_markdown.dart';
import 'package:expandable/expandable.dart';
import 'package:markdown/markdown.dart' as md;

class ExpandableSectionBuilder extends MarkdownElementBuilder {
  @override
  Widget? visitElementAfter(md.Element element, TextStyle? preferredStyle) {
    if (element.tag != 'expandable_section') return null;
    // 取出组内第一个节点作为折叠标题
    final h2Node = element.children!.first as md.Element;
    // 剩余节点作为折叠展开的内容
    final contentNodes = element.children!.sublist(1);

    return ExpandableNotifier(
      child: ScrollOnExpand(
        child: ExpandablePanel(
          header: MarkdownBody(data: md.render([h2Node])),
          collapsed: const SizedBox.shrink(),
          expanded: Padding(
            padding: const EdgeInsets.only(left: 16, top: 8),
            child: MarkdownBody(data: md.render(contentNodes)),
          ),
          tapHeaderToExpand: true,
          hasIcon: true,
        ),
      ),
    );
  }
}

步骤4:组件调用

使用时将自定义builder传入MarkdownBody的builders字段即可:

@override
Widget build(BuildContext context) {
  const markdownContent = '''
## 第一个折叠标题
这是第一个折叠块的第一段内容
这是第一个折叠块的第二段内容
## 第二个折叠标题
这是第二个折叠块的内容
''';
  return MarkdownBody(
    data: markdownContent,
    builders: {
      'expandable_section': ExpandableSectionBuilder(),
    },
    extensionSet: md.ExtensionSet.gitHubFlavored,
  );
}
优化提示

如果对性能要求较高,可以避免将子节点重新渲染为markdown字符串再解析,直接通过MarkdownBuilder递归渲染子节点,减少重复解析的开销。

内容的提问来源于stack exchange,提问作者RareScrap

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.10.20 03:24:02