能否将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
相关产品推荐
相关产品推荐

