如何自定义django-filter中OrderingFilter的降序选项标签？

嘿，我之前也遇到过这个需求，刚好知道两种简单的方法可以实现你想要的自定义排序标签效果，给你详细说说：

方法一：直接在fields里定义升/降序标签（最简单） #

你可以把fields的元组形式改成字典形式，每个字段对应一个二元组，第一个元素是升序标签，第二个就是降序标签，完全匹配你的需求：

import django_filters

class YourProductFilter(django_filters.FilterSet):
    ordering = django_filters.OrderingFilter(
        fields={
            # 键是模型字段名，值是(升序标签, 降序标签)
            'price': ('Price (lower to higher)', 'Price (higher to lower)'),
        },
        # 可选：修改排序选择框的整体提示标签
        label="Sort products by"
    )

    class Meta:
        model = YourProductModel  # 替换成你的实际模型类
        fields = []  # 这里放你需要的其他过滤字段

这样生成的选项就会变成：
*Price (lower to higher)
*Price (higher to lower)

方法二：用label_func实现更灵活的自定义 #

如果你的排序字段很多，或者需要动态生成标签，可以用label_func参数自定义一个函数来返回对应标签：

import django_filters

def custom_ordering_label(field, descending):
    # 根据字段名和是否降序返回对应的标签
    if field == 'price':
        return 'Price (higher to lower)' if descending else 'Price (lower to higher)'
    # 其他字段的默认处理逻辑（可选）
    base_label = field.replace('_', ' ').capitalize()
    return f'{base_label} (higher to lower)' if descending else f'{base_label} (lower to higher)'

class YourProductFilter(django_filters.FilterSet):
    ordering = django_filters.OrderingFilter(
        fields=(('price', 'Price'),),  # 原元组形式依然可用，label_func会覆盖默认标签
        label_func=custom_ordering_label,
        label="Sort products by"
    )

    class Meta:
        model = YourProductModel
        fields = []

这个方法适合需要批量处理多个排序字段的场景，不用逐个字段手动写标签。

需要注意的是，field_labels是针对普通过滤器字段的标签设置，对OrderingFilter的排序方向标签不生效，所以得用上面这两种方法来自定义升/降序的选项文本。

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