diff core/lib/Drupal/Core/Controller/TitleResolverInterface.php @ 0:4c8ae668cc8c

Initial import (non-working)

--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/core/lib/Drupal/Core/Controller/TitleResolverInterface.php	Wed Nov 29 16:09:58 2017 +0000
@@ -0,0 +1,34 @@
+<?php
+
+namespace Drupal\Core\Controller;
+
+use Symfony\Component\Routing\Route;
+use Symfony\Component\HttpFoundation\Request;
+
+/**
+ * Defines a class which knows how to generate the title from a given route.
+ */
+interface TitleResolverInterface {
+
+  /**
+   * Returns a static or dynamic title for the route.
+   *
+   * If the returned title can contain HTML that should not be escaped it should
+   * return a render array, for example:
+   * @code
+   * ['#markup' => 'title', '#allowed_tags' => ['em']]
+   * @endcode
+   * If the method returns a string and it is not marked safe then it will be
+   * auto-escaped.
+   *
+   * @param \Symfony\Component\HttpFoundation\Request $request
+   *   The request object passed to the title callback.
+   * @param \Symfony\Component\Routing\Route $route
+   *   The route information of the route to fetch the title.
+   *
+   * @return array|string|null
+   *   The title for the route.
+   */
+  public function getTitle(Request $request, Route $route);
+
+}