Wagtail RichTextEditor内部链接异常问题求助

问题原因 #

你遇到的内部链接失效、API返回href为None的问题，核心原因是调用expand_db_html时没有传递上下文（context）。Wagtail的内部链接在数据库中是以特殊标记（如<wagtail:link>）存储的，必须依赖上下文信息（如当前站点、页面上下文）才能解析为实际的URL地址。你当前的代码中expand_db_html(value.source)没有传入context，导致内部链接无法被正确解析。

解决方案 #

修改get_api_representation方法，将context参数传递给expand_db_html，确保内部链接能被正确解析。具体修改如下：

修改后的完整代码 #

class CustomizeRichTextBlock(RichTextBlock):
    def __init__(self, **kwargs):
        super().__init__(features=[
            'h1', 'h2', 'h3', 'h4', 'h5', 'bold', 'italic', 'ol', 'ul', 'hr', 
            'link', 'image', 'blockquote', 'mark', 'embed', 'code', 'superscript', 
            'subscript', 'strikethrough','text-alignment','underline'
        ], **kwargs)

    def add_link_style(self, html_content):
        # 给所有<a>标签添加style属性
        styled_content = re.sub(r'<a ', r'<a style="color: #2FC1D4;" ', html_content)
        return styled_content    
        

    def get_api_representation(self, value, context=None) -> str:
        # 传入context解析富文本中的内部链接
        html_content = expand_db_html(value.source, context=context)
        
        # 添加自定义链接样式
        styled_content = self.add_link_style(html_content)

        # 将空段落替换为带换行的段落
        styled_content = re.sub(r'<p[^>]*>\s*</p>',r'<p><br /></p>', styled_content)

        # 返回最终内容
        return styled_content

额外检查项 #

• 确认你的页面模型正确实现了get_url方法：内部链接解析依赖页面的get_url生成正确的URL路径，如果自定义了页面模型，确保该方法能返回有效的地址。
• 验证富文本编辑器的link功能是否正常启用：你已经在features中添加了'link'，这一步没问题，但如果后续仍有问题，可以检查Wagtail后台的编辑器配置是否允许选择内部页面。

内容的提问来源于stack exchange，提问作者Meera Joseph