django-pagination-widget 0.1.2

A reusable Django pagination component with modern, clean styling and interactive JavaScript behavior

Django Pagination Widget

A modern, zero-dependency Django pagination component with clean styling, accessible markup, and a tiny vanilla-JS helper for smart ellipsis.

Supports: Django 4.2+ (CI covers 4.2 [LTS], 5.0, 5.1, 5.2 [LTS]) · Python 3.8–3.13

Install

pip install django-pagination-widget

Quick start

1. Add the app

INSTALLED_APPS = [
	# ...
	"django_pagination_widget",
]

2. In your template

{% load pagination_tags %}

<!-- Basic usage (widget auto-includes its CSS/JS) -->
{% pagination_widget page_obj %}

<!-- Or load assets once (e.g., in base.html) and reuse the widget -->
{% pagination_css %}
{% pagination_js %}
{% pagination_widget page_obj %}

<!-- Or render the widget “bare” (skip auto-included assets) -->
{% pagination_widget page_obj include_assets=False %}

Optional: include your own theme overrides

{% pagination_custom_css 'css/pagination_widget.css' %}

Global default for “bare” mode (optional):

```python
PAGINATION_WIDGET = {
	"INCLUDE_ASSETS_BY_DEFAULT": False,
}

## Links

- Source: https://github.com/priyesh-04/django-pagination-widget
- Issues: https://github.com/priyesh-04/django-pagination-widget/issues

License: MIT