'_theme: ajax_base_page' route option obsolete: no longer required to use a route in an AJAX context

By tim.plunkett on 22 June 2016

Change record status:

Published (View all published change records)

Project:

Drupal core

Introduced in branch:

8.2.x

Introduced in version:

8.2.0

Issue links:

https://www.drupal.org/node/2745953

Description:

When loading a route in an AJAX context, such as within a dialog or modal dialog, the theme system should load the dialog in the same theme as the underlying page.

In Drupal 7 this was accomplished by declaring the 'theme_callback' => 'ajax_base_page_theme' for each hook_menu() entry.
In previous versions of Drupal 8 this was similarly achieved by adding _theme: ajax_base_page to each route definition.

However, every route should be able to be used in a (modal) dialog, without the route author needing to declare that it is possible beforehand. And this is already made possible by sending the ajax_page_state along with the request.

Therefore this routing option is no longer required.

Impacts:

Module developers

Updates Done (doc team, etc.)

Online documentation:

Not done

Theming guide:

Not done

Module developer documentation:

Not done

Examples project:

Not done