Add previous/next record navigation to backend forms

[LukeTowers]

Summary

Adds an optional record navigation control to backend forms: a compact current / total indicator with previous/next arrows pinned to the right of the breadcrumb row on update/preview pages. It lets operators step through the sibling records of the controller's list without returning to it, honouring the list's active filters, search and sorting.

Enabled by default; opt out per controller with recordNavigation: false in config_form.yaml. Renders nothing when the controller has no ListController behaviour or when creating a new record.

Why / cross-database

Projects commonly hand-roll this per controller with a MySQL-only SET @row_num trick that breaks on SQLite/Postgres/SQL Server. This keeps the position math database-agnostic:

• the ordered keys come from the ListController's already-prepared query, so filters/search/sort are respected for free;
• they're read once with a portable pluck, and the current record's neighbours are resolved in PHP via the pure resolveRecordPosition() helper — no driver-specific SQL, no window functions, no session variables.

What's included

• FormController::formGetRecordNavigation() + formRenderRecordNavigation(), and the pure resolveRecordPosition() helper
• formcontroller/partials/_record_navigation.php, wired into the standard/sidebar/fancy update and preview layouts
• backend::lang.form.record_navigation / previous_record / next_record
• Styles in assets/less/controls/record-navigation.less
• Unit tests: FormControllerRecordNavigationTest (empty / first / middle / last / not-found / loose-typed / string keys)

Screenshots

Notes

• recordNavigation defaults to true; set false to disable per controller.
• Hotkeys: ctrl/cmd + up (previous), + down (next).

🤖 Generated with Claude Code

[coderabbitai]

Important

Review skipped

Auto reviews are disabled on base/target branches other than the default branch.

Please check the settings in the CodeRabbit UI or the .coderabbit.yaml file in this repository. To trigger a single review, invoke the @coderabbitai review command.

⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro Plus

Run ID: 9401aa82-c364-4121-b184-59298de12158

You can disable this status message by setting the reviews.review_status to false in the CodeRabbit configuration file.

Use the checkbox below for a quick retry:

• 🔍 Trigger review

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}