Wagtail 2.0中无法将@property定义为字段的问题求助

The issue you're facing is that Wagtail's StructBlock only recognizes fields defined as subclasses of blocks.Field at the class level. A @property is an instance-level dynamic attribute, so it won't be treated as a field in the block's schema, won't be included in the saved block data, and won't automatically be available in your template context.

Fix: Add Computed CSS to Template Context with get_context #

The cleanest way to handle this is to override the block's get_context method to generate your CSS class dynamically and pass it to the template. This keeps presentation logic tied to the block where it belongs, and avoids storing redundant data.

Here's how to update your block:

class LinkButtonBlock(blocks.StructBlock):
    label = blocks.CharBlock()
    URL = blocks.CharBlock()
    styling = blocks.ChoiceBlock(
        choices=[
            ('btn-primary', 'Primary button'),
            ('btn-secondary', 'Secondary button'),
            ('btn-success', 'Success button'),
            ('btn-info', 'Info button'),
            ('btn-warning', 'Warning button'),
            ('btn-error', 'Error button'),
        ],
        default='btn-info',
    )
    outline = blocks.BooleanBlock(default=False)

    def get_context(self, value, parent_context=None):
        # Get the base context from the parent class
        context = super().get_context(value, parent_context)
        
        # Generate the combined CSS class
        base_style = value['styling']
        if value['outline']:
            # Convert standard button class to outline variant
            context['css'] = base_style.replace('btn-', 'btn-outline-')
        else:
            context['css'] = base_style
        
        return context

    class Meta:
        # Make sure to specify your template path here
        template = 'blocks/link_button_block.html'

Using the CSS Class in Your Template #

In your block template (blocks/link_button_block.html), you can now directly reference the css variable:

<a href="{{ URL }}" class="{{ css }}">{{ label }}</a>

Why This Works #

• get_context runs every time the block is rendered, so it always uses the latest values of styling and outline.
• You don't have to store redundant CSS data in the database—everything is computed on the fly from existing fields.
• This follows Wagtail's best practices for separating content structure from presentation.

Alternative: If You Need the CSS Class Stored (Rare) #

If for some reason you need the computed CSS class to be saved as part of the block's data (not recommended unless absolutely necessary), you could add a hidden CharBlock and override the clean method to populate it:

class LinkButtonBlock(blocks.StructBlock):
    # ... existing fields ...
    css = blocks.CharBlock(required=False, hidden=True)

    def clean(self, value):
        value = super().clean(value)
        base_style = value['styling']
        if value['outline']:
            value['css'] = base_style.replace('btn-', 'btn-outline-')
        else:
            value['css'] = base_style
        return value

But again, the get_context approach is preferred because it avoids storing duplicate data and keeps your block logic clean.

内容的提问来源于stack exchange，提问作者Mike 'Pomax' Kamermans