Issue #2851394 by GoZ, hgunicamp, oknate, jungle, wolffereast, tameeshb, mmatsoo, ridhimaabrol24, jofitz, swarad07, tanc, shaktik, dimaro, shashikant_chauhan, MerryHamster, quietone, nitesh624, martin_q, boaloysius, gaurav.kapoor, nitvirus, ankithashetty, Munavijayalakshmi, kostyashupenko, leolando.tan, amit.drupal, ravi.shankar, akashkrishnan01, Swapnil_Kotwal, Saviktor, mrinalini9, anmolgoyal74, Venkatesh Rajan.J, shimpy, lomasr, Dinesh18, shubham.prakash, mahtab_alam, markdorison, cilefen, longwave, bleen, xjm, alexpott, gmaltoni: Fix grammar 'a' to 'an' when necessary
catch
parent
0ea2e4d0df
commit
1d6e7e25d5
|
|
@ -143,7 +143,7 @@ function drupal_find_theme_functions($cache, $prefixes) {
|
|||
// Find theme functions that implement possible "suggestion" variants of
|
||||
// registered theme hooks and add those as new registered theme hooks.
|
||||
// The 'pattern' key defines a common prefix that all suggestions must
|
||||
// start with. The default is the name of the hook followed by '__'. An
|
||||
// start with. The default is the name of the hook followed by '__'. A
|
||||
// 'base hook' key is added to each entry made for a found suggestion,
|
||||
// so that common functionality can be implemented for all suggestions of
|
||||
// the same base hook. To keep things simple, deep hierarchy of
|
||||
|
|
|
|||
|
|
@ -15,7 +15,7 @@ class InvalidPluginDefinitionException extends PluginException {
|
|||
protected $pluginId;
|
||||
|
||||
/**
|
||||
* Constructs a InvalidPluginDefinitionException.
|
||||
* Constructs an InvalidPluginDefinitionException.
|
||||
*
|
||||
* For the remaining parameters see \Exception.
|
||||
*
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@ namespace Drupal\Component\Plugin\Exception;
|
|||
class PluginNotFoundException extends PluginException {
|
||||
|
||||
/**
|
||||
* Construct an PluginNotFoundException exception.
|
||||
* Construct a PluginNotFoundException exception.
|
||||
*
|
||||
* For the remaining parameters see \Exception.
|
||||
*
|
||||
|
|
|
|||
|
|
@ -45,8 +45,8 @@ class Html {
|
|||
* <command> tag anymore.
|
||||
* See https://developer.mozilla.org/en-US/docs/Web/HTML/Element/command.
|
||||
* - The 'manifest' attribute is omitted because it only exists for the <html>
|
||||
* tag. That tag only makes sense in a HTML-served-as-HTML context, in which
|
||||
* case relative URLs are guaranteed to work.
|
||||
* tag. That tag only makes sense in an HTML-served-as-HTML context, in
|
||||
* which case relative URLs are guaranteed to work.
|
||||
*
|
||||
* @see https://developer.mozilla.org/en-US/docs/Web/HTML/Attributes
|
||||
* @see https://stackoverflow.com/questions/2725156/complete-list-of-html-tag-attributes-which-have-a-url-value
|
||||
|
|
|
|||
|
|
@ -242,14 +242,14 @@ class UrlHelper {
|
|||
* TRUE if the URL has the same domain and base path.
|
||||
*
|
||||
* @throws \InvalidArgumentException
|
||||
* Exception thrown when a either $url or $bath_url are not fully qualified.
|
||||
* Exception thrown when either $url or $base_url are not fully qualified.
|
||||
*/
|
||||
public static function externalIsLocal($url, $base_url) {
|
||||
// Some browsers treat \ as / so normalize to forward slashes.
|
||||
$url = str_replace('\\', '/', $url);
|
||||
|
||||
// Leading control characters may be ignored or mishandled by browsers, so
|
||||
// assume such a path may lead to an non-local location. The \p{C} character
|
||||
// assume such a path may lead to a non-local location. The \p{C} character
|
||||
// class matches all UTF-8 control, unassigned, and private characters.
|
||||
if (preg_match('/^\p{C}/u', $url) !== 0) {
|
||||
return FALSE;
|
||||
|
|
|
|||
|
|
@ -55,7 +55,7 @@ class AccessManager implements AccessManagerInterface {
|
|||
protected $checkProvider;
|
||||
|
||||
/**
|
||||
* Constructs a AccessManager instance.
|
||||
* Constructs an AccessManager instance.
|
||||
*
|
||||
* @param \Drupal\Core\Routing\RouteProviderInterface $route_provider
|
||||
* The route provider.
|
||||
|
|
|
|||
|
|
@ -70,7 +70,7 @@ class EmailAction extends ConfigurableActionBase implements ContainerFactoryPlug
|
|||
protected $emailValidator;
|
||||
|
||||
/**
|
||||
* Constructs a EmailAction object.
|
||||
* Constructs an EmailAction object.
|
||||
*
|
||||
* @param array $configuration
|
||||
* A configuration array containing information about the plugin instance.
|
||||
|
|
|
|||
|
|
@ -21,7 +21,7 @@ abstract class EntityActionBase extends ActionBase implements DependentPluginInt
|
|||
protected $entityTypeManager;
|
||||
|
||||
/**
|
||||
* Constructs a EntityActionBase object.
|
||||
* Constructs an EntityActionBase object.
|
||||
*
|
||||
* @param mixed[] $configuration
|
||||
* A configuration array containing information about the plugin instance.
|
||||
|
|
|
|||
|
|
@ -71,7 +71,7 @@ class AjaxResponseAttachmentsProcessor implements AttachmentsResponseProcessorIn
|
|||
protected $moduleHandler;
|
||||
|
||||
/**
|
||||
* Constructs a AjaxResponseAttachmentsProcessor object.
|
||||
* Constructs an AjaxResponseAttachmentsProcessor object.
|
||||
*
|
||||
* @param \Drupal\Core\Asset\AssetResolverInterface $asset_resolver
|
||||
* An asset resolver.
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@
|
|||
namespace Drupal\Core\Ajax;
|
||||
|
||||
/**
|
||||
* Defines an AJAX command to open content in a dialog in a off-canvas dialog.
|
||||
* Defines an AJAX command to open content in a dialog in an off-canvas tray.
|
||||
*
|
||||
* @ingroup ajax
|
||||
*/
|
||||
|
|
@ -18,7 +18,7 @@ class OpenOffCanvasDialogCommand extends OpenDialogCommand {
|
|||
* Constructs an OpenOffCanvasDialogCommand object.
|
||||
*
|
||||
* The off-canvas dialog differs from the normal modal provided by
|
||||
* OpenDialogCommand in that a off-canvas has built in positioning and
|
||||
* OpenDialogCommand in that an off-canvas has built in positioning and
|
||||
* behaviors. Drupal provides a built-in off-canvas dialog for this purpose,
|
||||
* so the selector is hard-coded in the call to the parent constructor.
|
||||
*
|
||||
|
|
|
|||
|
|
@ -34,7 +34,7 @@ class UpdateBuildIdCommand implements CommandInterface {
|
|||
protected $new;
|
||||
|
||||
/**
|
||||
* Constructs a UpdateBuildIdCommand object.
|
||||
* Constructs an UpdateBuildIdCommand object.
|
||||
*
|
||||
* @param string $old
|
||||
* The old build_id.
|
||||
|
|
|
|||
|
|
@ -25,7 +25,7 @@ class ArchiverManager extends DefaultPluginManager {
|
|||
protected $fileSystem;
|
||||
|
||||
/**
|
||||
* Constructs a ArchiverManager object.
|
||||
* Constructs an ArchiverManager object.
|
||||
*
|
||||
* @param \Traversable $namespaces
|
||||
* An object that implements \Traversable which contains the root paths
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@
|
|||
namespace Drupal\Core\Archiver;
|
||||
|
||||
/**
|
||||
* Defines a archiver implementation for .tar files.
|
||||
* Defines an archiver implementation for .tar files.
|
||||
*/
|
||||
class Tar implements ArchiverInterface {
|
||||
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@
|
|||
namespace Drupal\Core\Archiver;
|
||||
|
||||
/**
|
||||
* Defines a archiver implementation for .zip files.
|
||||
* Defines an archiver implementation for .zip files.
|
||||
*
|
||||
* @link http://php.net/zip
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -16,7 +16,7 @@ interface AssetDumperInterface {
|
|||
* The file extension of this asset.
|
||||
*
|
||||
* @return string
|
||||
* An URI to access the dumped asset.
|
||||
* A URI to access the dumped asset.
|
||||
*/
|
||||
public function dump($data, $file_extension);
|
||||
|
||||
|
|
|
|||
|
|
@ -21,7 +21,7 @@ interface ConfigFactoryInterface {
|
|||
public function get($name);
|
||||
|
||||
/**
|
||||
* Returns an mutable configuration object for a given name.
|
||||
* Returns a mutable configuration object for a given name.
|
||||
*
|
||||
* Should not be used for config that will have runtime effects. Therefore it
|
||||
* is always loaded override free.
|
||||
|
|
|
|||
|
|
@ -23,7 +23,7 @@ use Symfony\Component\EventDispatcher\EventDispatcherInterface;
|
|||
*
|
||||
* @see \Drupal\Core\Config\StorageComparerInterface
|
||||
*
|
||||
* The ConfigImporter has a identifier which is used to construct event names.
|
||||
* The ConfigImporter has an identifier which is used to construct event names.
|
||||
* The events fired during an import are:
|
||||
* - ConfigEvents::IMPORT_VALIDATE: Events listening can throw a
|
||||
* \Drupal\Core\Config\ConfigImporterException to prevent an import from
|
||||
|
|
@ -1039,7 +1039,7 @@ class ConfigImporter {
|
|||
}
|
||||
|
||||
/**
|
||||
* Determines if a import is already running.
|
||||
* Determines if an import is already running.
|
||||
*
|
||||
* @return bool
|
||||
* TRUE if an import is already running, FALSE if not.
|
||||
|
|
|
|||
|
|
@ -59,7 +59,7 @@ class Query extends QueryBase implements QueryInterface {
|
|||
* Overrides \Drupal\Core\Entity\Query\QueryBase::condition().
|
||||
*
|
||||
* Additional to the syntax defined in the QueryInterface you can use
|
||||
* placeholders (*) to match all keys of an subarray. Let's take the follow
|
||||
* placeholders (*) to match all keys of a subarray. Let's take the follow
|
||||
* yaml file as example:
|
||||
* @code
|
||||
* level1:
|
||||
|
|
|
|||
|
|
@ -1722,7 +1722,7 @@ abstract class Connection {
|
|||
}
|
||||
|
||||
/**
|
||||
* Retrieves an unique ID from a given sequence.
|
||||
* Retrieves a unique ID from a given sequence.
|
||||
*
|
||||
* Use this function if for some reason you can't use a serial field. For
|
||||
* example, MySQL has no ways of reading of the current value of a sequence
|
||||
|
|
|
|||
|
|
@ -38,7 +38,7 @@ abstract class Database {
|
|||
const RETURN_INSERT_ID = 3;
|
||||
|
||||
/**
|
||||
* An nested array of all active connections. It is keyed by database name
|
||||
* A nested array of all active connections. It is keyed by database name
|
||||
* and target.
|
||||
*
|
||||
* @var array
|
||||
|
|
|
|||
|
|
@ -319,7 +319,7 @@ class Connection extends DatabaseConnection {
|
|||
}
|
||||
|
||||
/**
|
||||
* Add a new savepoint with an unique name.
|
||||
* Add a new savepoint with a unique name.
|
||||
*
|
||||
* The main use for this method is to mimic InnoDB functionality, which
|
||||
* provides an inherent savepoint before any query in a transaction.
|
||||
|
|
|
|||
|
|
@ -99,7 +99,7 @@ class Select extends QuerySelect {
|
|||
}
|
||||
}
|
||||
|
||||
// If $field contains an characters which are not allowed in a field name
|
||||
// If $field contains characters which are not allowed in a field name
|
||||
// it is considered an expression, these can't be handled automatically
|
||||
// either.
|
||||
if ($this->connection->escapeField($field) != $field) {
|
||||
|
|
|
|||
|
|
@ -366,7 +366,7 @@ class Schema extends DatabaseSchema {
|
|||
// Build the mapping between the old fields and the new fields.
|
||||
$mapping = [];
|
||||
if (isset($specification['initial_from_field'])) {
|
||||
// If we have a initial value, copy it over.
|
||||
// If we have an initial value, copy it over.
|
||||
if (isset($specification['initial'])) {
|
||||
$expression = 'COALESCE(' . $specification['initial_from_field'] . ', :default_initial_value)';
|
||||
$arguments = [':default_initial_value' => $specification['initial']];
|
||||
|
|
@ -381,7 +381,7 @@ class Schema extends DatabaseSchema {
|
|||
];
|
||||
}
|
||||
elseif (isset($specification['initial'])) {
|
||||
// If we have a initial value, copy it over.
|
||||
// If we have an initial value, copy it over.
|
||||
$mapping[$field] = [
|
||||
'expression' => ':newfieldinitial',
|
||||
'arguments' => [':newfieldinitial' => $specification['initial']],
|
||||
|
|
|
|||
|
|
@ -48,10 +48,10 @@ interface ConditionInterface {
|
|||
* The value to test the field against. In most cases, and depending on the
|
||||
* operator, this will be a scalar or an array. As SQL accepts select
|
||||
* queries on any place where a scalar value or set is expected, $value may
|
||||
* also be a(n array of) SelectInterface(s). If $operator is a unary
|
||||
* operator, e.g. IS NULL, $value will be ignored and should be null. If
|
||||
* the operator requires a subquery, e.g. EXISTS, the $field will be ignored
|
||||
* and $value should be a SelectInterface object.
|
||||
* also be a SelectInterface or an array of SelectInterfaces. If $operator
|
||||
* is a unary operator, e.g. IS NULL, $value will be ignored and should be
|
||||
* null. If the operator requires a subquery, e.g. EXISTS, the $field will
|
||||
* be ignored and $value should be a SelectInterface object.
|
||||
* @param string|null $operator
|
||||
* The operator to use. Supported for all supported databases are at least:
|
||||
* - The comparison operators =, <>, <, <=, >, >=.
|
||||
|
|
|
|||
|
|
@ -432,7 +432,7 @@ function hook_query_alter(Drupal\Core\Database\Query\AlterableInterface $query)
|
|||
* a listing (e.g., from Views) and therefore require access control.
|
||||
*
|
||||
* @param $query
|
||||
* An Query object describing the composite parts of a SQL query.
|
||||
* A Query object describing the composite parts of a SQL query.
|
||||
*
|
||||
* @see hook_query_alter()
|
||||
* @see node_query_node_access_alter()
|
||||
|
|
|
|||
|
|
@ -154,7 +154,7 @@ class Datetime extends DateElementBase {
|
|||
* element, no other format will work. See the
|
||||
* DateFormatterInterface::format() function for a list of the possible
|
||||
* formats and HTML5 standards for the HTML5 requirements. Defaults to the
|
||||
* right HTML5 format for the chosen element if a HTML5 element is used,
|
||||
* right HTML5 format for the chosen element if an HTML5 element is used,
|
||||
* otherwise defaults to DateFormat::load('html_date')->getPattern().
|
||||
* - #date_date_element: The date element. Options are:
|
||||
* - datetime: Use the HTML5 datetime element type.
|
||||
|
|
@ -164,7 +164,7 @@ class Datetime extends DateElementBase {
|
|||
* - none: Do not display a date element.
|
||||
* - #date_date_callbacks: Array of optional callbacks for the date element.
|
||||
* - #date_time_element: The time element. Options are:
|
||||
* - time: Use a HTML5 time element type.
|
||||
* - time: Use an HTML5 time element type.
|
||||
* - text: No HTML5 element, use a normal text field.
|
||||
* - none: Do not display a time element.
|
||||
* - #date_time_format: A date format string that describes the format that
|
||||
|
|
@ -173,7 +173,7 @@ class Datetime extends DateElementBase {
|
|||
* element, no other format will work. See the
|
||||
* DateFormatterInterface::format() function for a list of the possible
|
||||
* formats and HTML5 standards for the HTML5 requirements. Defaults to the
|
||||
* right HTML5 format for the chosen element if a HTML5 element is used,
|
||||
* right HTML5 format for the chosen element if an HTML5 element is used,
|
||||
* otherwise defaults to DateFormat::load('html_time')->getPattern().
|
||||
* - #date_time_callbacks: An array of optional callbacks for the time
|
||||
* element. Can be used to add a jQuery timepicker or an 'All day' checkbox.
|
||||
|
|
@ -394,7 +394,7 @@ class Datetime extends DateElementBase {
|
|||
}
|
||||
|
||||
/**
|
||||
* Retrieves the right format for a HTML5 date element.
|
||||
* Retrieves the right format for an HTML5 date element.
|
||||
*
|
||||
* The format is important because these elements will not work with any other
|
||||
* format.
|
||||
|
|
@ -404,7 +404,7 @@ class Datetime extends DateElementBase {
|
|||
*
|
||||
* @return string
|
||||
* Returns the right format for the date element, or the original format
|
||||
* if this is not a HTML5 element.
|
||||
* if this is not an HTML5 element.
|
||||
*/
|
||||
protected static function getHtml5DateFormat($element) {
|
||||
switch ($element['#date_date_element']) {
|
||||
|
|
@ -421,7 +421,7 @@ class Datetime extends DateElementBase {
|
|||
}
|
||||
|
||||
/**
|
||||
* Retrieves the right format for a HTML5 time element.
|
||||
* Retrieves the right format for an HTML5 time element.
|
||||
*
|
||||
* The format is important because these elements will not work with any other
|
||||
* format.
|
||||
|
|
@ -431,7 +431,7 @@ class Datetime extends DateElementBase {
|
|||
*
|
||||
* @return string
|
||||
* Returns the right format for the time element, or the original format
|
||||
* if this is not a HTML5 element.
|
||||
* if this is not an HTML5 element.
|
||||
*/
|
||||
protected static function getHtml5TimeFormat($element) {
|
||||
switch ($element['#date_time_element']) {
|
||||
|
|
|
|||
|
|
@ -3,7 +3,8 @@
|
|||
namespace Drupal\Core\DependencyInjection;
|
||||
|
||||
/**
|
||||
* Provides an interface to get a instance of a class with dependency injection.
|
||||
* Provides an interface to get an instance of a class with dependency
|
||||
* injection.
|
||||
*/
|
||||
interface ClassResolverInterface {
|
||||
|
||||
|
|
|
|||
|
|
@ -13,7 +13,7 @@ use Symfony\Component\Validator\ConstraintViolationList;
|
|||
use Symfony\Component\Validator\ConstraintViolationListInterface;
|
||||
|
||||
/**
|
||||
* Configuration entity that contains widget options for all components of a
|
||||
* Configuration entity that contains widget options for all components of an
|
||||
* entity form in a given form mode.
|
||||
*
|
||||
* @ConfigEntityType(
|
||||
|
|
|
|||
|
|
@ -19,7 +19,7 @@ class EntityAutocompleteMatcher implements EntityAutocompleteMatcherInterface {
|
|||
protected $selectionManager;
|
||||
|
||||
/**
|
||||
* Constructs a EntityAutocompleteMatcher object.
|
||||
* Constructs an EntityAutocompleteMatcher object.
|
||||
*
|
||||
* @param \Drupal\Core\Entity\EntityReferenceSelection\SelectionPluginManagerInterface $selection_manager
|
||||
* The entity reference selection handler plugin manager.
|
||||
|
|
|
|||
|
|
@ -28,7 +28,7 @@ class EntityCreateAccessCheck implements AccessInterface {
|
|||
protected $requirementsKey = '_entity_create_access';
|
||||
|
||||
/**
|
||||
* Constructs a EntityCreateAccessCheck object.
|
||||
* Constructs an EntityCreateAccessCheck object.
|
||||
*
|
||||
* @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager
|
||||
* The entity type manager service.
|
||||
|
|
|
|||
|
|
@ -35,7 +35,7 @@ class EntityCreateAnyAccessCheck implements AccessInterface {
|
|||
protected $requirementsKey = '_entity_create_any_access';
|
||||
|
||||
/**
|
||||
* Constructs a EntityCreateAnyAccessCheck object.
|
||||
* Constructs an EntityCreateAnyAccessCheck object.
|
||||
*
|
||||
* @param \Drupal\Core\Entity\EntityTypeManagerInterface $entity_type_manager
|
||||
* The entity type manager.
|
||||
|
|
|
|||
|
|
@ -17,7 +17,7 @@ interface EntityTypeManagerInterface extends PluginManagerInterface, CachedDisco
|
|||
* The entity type ID for this access control handler.
|
||||
*
|
||||
* @return \Drupal\Core\Entity\EntityAccessControlHandlerInterface
|
||||
* A access control handler instance.
|
||||
* An access control handler instance.
|
||||
*/
|
||||
public function getAccessControlHandler($entity_type_id);
|
||||
|
||||
|
|
|
|||
|
|
@ -12,7 +12,7 @@ namespace Drupal\Core\Entity\Exception;
|
|||
class NoCorrespondingEntityClassException extends \Exception {
|
||||
|
||||
/**
|
||||
* Constructs an NoCorrespondingEntityClassException.
|
||||
* Constructs a NoCorrespondingEntityClassException.
|
||||
*
|
||||
* @param string $class
|
||||
* The class which does not correspond to an entity type.
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@
|
|||
namespace Drupal\Core\Entity\Query;
|
||||
|
||||
/**
|
||||
* Defines a interface for aggregated entity queries.
|
||||
* Defines an interface for aggregated entity queries.
|
||||
*/
|
||||
interface QueryAggregateInterface extends QueryInterface {
|
||||
|
||||
|
|
|
|||
|
|
@ -408,7 +408,7 @@ class Tables implements TablesInterface {
|
|||
$entity_type_id = $this->sqlQuery->getMetaData('entity_type');
|
||||
$entity_type = $this->entityTypeManager->getActiveDefinition($entity_type_id);
|
||||
// Only the data table follows the entity language key, dedicated field
|
||||
// tables have an hard-coded 'langcode' column.
|
||||
// tables have a hard-coded 'langcode' column.
|
||||
$langcode_key = $entity_type->getDataTable() == $table ? $entity_type->getKey('langcode') : 'langcode';
|
||||
$placeholder = ':langcode' . $this->sqlQuery->nextPlaceholder();
|
||||
$join_condition .= ' AND [%alias].[' . $langcode_key . '] = ' . $placeholder;
|
||||
|
|
|
|||
|
|
@ -475,7 +475,7 @@ class DefaultTableMapping implements TableMappingInterface {
|
|||
}
|
||||
|
||||
/**
|
||||
* Adds a extra columns for a table to the table mapping.
|
||||
* Adds extra columns for a table to the table mapping.
|
||||
*
|
||||
* @param string $table_name
|
||||
* The name of table to add the extra columns for.
|
||||
|
|
|
|||
|
|
@ -541,7 +541,7 @@ use Drupal\node\Entity\NodeType;
|
|||
* @link container Services and Dependency Injection topic @endlink for more
|
||||
* about how to properly retrieve services.
|
||||
*
|
||||
* To query to find entities to load, use an entity query, which is a object
|
||||
* To query to find entities to load, use an entity query, which is an object
|
||||
* implementing \Drupal\Core\Entity\Query\QueryInterface that you can retrieve
|
||||
* with:
|
||||
* @code
|
||||
|
|
|
|||
|
|
@ -99,7 +99,7 @@ abstract class HttpExceptionSubscriberBase implements EventSubscriberInterface {
|
|||
if ($exception instanceof HttpExceptionInterface && (empty($handled_formats) || in_array($format, $handled_formats))) {
|
||||
$method = 'on' . $exception->getStatusCode();
|
||||
// Keep just the leading number of the status code to produce either a
|
||||
// on400 or a 500 method callback.
|
||||
// 400 or a 500 method callback.
|
||||
$method_fallback = 'on' . substr($exception->getStatusCode(), 0, 1) . 'xx';
|
||||
// We want to allow the method to be called and still not set a response
|
||||
// if it has additional filtering logic to determine when it will apply.
|
||||
|
|
|
|||
|
|
@ -12,7 +12,7 @@ use Symfony\Component\Routing\Route;
|
|||
/**
|
||||
* Handles options requests.
|
||||
*
|
||||
* Therefore it sends a options response using all methods on all possible
|
||||
* Therefore it sends an options response using all methods on all possible
|
||||
* routes.
|
||||
*/
|
||||
class OptionsRequestSubscriber implements EventSubscriberInterface {
|
||||
|
|
|
|||
|
|
@ -46,7 +46,7 @@ class ThemeHandler implements ThemeHandlerInterface {
|
|||
* @param \Drupal\Core\Config\ConfigFactoryInterface $config_factory
|
||||
* The config factory to get the installed themes.
|
||||
* @param \Drupal\Core\Extension\ThemeExtensionList $theme_list
|
||||
* A extension discovery instance.
|
||||
* An extension discovery instance.
|
||||
*/
|
||||
public function __construct($root, ConfigFactoryInterface $config_factory, ThemeExtensionList $theme_list) {
|
||||
$this->root = $root;
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@ use Drupal\Core\Access\AccessResult;
|
|||
use Drupal\Core\Session\AccountInterface;
|
||||
|
||||
/**
|
||||
* Defines a item list class for changed fields.
|
||||
* Defines an item list class for changed fields.
|
||||
*/
|
||||
class ChangedFieldItemList extends FieldItemList {
|
||||
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@ use Drupal\Core\Entity\FieldableEntityInterface;
|
|||
use Drupal\Core\Form\FormStateInterface;
|
||||
|
||||
/**
|
||||
* Defines a item list class for entity reference fields.
|
||||
* Defines an item list class for entity reference fields.
|
||||
*/
|
||||
class EntityReferenceFieldItemList extends FieldItemList implements EntityReferenceFieldItemListInterface {
|
||||
|
||||
|
|
|
|||
|
|
@ -132,7 +132,7 @@ abstract class FieldConfigBase extends ConfigEntityBase implements FieldConfigIn
|
|||
*
|
||||
* This property is overlooked if the $default_value_callback is non-empty.
|
||||
*
|
||||
* Example for a integer field:
|
||||
* Example for an integer field:
|
||||
* @code
|
||||
* array(
|
||||
* array('value' => 1),
|
||||
|
|
|
|||
|
|
@ -56,7 +56,7 @@ interface FieldStorageDefinitionInterface extends CacheableDependencyInterface {
|
|||
*
|
||||
* Each field type defines the settings that are meaningful for that type.
|
||||
* For example, a text field can define a 'max_length' setting, and an image
|
||||
* field can define a 'alt_field_required' setting.
|
||||
* field can define an 'alt_field_required' setting.
|
||||
*
|
||||
* The method always returns an array of all available settings for this field
|
||||
* type, possibly with the default values merged in if values have not been
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@
|
|||
namespace Drupal\Core\Field;
|
||||
|
||||
/**
|
||||
* Defines a item list class for map fields.
|
||||
* Defines an item list class for map fields.
|
||||
*/
|
||||
class MapFieldItemList extends FieldItemList {
|
||||
|
||||
|
|
|
|||
|
|
@ -65,7 +65,7 @@ class EntityReferenceEntityFormatter extends EntityReferenceFormatterBase {
|
|||
protected static $recursiveRenderDepth = [];
|
||||
|
||||
/**
|
||||
* Constructs a EntityReferenceEntityFormatter instance.
|
||||
* Constructs an EntityReferenceEntityFormatter instance.
|
||||
*
|
||||
* @param string $plugin_id
|
||||
* The plugin_id for the formatter.
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@
|
|||
namespace Drupal\Core\Form;
|
||||
|
||||
/**
|
||||
* Provides an generic base class for a confirmation form.
|
||||
* Provides a generic base class for a confirmation form.
|
||||
*/
|
||||
abstract class ConfirmFormBase extends FormBase implements ConfirmFormInterface {
|
||||
|
||||
|
|
|
|||
|
|
@ -228,7 +228,7 @@ interface ImageInterface {
|
|||
* @param float $degrees
|
||||
* The number of (clockwise) degrees to rotate the image.
|
||||
* @param string|null $background
|
||||
* (optional) An hexadecimal integer specifying the background color to use
|
||||
* (optional) A hexadecimal integer specifying the background color to use
|
||||
* for the uncovered area of the image after the rotation; for example,
|
||||
* 0x000000 for black, 0xff00ff for magenta, and 0xffffff for white. When
|
||||
* NULL (the default) is specified, for images that support transparency,
|
||||
|
|
|
|||
|
|
@ -35,7 +35,7 @@ class ImageToolkit extends Plugin {
|
|||
/**
|
||||
* The title of the image toolkit.
|
||||
*
|
||||
* The string should be wrapped in a @Translation().
|
||||
* The string should be wrapped in @Translation().
|
||||
*
|
||||
* @ingroup plugin_translatable
|
||||
*
|
||||
|
|
|
|||
|
|
@ -63,7 +63,7 @@ class ImageToolkitOperation extends Plugin {
|
|||
/**
|
||||
* The human-readable name of the image toolkit operation.
|
||||
*
|
||||
* The string should be wrapped in a @Translation().
|
||||
* The string should be wrapped in @Translation().
|
||||
*
|
||||
* @ingroup plugin_translatable
|
||||
*
|
||||
|
|
@ -74,7 +74,7 @@ class ImageToolkitOperation extends Plugin {
|
|||
/**
|
||||
* The description of the image toolkit operation.
|
||||
*
|
||||
* The string should be wrapped in a @Translation().
|
||||
* The string should be wrapped in @Translation().
|
||||
*
|
||||
* @ingroup plugin_translatable
|
||||
*
|
||||
|
|
|
|||
|
|
@ -9,7 +9,7 @@ use Symfony\Component\HttpFoundation\Response;
|
|||
* Defines the interface for response policy implementations.
|
||||
*
|
||||
* The response policy is evaluated in order to determine whether a page should
|
||||
* be stored a in the cache. Calling code should do so unless static::DENY is
|
||||
* be stored in the cache. Calling code should do so unless static::DENY is
|
||||
* returned from the check() method.
|
||||
*/
|
||||
interface ResponsePolicyInterface {
|
||||
|
|
|
|||
|
|
@ -27,7 +27,7 @@ class InfoHookDecorator implements DiscoveryInterface {
|
|||
protected $hook;
|
||||
|
||||
/**
|
||||
* Constructs a InfoHookDecorator object.
|
||||
* Constructs an InfoHookDecorator object.
|
||||
*
|
||||
* @param \Drupal\Component\Plugin\Discovery\DiscoveryInterface $decorated
|
||||
* The object implementing DiscoveryInterface that is being decorated.
|
||||
|
|
|
|||
|
|
@ -17,7 +17,7 @@ use Drupal\Core\Plugin\DefaultPluginManager;
|
|||
class QueueWorkerManager extends DefaultPluginManager implements QueueWorkerManagerInterface {
|
||||
|
||||
/**
|
||||
* Constructs an QueueWorkerManager object.
|
||||
* Constructs a QueueWorkerManager object.
|
||||
*
|
||||
* @param \Traversable $namespaces
|
||||
* An object that implements \Traversable which contains the root paths
|
||||
|
|
|
|||
|
|
@ -23,7 +23,7 @@ namespace Drupal\Core\Render;
|
|||
* use a @code _controller @endcode route, and return a render array.
|
||||
* This will cause a main content renderer
|
||||
* (\Drupal\Core\Render\MainContent\MainContentRendererInterface) to be
|
||||
* used, and in case of a HTML request that will be
|
||||
* used, and in case of an HTML request that will be
|
||||
* \Drupal\Core\Render\MainContent\HtmlRenderer.
|
||||
*
|
||||
* In fact, this is not only *typically* used in a limited environment, it even
|
||||
|
|
|
|||
|
|
@ -56,7 +56,7 @@ class Element {
|
|||
/**
|
||||
* Identifies the children of an element array, optionally sorted by weight.
|
||||
*
|
||||
* The children of a element array are those key/value pairs whose key does
|
||||
* The children of an element array are those key/value pairs whose key does
|
||||
* not start with a '#'. See drupal_render() for details.
|
||||
*
|
||||
* @param array $elements
|
||||
|
|
|
|||
|
|
@ -13,7 +13,7 @@ use Drupal\Core\Url as CoreUrl;
|
|||
*
|
||||
* Properties:
|
||||
* - #title: The link text.
|
||||
* - #url: \Drupal\Core\Url object containing URL information pointing to a
|
||||
* - #url: \Drupal\Core\Url object containing URL information pointing to an
|
||||
* internal or external link. See \Drupal\Core\Utility\LinkGeneratorInterface.
|
||||
*
|
||||
* Usage example:
|
||||
|
|
@ -69,7 +69,7 @@ class Link extends RenderElement {
|
|||
}
|
||||
|
||||
// This #pre_render callback can be invoked from inside or outside of a Form
|
||||
// API context, and depending on that, a HTML ID may be already set in
|
||||
// API context, and depending on that, an HTML ID may be already set in
|
||||
// different locations. #options should have precedence over Form API's #id.
|
||||
// #attributes have been taken over into #options above already.
|
||||
if (isset($element['#options']['attributes']['id'])) {
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@ use Drupal\Core\Form\FormStateInterface;
|
|||
* Provides a matched path render element.
|
||||
*
|
||||
* Provides a form element to enter a path which can be optionally validated and
|
||||
* stored as either a \Drupal\Core\Url value object or a array containing a
|
||||
* stored as either a \Drupal\Core\Url value object or an array containing a
|
||||
* route name and route parameters pair.
|
||||
*
|
||||
* @FormElement("path")
|
||||
|
|
|
|||
|
|
@ -382,7 +382,7 @@ class Table extends FormElement {
|
|||
$element['#attributes']['class'][] = 'responsive-enabled';
|
||||
}
|
||||
|
||||
// If the custom #tabledrag is set and there is a HTML ID, add the table's
|
||||
// If the custom #tabledrag is set and there is an HTML ID, add the table's
|
||||
// HTML ID to the options and attach the behavior.
|
||||
if (!empty($element['#tabledrag']) && isset($element['#attributes']['id'])) {
|
||||
foreach ($element['#tabledrag'] as $options) {
|
||||
|
|
|
|||
|
|
@ -45,7 +45,7 @@ class ElementInfoManager extends DefaultPluginManager implements ElementInfoMana
|
|||
protected $cacheTagInvalidator;
|
||||
|
||||
/**
|
||||
* Constructs a ElementInfoManager object.
|
||||
* Constructs an ElementInfoManager object.
|
||||
*
|
||||
* @param \Traversable $namespaces
|
||||
* An object that implements \Traversable which contains the root paths
|
||||
|
|
|
|||
|
|
@ -17,7 +17,7 @@ use Drupal\Core\Theme\ThemeManagerInterface;
|
|||
use Symfony\Component\HttpFoundation\RequestStack;
|
||||
|
||||
/**
|
||||
* Turns a render array into a HTML string.
|
||||
* Turns a render array into an HTML string.
|
||||
*/
|
||||
class Renderer implements RendererInterface {
|
||||
use DoTrustedCallbackTrait;
|
||||
|
|
|
|||
|
|
@ -6,7 +6,7 @@ use Symfony\Component\Routing\Matcher\Dumper\MatcherDumperInterface as SymfonyMa
|
|||
use Symfony\Component\Routing\RouteCollection;
|
||||
|
||||
/**
|
||||
* Extends the symfony matcher dumper interface with a addRoutes method.
|
||||
* Extends the symfony matcher dumper interface with an addRoutes method.
|
||||
*/
|
||||
interface MatcherDumperInterface extends SymfonyMatcherDumperInterface {
|
||||
|
||||
|
|
|
|||
|
|
@ -15,7 +15,7 @@ class SitePathFactory {
|
|||
protected $drupalKernel;
|
||||
|
||||
/**
|
||||
* Constructs an SitePathFactory instance.
|
||||
* Constructs a SitePathFactory instance.
|
||||
*
|
||||
* @param \Drupal\Core\DrupalKernelInterface $drupal_kernel
|
||||
* The Drupal kernel.
|
||||
|
|
|
|||
|
|
@ -38,7 +38,7 @@ use Drupal\Component\Utility\NestedArray;
|
|||
*
|
||||
* The attribute keys and values are automatically escaped for output with
|
||||
* Html::escape(). No protocol filtering is applied, so when using user-entered
|
||||
* input as a value for an attribute that expects an URI (href, src, ...),
|
||||
* input as a value for an attribute that expects a URI (href, src, ...),
|
||||
* UrlHelper::stripDangerousProtocols() should be used to ensure dangerous
|
||||
* protocols (such as 'javascript:') are removed. For example:
|
||||
* @code
|
||||
|
|
|
|||
|
|
@ -501,7 +501,7 @@ class TwigExtension extends AbstractExtension {
|
|||
* RenderableInterface or toString().
|
||||
*
|
||||
* @return mixed
|
||||
* The rendered output or an \Twig\Markup object.
|
||||
* The rendered output or a \Twig\Markup object.
|
||||
*
|
||||
* @see render
|
||||
* @see TwigNodeVisitor
|
||||
|
|
|
|||
|
|
@ -10,7 +10,7 @@ use Drupal\Core\Session\AccountInterface;
|
|||
* While possible values specify which values existing data might have, settable
|
||||
* values define the values that are allowed to be set by a user.
|
||||
*
|
||||
* For example, in an workflow scenario, the settable values for a state field
|
||||
* For example, in a workflow scenario, the settable values for a state field
|
||||
* might depend on the currently set state, while possible values are all
|
||||
* states. Thus settable values would be used in an editing context, while
|
||||
* possible values would be used for presenting filtering options in a search.
|
||||
|
|
|
|||
|
|
@ -10,7 +10,7 @@ use Drupal\Core\TypedData\Type\BinaryInterface;
|
|||
*
|
||||
* The plain value of binary data is a PHP file resource, see
|
||||
* http://php.net/manual/language.types.resource.php. For setting the value
|
||||
* a PHP file resource or a (absolute) stream resource URI may be passed.
|
||||
* a PHP file resource or an (absolute) stream resource URI may be passed.
|
||||
*
|
||||
* @DataType(
|
||||
* id = "binary",
|
||||
|
|
@ -48,7 +48,7 @@ class BinaryData extends PrimitiveBase implements BinaryInterface {
|
|||
/**
|
||||
* Overrides TypedData::setValue().
|
||||
*
|
||||
* Supports a PHP file resource or a (absolute) stream resource URI as value.
|
||||
* Supports a PHP file resource or an (absolute) stream resource URI as value.
|
||||
*/
|
||||
public function setValue($value, $notify = TRUE) {
|
||||
if (!isset($value)) {
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@ use Drupal\Core\TypedData\Type\DurationInterface;
|
|||
/**
|
||||
* The duration ISO8601 data type.
|
||||
*
|
||||
* The plain value of this data type is a ISO8601 duration string.
|
||||
* The plain value of this data type is an ISO8601 duration string.
|
||||
*
|
||||
* @DataType(
|
||||
* id = "duration_iso8601",
|
||||
|
|
|
|||
|
|
@ -9,7 +9,7 @@ use Drupal\Core\TypedData\PrimitiveInterface;
|
|||
*
|
||||
* The plain value of binary data is a PHP file resource, see
|
||||
* http://php.net/manual/language.types.resource.php. For setting the value
|
||||
* a PHP file resource or a (absolute) stream resource URI may be passed.
|
||||
* a PHP file resource or an (absolute) stream resource URI may be passed.
|
||||
*
|
||||
* @ingroup typed_data
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -146,7 +146,7 @@ interface TypedDataManagerInterface extends PluginManagerInterface, CachedDiscov
|
|||
* The parent typed data object, implementing the TypedDataInterface and
|
||||
* either the ListInterface or the ComplexDataInterface.
|
||||
* @param string $property_name
|
||||
* The name of the property to instantiate, or the delta of an list item.
|
||||
* The name of the property to instantiate, or the delta of a list item.
|
||||
* @param mixed $value
|
||||
* (optional) The data value. If set, it has to match one of the supported
|
||||
* data type formats as documented by the data type classes.
|
||||
|
|
|
|||
|
|
@ -3,7 +3,7 @@
|
|||
namespace Drupal\Core\Updater;
|
||||
|
||||
/**
|
||||
* Defines a Exception class for the Drupal\Core\Updater\Updater class
|
||||
* Defines an Exception class for the Drupal\Core\Updater\Updater class
|
||||
* hierarchy.
|
||||
*
|
||||
* This is identical to the base Exception class, we just give it a more
|
||||
|
|
|
|||
|
|
@ -334,7 +334,7 @@ class Url implements TrustedCallbackInterface {
|
|||
* Create a new Url object for entity URIs.
|
||||
*
|
||||
* @param array $uri_parts
|
||||
* Parts from an URI of the form entity:{entity_type}/{entity_id} as from
|
||||
* Parts from a URI of the form entity:{entity_type}/{entity_id} as from
|
||||
* parse_url().
|
||||
* @param array $options
|
||||
* An array of options, see \Drupal\Core\Url::fromUri() for details.
|
||||
|
|
@ -387,12 +387,12 @@ class Url implements TrustedCallbackInterface {
|
|||
* - 'internal:/some-path' (path component is '/some-path') to 'some-path'
|
||||
*
|
||||
* @param array $uri_parts
|
||||
* Parts from an URI of the form internal:{path} as from parse_url().
|
||||
* Parts from a URI of the form internal:{path} as from parse_url().
|
||||
* @param array $options
|
||||
* An array of options, see \Drupal\Core\Url::fromUri() for details.
|
||||
*
|
||||
* @return static
|
||||
* A new Url object for a 'internal:' URI.
|
||||
* A new Url object for an 'internal:' URI.
|
||||
*
|
||||
* @throws \InvalidArgumentException
|
||||
* Thrown when the URI's path component doesn't have a leading slash.
|
||||
|
|
@ -432,7 +432,7 @@ class Url implements TrustedCallbackInterface {
|
|||
* Creates a new Url object for 'route:' URIs.
|
||||
*
|
||||
* @param array $uri_parts
|
||||
* Parts from an URI of the form route:{route_name};{route_parameters} as
|
||||
* Parts from a URI of the form route:{route_name};{route_parameters} as
|
||||
* from parse_url(), where the path is the route name optionally followed by
|
||||
* a ";" followed by route parameters in key=value format with & separators.
|
||||
* @param array $options
|
||||
|
|
@ -511,7 +511,7 @@ class Url implements TrustedCallbackInterface {
|
|||
* Generates a URI string that represents the data in the Url object.
|
||||
*
|
||||
* The URI will typically have the scheme of route: even if the object was
|
||||
* constructed using an entity: or internal: scheme. A internal: URI that
|
||||
* constructed using an entity: or internal: scheme. An internal: URI that
|
||||
* does not match a Drupal route with be returned here with the base: scheme,
|
||||
* and external URLs will be returned in their original form.
|
||||
*
|
||||
|
|
|
|||
|
|
@ -130,7 +130,7 @@ class ProjectInfo {
|
|||
}
|
||||
elseif (empty($status)) {
|
||||
// If we have a project_name that matches, but the project_display_type
|
||||
// does not, it means we're processing a uninstalled module or theme
|
||||
// does not, it means we're processing an uninstalled module or theme
|
||||
// that belongs to a project that has some enabled code. In this case,
|
||||
// we add the uninstalled thing into a separate array for separate
|
||||
// display.
|
||||
|
|
|
|||
|
|
@ -1208,7 +1208,7 @@
|
|||
* @param {string} [response.method]
|
||||
* The jQuery DOM manipulation method to be used.
|
||||
* @param {string} [response.selector]
|
||||
* A optional jQuery selector string.
|
||||
* An optional jQuery selector string.
|
||||
* @param {object} [response.settings]
|
||||
* An optional array of settings that will be used.
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -45,7 +45,7 @@
|
|||
}
|
||||
|
||||
/**
|
||||
* Returns the last value of an multi-value textfield.
|
||||
* Returns the last value of a multi-value textfield.
|
||||
*
|
||||
* @function Drupal.autocomplete.extractLastTerm
|
||||
*
|
||||
|
|
|
|||
|
|
@ -54,7 +54,7 @@
|
|||
* Scan a dialog for any primary buttons and move them to the button area.
|
||||
*
|
||||
* @param {jQuery} $dialog
|
||||
* An jQuery object containing the element that is the dialog target.
|
||||
* A jQuery object containing the element that is the dialog target.
|
||||
*
|
||||
* @return {Array}
|
||||
* An array of buttons that need to be added to the button area.
|
||||
|
|
|
|||
|
|
@ -8,7 +8,7 @@
|
|||
* Off-canvas dialog implementation using jQuery Dialog.
|
||||
*
|
||||
* Transforms the regular dialogs created using Drupal.dialog when the dialog
|
||||
* element equals '#drupal-off-canvas' into an side-loading dialog.
|
||||
* element equals '#drupal-off-canvas' into a side-loading dialog.
|
||||
*
|
||||
* @namespace
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -21,7 +21,7 @@ use Drupal\Core\Plugin\DefaultPluginManager;
|
|||
class AggregatorPluginManager extends DefaultPluginManager {
|
||||
|
||||
/**
|
||||
* Constructs a AggregatorPluginManager object.
|
||||
* Constructs an AggregatorPluginManager object.
|
||||
*
|
||||
* @param string $type
|
||||
* The plugin type, for example fetcher.
|
||||
|
|
|
|||
|
|
@ -26,7 +26,7 @@ class Rss extends RssPluginBase {
|
|||
public $base_table = 'aggregator_item';
|
||||
|
||||
/**
|
||||
* The actual field which is used to identify a aggregator item.
|
||||
* The actual field which is used to identify an aggregator item.
|
||||
*
|
||||
* @var string
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -333,7 +333,7 @@ EOF;
|
|||
}
|
||||
|
||||
/**
|
||||
* Returns a example RSS091 feed.
|
||||
* Returns an example RSS091 feed.
|
||||
*
|
||||
* @return string
|
||||
* Path to the feed.
|
||||
|
|
@ -343,7 +343,7 @@ EOF;
|
|||
}
|
||||
|
||||
/**
|
||||
* Returns a example Atom feed.
|
||||
* Returns an example Atom feed.
|
||||
*
|
||||
* @return string
|
||||
* Path to the feed.
|
||||
|
|
@ -355,7 +355,7 @@ EOF;
|
|||
}
|
||||
|
||||
/**
|
||||
* Returns a example feed.
|
||||
* Returns an example feed.
|
||||
*
|
||||
* @return string
|
||||
* Path to the feed.
|
||||
|
|
|
|||
|
|
@ -91,7 +91,7 @@ class IntegrationTest extends ViewsKernelTestBase {
|
|||
$values['timestamp'] = mt_rand(REQUEST_TIME - 10, REQUEST_TIME + 10);
|
||||
$values['title'] = $this->randomMachineName();
|
||||
$values['description'] = $this->randomMachineName();
|
||||
// Add a image to ensure that the sanitizing can be tested below.
|
||||
// Add an image to ensure that the sanitizing can be tested below.
|
||||
$values['author'] = $this->randomMachineName() . '<img src="http://example.com/example.png" \>"';
|
||||
$values['link'] = 'https://www.drupal.org/node/' . mt_rand(1000, 10000);
|
||||
$values['guid'] = $this->randomString();
|
||||
|
|
|
|||
|
|
@ -23,7 +23,7 @@ use Symfony\Component\HttpKernel\KernelEvents;
|
|||
/**
|
||||
* Service for sending an HTML response in chunks (to get faster page loads).
|
||||
*
|
||||
* At a high level, BigPipe sends a HTML response in chunks:
|
||||
* At a high level, BigPipe sends an HTML response in chunks:
|
||||
* 1. one chunk: everything until just before </body> — this contains BigPipe
|
||||
* placeholders for the personalized parts of the page. Hence this sends the
|
||||
* non-personalized parts of the page. Let's call it The Skeleton.
|
||||
|
|
@ -58,7 +58,7 @@ use Symfony\Component\HttpKernel\KernelEvents;
|
|||
* the logic though, we choose to call this "no-JS BigPipe".
|
||||
*
|
||||
* However, there is also a tangible benefit: some dynamic/expensive content is
|
||||
* not HTML, but for example a HTML attribute value (or part thereof). It's not
|
||||
* not HTML, but for example an HTML attribute value (or part thereof). It's not
|
||||
* possible to efficiently replace such content using JavaScript, so "classic"
|
||||
* BigPipe is out of the question. For example: CSRF tokens in URLs.
|
||||
*
|
||||
|
|
@ -68,7 +68,7 @@ use Symfony\Component\HttpKernel\KernelEvents;
|
|||
* Finally, a closer look at the implementation, and how it supports and reuses
|
||||
* existing Drupal concepts:
|
||||
* 1. BigPipe placeholders: 1 HtmlResponse + N embedded AjaxResponses.
|
||||
* - Before a BigPipe response is sent, it is just a HTML response that
|
||||
* - Before a BigPipe response is sent, it is just an HTML response that
|
||||
* contains BigPipe placeholders. Those placeholders look like
|
||||
* <span data-big-pipe-placeholder-id="…"></span>. JavaScript is used to
|
||||
* replace those placeholders.
|
||||
|
|
@ -76,9 +76,9 @@ use Symfony\Component\HttpKernel\KernelEvents;
|
|||
* - The Skeleton of course has attachments, including most notably asset
|
||||
* libraries. And those we track in drupalSettings.ajaxPageState.libraries —
|
||||
* so that when we load new content through AJAX, we don't load the same
|
||||
* asset libraries again. A HTML page can have multiple AJAX responses, each
|
||||
* of which should take into account the combined AJAX page state of the
|
||||
* HTML document and all preceding AJAX responses.
|
||||
* asset libraries again. An HTML page can have multiple AJAX responses,
|
||||
* each of which should take into account the combined AJAX page state of
|
||||
* the HTML document and all preceding AJAX responses.
|
||||
* - BigPipe does not make use of multiple AJAX requests/responses. It uses a
|
||||
* single HTML response. But it is a more long-lived one: The Skeleton is
|
||||
* sent first, the closing </body> tag is not yet sent, and the connection
|
||||
|
|
@ -100,7 +100,7 @@ use Symfony\Component\HttpKernel\KernelEvents;
|
|||
* 1. <span data-big-pipe-nojs-placeholder-id="…"></span> if it's a
|
||||
* placeholder that will be replaced by HTML
|
||||
* 2. big_pipe_nojs_placeholder_attribute_safe:… if it's a placeholder
|
||||
* inside a HTML attribute, in which 1. would be invalid (angle brackets
|
||||
* inside an HTML attribute, in which 1. would be invalid (angle brackets
|
||||
* are not allowed inside HTML attributes)
|
||||
* No-JS BigPipe placeholders are not replaced using JavaScript, they must
|
||||
* be replaced upon sending the BigPipe response. So, while the response is
|
||||
|
|
@ -526,7 +526,7 @@ class BigPipe {
|
|||
// Send the start signal.
|
||||
$this->sendChunk("\n" . static::START_SIGNAL . "\n");
|
||||
|
||||
// A BigPipe response consists of a HTML response plus multiple embedded
|
||||
// A BigPipe response consists of an HTML response plus multiple embedded
|
||||
// AJAX responses. To process the attachments of those AJAX responses, we
|
||||
// need a fake request that is identical to the master request, but with
|
||||
// one change: it must have the right Accept header, otherwise the work-
|
||||
|
|
@ -617,7 +617,7 @@ EOF;
|
|||
* A fake subrequest that contains the cumulative AJAX page state of the
|
||||
* HTML document and all preceding Embedded HTML or AJAX responses.
|
||||
* @param \Symfony\Component\HttpFoundation\Response|\Drupal\Core\Render\HtmlResponse|\Drupal\Core\Ajax\AjaxResponse $embedded_response
|
||||
* Either a HTML response or an AJAX response that will be embedded in the
|
||||
* Either an HTML response or an AJAX response that will be embedded in the
|
||||
* overall HTML response.
|
||||
*
|
||||
* @return \Symfony\Component\HttpFoundation\Response
|
||||
|
|
@ -752,7 +752,7 @@ EOF;
|
|||
}
|
||||
|
||||
/**
|
||||
* Splits a HTML string into fragments.
|
||||
* Splits an HTML string into fragments.
|
||||
*
|
||||
* Creates an array of HTML fragments, separated by placeholders. The result
|
||||
* includes the placeholders themselves. The original order is respected.
|
||||
|
|
|
|||
|
|
@ -176,8 +176,8 @@ class BigPipeStrategy implements PlaceholderStrategyInterface {
|
|||
* A placeholder.
|
||||
*
|
||||
* @return bool
|
||||
* Whether the placeholder is safe for use in a HTML attribute (in case it's
|
||||
* a placeholder for a HTML attribute value or a subset of it).
|
||||
* Whether the placeholder is safe for use in an HTML attribute (in case
|
||||
* it's a placeholder for an HTML attribute value or a subset of it).
|
||||
*/
|
||||
protected static function placeholderIsAttributeSafe($placeholder) {
|
||||
assert(is_string($placeholder));
|
||||
|
|
@ -229,8 +229,8 @@ class BigPipeStrategy implements PlaceholderStrategyInterface {
|
|||
* @param array $placeholder_render_array
|
||||
* The render array for a placeholder.
|
||||
* @param bool $placeholder_must_be_attribute_safe
|
||||
* Whether the placeholder must be safe for use in a HTML attribute (in case
|
||||
* it's a placeholder for a HTML attribute value or a subset of it).
|
||||
* Whether the placeholder must be safe for use in an HTML attribute (in
|
||||
* case it's a placeholder for an HTML attribute value or a subset of it).
|
||||
*
|
||||
* @return array
|
||||
* The resulting BigPipe no-JS placeholder render array.
|
||||
|
|
|
|||
|
|
@ -9,7 +9,7 @@ use Drupal\Core\Security\TrustedCallbackInterface;
|
|||
class BigPipeTestController implements TrustedCallbackInterface {
|
||||
|
||||
/**
|
||||
* Returns a all BigPipe placeholder test case render arrays.
|
||||
* Returns all BigPipe placeholder test case render arrays.
|
||||
*
|
||||
* @return array
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -182,7 +182,7 @@ class BlockListBuilder extends ConfigEntityListBuilder implements FormInterface
|
|||
|
||||
// Weights range from -delta to +delta, so delta should be at least half
|
||||
// of the amount of blocks present. This makes sure all blocks in the same
|
||||
// region get an unique weight.
|
||||
// region get a unique weight.
|
||||
$weight_delta = round(count($entities) / 2);
|
||||
|
||||
$placement = FALSE;
|
||||
|
|
|
|||
|
|
@ -35,7 +35,7 @@ interface RefinableDependentAccessInterface extends DependentAccessInterface {
|
|||
* instance with the existing and new dependencies as the members of the
|
||||
* group.
|
||||
*
|
||||
* If there is an existing dependency and it is a instance of AccessGroupAnd
|
||||
* If there is an existing dependency and it is an instance of AccessGroupAnd
|
||||
* the dependency will be added to the existing access group.
|
||||
*
|
||||
* @param \Drupal\Core\Access\AccessibleInterface $access_dependency
|
||||
|
|
|
|||
|
|
@ -31,7 +31,7 @@ interface BookManagerInterface {
|
|||
* $link, in which case $max_depth should be greater than $link['depth'].
|
||||
*
|
||||
* @return array
|
||||
* An tree of menu links in an array, in the order they should be rendered.
|
||||
* A tree of menu links in an array, in the order they should be rendered.
|
||||
*/
|
||||
public function bookTreeAllData($bid, $link = NULL, $max_depth = NULL);
|
||||
|
||||
|
|
|
|||
|
|
@ -16,7 +16,7 @@ use Drupal\Core\StringTranslation\TranslationInterface;
|
|||
/**
|
||||
* Defines a breakpoint plugin manager to deal with breakpoints.
|
||||
*
|
||||
* Extension can define breakpoints in a EXTENSION_NAME.breakpoints.yml file
|
||||
* Extension can define breakpoints in an EXTENSION_NAME.breakpoints.yml file
|
||||
* contained in the extension's base directory. Each breakpoint has the
|
||||
* following structure:
|
||||
* @code
|
||||
|
|
|
|||
|
|
@ -49,7 +49,7 @@ class ColorSafePreviewTest extends BrowserTestBase {
|
|||
\Drupal::service('theme_installer')->install(['color_test_theme']);
|
||||
$this->drupalLogin($this->bigUser);
|
||||
|
||||
// Markup is being printed from a HTML file located in:
|
||||
// Markup is being printed from an HTML file located in:
|
||||
// core/modules/color/tests/modules/color_test/themes/color_test_theme/color/preview.html
|
||||
$url = Url::fromRoute('system.theme_settings_theme', ['theme' => 'color_test_theme']);
|
||||
$this->drupalGet($url);
|
||||
|
|
|
|||
|
|
@ -22,7 +22,7 @@ function comment_token_info() {
|
|||
];
|
||||
|
||||
$tokens = [];
|
||||
// Provide a integration for each entity type except comment.
|
||||
// Provides an integration for each entity type except comment.
|
||||
foreach (\Drupal::entityTypeManager()->getDefinitions() as $entity_type_id => $entity_type) {
|
||||
if ($entity_type_id == 'comment' || !$entity_type->entityClassImplements(ContentEntityInterface::class)) {
|
||||
continue;
|
||||
|
|
|
|||
|
|
@ -22,7 +22,7 @@ function comment_views_data_alter(&$data) {
|
|||
],
|
||||
];
|
||||
|
||||
// Provide a integration for each entity type except comment.
|
||||
// Provides an integration for each entity type except comment.
|
||||
foreach (\Drupal::entityTypeManager()->getDefinitions() as $entity_type_id => $entity_type) {
|
||||
if ($entity_type_id == 'comment' || !$entity_type->entityClassImplements(ContentEntityInterface::class) || !$entity_type->getBaseTable()) {
|
||||
continue;
|
||||
|
|
|
|||
|
|
@ -7,7 +7,7 @@ use Drupal\Core\Field\FieldItemList;
|
|||
use Drupal\Core\Session\AccountInterface;
|
||||
|
||||
/**
|
||||
* Defines a item list class for comment fields.
|
||||
* Defines an item list class for comment fields.
|
||||
*/
|
||||
class CommentFieldItemList extends FieldItemList {
|
||||
|
||||
|
|
|
|||
|
|
@ -242,7 +242,7 @@ class CommentController extends ControllerBase {
|
|||
$build['comment_parent'] = $this->entityTypeManager()->getViewBuilder('comment')->view($comment);
|
||||
}
|
||||
|
||||
// The comment is in response to a entity.
|
||||
// The comment is in response to an entity.
|
||||
elseif ($entity->access('view', $account)) {
|
||||
// We make sure the field value isn't set so we don't end up with a
|
||||
// redirect loop.
|
||||
|
|
|
|||
|
|
@ -37,7 +37,7 @@ class UnpublishByKeywordComment extends ConfigurableActionBase implements Contai
|
|||
protected $renderer;
|
||||
|
||||
/**
|
||||
* Constructs a UnpublishByKeywordComment object.
|
||||
* Constructs an UnpublishByKeywordComment object.
|
||||
*
|
||||
* @param array $configuration
|
||||
* A configuration array containing information about the plugin instance.
|
||||
|
|
|
|||
|
|
@ -33,7 +33,7 @@ class EntityComment extends EntityContentBase {
|
|||
protected $stubCommentedEntityIds;
|
||||
|
||||
/**
|
||||
* Builds an comment entity destination.
|
||||
* Builds a comment entity destination.
|
||||
*
|
||||
* @param array $configuration
|
||||
* A configuration array containing information about the plugin instance.
|
||||
|
|
|
|||
|
|
@ -227,7 +227,7 @@ class CommentLinkBuilderTest extends UnitTestCase {
|
|||
// If the view mode is teaser, or the user can access comments and
|
||||
// comments exist or the form is on a separate page.
|
||||
if ($combination['view_mode'] == 'teaser' || ($combination['has_access_comments'] && $combination['comment_count']) || $combination['form_location'] == CommentItemInterface::FORM_SEPARATE_PAGE) {
|
||||
// There should be a add comment link.
|
||||
// There should be an add comment link.
|
||||
$expected['comment-add'] = ['title' => 'Add new comment'];
|
||||
if ($combination['form_location'] == CommentItemInterface::FORM_BELOW) {
|
||||
// On the same page.
|
||||
|
|
|
|||
|
|
@ -173,7 +173,7 @@ class ConfigExportImportUITest extends BrowserTestBase {
|
|||
$this->assertText($this->contentType->label());
|
||||
|
||||
$this->drupalPostForm(NULL, [], 'Import all');
|
||||
// After importing the snapshot has been updated an there are no warnings.
|
||||
// After importing the snapshot has been updated and there are no warnings.
|
||||
$this->assertNoText('Warning message');
|
||||
$this->assertText('There are no configuration changes to import.');
|
||||
|
||||
|
|
|
|||
|
|
@ -14,7 +14,7 @@ use Symfony\Component\DependencyInjection\ContainerInterface;
|
|||
class ConfigTranslationMapperList extends ControllerBase {
|
||||
|
||||
/**
|
||||
* A array of configuration mapper instances.
|
||||
* An array of configuration mapper instances.
|
||||
*
|
||||
* @var \Drupal\config_translation\ConfigMapperInterface[]
|
||||
*/
|
||||
|
|
|
|||
|
|
@ -40,7 +40,7 @@ class DynamicLocalTasks extends DeriverBase implements ContainerDeriverInterface
|
|||
protected $moderationInfo;
|
||||
|
||||
/**
|
||||
* Creates an FieldUiLocalTask object.
|
||||
* Creates a FieldUiLocalTask object.
|
||||
*
|
||||
* @param string $base_plugin_id
|
||||
* The base plugin ID.
|
||||
|
|
|
|||
|
|
@ -38,7 +38,7 @@ process:
|
|||
new_nid:
|
||||
-
|
||||
# If the path is of the form "node/<ID>" and is not routed, we will get
|
||||
# back an URI of the form "base:node/<ID>".
|
||||
# back a URI of the form "base:node/<ID>".
|
||||
plugin: link_uri
|
||||
source: link_path
|
||||
validate_route: false
|
||||
|
|
|
|||
|
|
@ -151,7 +151,7 @@ abstract class DateTestBase extends BrowserTestBase {
|
|||
}
|
||||
|
||||
/**
|
||||
* Renders a entity_test and sets the output in the internal browser.
|
||||
* Renders an entity_test and sets the output in the internal browser.
|
||||
*
|
||||
* @param int $id
|
||||
* The entity_test ID to render.
|
||||
|
|
|
|||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in New Issue