mptt.forms

Form components for working with trees.

class mptt.forms.TreeNodeChoiceField(queryset, *args, **kwargs)

A ModelChoiceField for tree nodes.

label_from_instance(obj)

Creates labels which represent the tree level of each node when generating option labels.

class mptt.forms.TreeNodeMultipleChoiceField(queryset, *args, **kwargs)

A ModelMultipleChoiceField for tree nodes.

class mptt.forms.TreeNodePositionField(*args, **kwargs)

A ChoiceField for specifying position relative to another node.

class mptt.forms.MoveNodeForm(node, *args, **kwargs)

A form which allows the user to move a given node from one location in its tree to another, with optional restriction of the nodes which are valid target nodes for the move.

media
save()

Attempts to move the node using the selected target and position.

If an invalid move is attempted, the related error message will be added to the form’s non-field errors and the error will be re-raised. Callers should attempt to catch InvalidNode to redisplay the form with the error, should it occur.

Previous topic

mptt.fields

Next topic

mptt.managers

This Page