Fix DALFRelatedFieldAjax filter repopulation bug (#21)

* Fix DALFRelatedFieldAjax filter repopulation bug (#18)

Pass selected_text from Python to template to avoid AJAX call that only
returns first 20 results. Selected values beyond pagination limit now
display correctly on page reload.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Add Python 3.14 to CI workflow matrix

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Upgrade ruff 0.13.3 → 0.14.14

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Keep selected_value on DoesNotExist, use fallback label

When the selected object is deleted, keep selected_value so the filter
state matches the URL parameter. Use raw ID as fallback text so users
can still clear the filter via Select2.

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Update CHANGELOG.md

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

* Update README changelog with issue #18 fix

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

---------

Co-authored-by: Claude Opus 4.5 <noreply@anthropic.com>

Author: vigo

.github/workflows/ruff.yml

@@ -15,7 +15,7 @@ jobs:
     strategy:
       max-parallel: 4
       matrix:
-        python-version: ["3.11", "3.12", "3.13"]
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
 
     steps:
       - name: Check out repository

.github/workflows/test.yml

@@ -15,7 +15,7 @@ jobs:
     strategy:
       max-parallel: 4
       matrix:
-        python-version: ["3.11", "3.12", "3.13"]
+        python-version: ["3.11", "3.12", "3.13", "3.14"]
 
     steps:
       - name: Check out repository

CHANGELOG.md

@@ -1,5 +1,13 @@
 # Change Log
 
+**2026-01-24**
+
+- Fix `DALFRelatedFieldAjax` filter repopulation bug - selected values beyond first 20 results now display correctly on page reload
+- Add Python 3.14 to CI workflow matrix
+- Upgrade ruff 0.13.3 → 0.14.14
+
+---
+
 **2024-09-06**
 
 - Fix dark-mode text color.

README.md

@@ -277,6 +277,11 @@ rake upload:test     # Upload package to test distro
 
 ## Change Log
 
+**2026-01-24**
+
+- Fix [DALFRelatedFieldAjax filter repopulation bug](https://github.com/vigo/django-admin-list-filter/issues/18) -
+  selected values beyond pagination limit now display correctly on page reload
+
 **2025-10-06**
 
 - [Fix nested FK problem](https://github.com/vigo/django-admin-list-filter/issues/7), thanks to

requirements-dev.txt

@@ -3,4 +3,4 @@ pytest==8.4.2
 pytest-cov==7.0.0
 pytest-django==4.11.1
 pytest-factoryboy==2.8.1
-ruff==0.13.3
+ruff==0.14.14

src/dalf/admin.py

@@ -86,6 +86,15 @@ def __init__(self, field, request, params, model, model_admin, field_path):
         selected_value = originial_params.get(self.lookup_kwarg, [])
         self.selected_value = selected_value[0] if selected_value else None
 
+        self.selected_text = None
+        if self.selected_value:
+            try:
+                related_model = field.remote_field.model
+                obj = related_model.objects.get(pk=self.selected_value)
+                self.selected_text = str(obj)
+            except (related_model.DoesNotExist, ValueError):
+                self.selected_text = str(self.selected_value)
+
     def field_choices(self, _field, _request, _model_admin):
         return []
 
@@ -97,4 +106,5 @@ def choices(self, changelist):
         yield {
             **self.custom_template_params,
             'selected_value': self.selected_value,
+            'selected_text': self.selected_text,
         }

src/dalf/static/admin/js/django_admin_list_filter.js

@@ -4,12 +4,12 @@
 
     $.fn.djangoAdminListFilterSelect2 = function() {
         $.each(this, function(i, element) {
-            const ajaxURL = $(element).data("ajax--url");
             const appLabel = element.dataset.appLabel;
             const modelName = element.dataset.modelName;
             const fieldName = element.dataset.fieldName;
             const lookupKwarg = element.dataset.lookupKwarg;
-            const selectedValue = $(element).prev('.djal-selected-value').val();
+            const selectedValue = $(element).prevAll('.djal-selected-value').first().val();
+            const selectedText = $(element).prevAll('.djal-selected-text').first().val();
 
             $(element).select2({
                 ajax: {
@@ -35,26 +35,9 @@
                 window.location.href = navURL.href;
             });
 
-            if (selectedValue){
-                $.ajax({
-                    url: ajaxURL,
-                    dataType: "json",
-                    data: {
-                        term: "",
-                        app_label: appLabel,
-                        model_name: modelName,
-                        field_name: fieldName
-                    },
-                    success: function(data){
-                        if (data.results.length > 0) {
-                            const selectedItem = data.results.find(item => item.id === selectedValue);
-                            if (selectedItem) {
-                                const selectedOption = new Option(selectedItem.text, selectedItem.id, true, true);
-                                $(element).append(selectedOption).trigger("change");
-                            }
-                        };
-                    }
-                });
+            if (selectedValue && selectedText) {
+                const selectedOption = new Option(selectedText, selectedValue, true, true);
+                $(element).append(selectedOption).trigger("change");
             }
 
         });

src/dalf/templates/admin/filter/django_admin_list_filter_ajax.html

@@ -8,6 +8,7 @@
             <li>
                 {% with params=choices|last %}
                     <input class="djal-selected-value" type="hidden" value="{{ params.selected_value|default_if_none:'' }}" />
+                    <input class="djal-selected-text" type="hidden" value="{{ params.selected_text|default_if_none:'' }}" />
                     <select
                       class="django-admin-list-filter-ajax"
                       data-ajax--cache="true"

tests/testproject/testapp/tests.py

@@ -197,3 +197,65 @@ def test_order_admin_nested_ajax_filter(admin_client):
     assert results
     supplier_names = set(Supplier.objects.values_list('name', flat=True))
     assert any(result['text'] in supplier_names for result in results)
+
+
+@pytest.mark.django_db
+def test_ajax_filter_repopulation_with_selected_value(admin_client):
+    """Test that selected_text is correctly passed for filter repopulation."""
+    from .factories import CategoryFactory, PostFactory
+
+    category = CategoryFactory(name='SelectedCategory')
+    PostFactory(category=category)
+
+    response = admin_client.get(
+        reverse('admin:testapp_post_changelist'),
+        {'category__id__exact': category.pk},
+    )
+    assert response.status_code == HTTPStatus.OK
+
+    changelist = response.context['cl']
+    filter_specs = changelist.filter_specs
+
+    ajax_specs = [spec for spec in filter_specs if isinstance(spec, DALFRelatedFieldAjax)]
+    category_spec = next((spec for spec in ajax_specs if spec.lookup_kwarg == 'category__id__exact'), None)
+    assert category_spec is not None
+
+    filter_choices = list(category_spec.choices(changelist))
+    custom_params = filter_choices[-1]
+
+    assert custom_params['selected_value'] == str(category.pk)
+    assert custom_params['selected_text'] == 'SelectedCategory'
+
+    content = response.content.decode()
+    assert 'value="SelectedCategory"' in content
+
+
+@pytest.mark.django_db
+def test_ajax_filter_with_deleted_selected_value(admin_client):
+    """Test that deleted selected values are gracefully handled."""
+    from .factories import CategoryFactory, PostFactory
+
+    category = CategoryFactory(name='ToBeDeleted')
+    PostFactory(category=category)
+    deleted_pk = category.pk
+    Post.objects.filter(category=category).delete()
+    category.delete()
+
+    response = admin_client.get(
+        reverse('admin:testapp_post_changelist'),
+        {'category__id__exact': deleted_pk},
+    )
+    assert response.status_code == HTTPStatus.OK
+
+    changelist = response.context['cl']
+    filter_specs = changelist.filter_specs
+
+    ajax_specs = [spec for spec in filter_specs if isinstance(spec, DALFRelatedFieldAjax)]
+    category_spec = next((spec for spec in ajax_specs if spec.lookup_kwarg == 'category__id__exact'), None)
+    assert category_spec is not None
+
+    filter_choices = list(category_spec.choices(changelist))
+    custom_params = filter_choices[-1]
+
+    assert custom_params['selected_value'] == str(deleted_pk)
+    assert custom_params['selected_text'] == str(deleted_pk)