Drupal
/
drupal
mirror of https://git.drupalcode.org/project/drupal.git
1
0
Fork 0
Code Issues Projects Releases Wiki Activity

Issue #2344045 by jhodgdon, EclipseGc, chx, CocoaBean, andrei.dincu, tim.plunkett, fago: ContextInterface needs documentation

8.4.x
Gabor Hojtsy 2017-04-11 21:41:43 +02:00
parent c8d1f0b157
commit 33aa003a14
4 changed files with 19 additions and 4 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

4
core/lib/Drupal/Component/Plugin/Context/ContextDefinitionInterface.php
View File

@ -3,7 +3,9 @@
namespace Drupal\Component\Plugin\Context; namespace Drupal\Component\Plugin\Context;
/** /**
* Interface for context definitions. * Interface used to define definition objects found in ContextInterface.
*
* @see \Drupal\Component\Plugin\Context\ContextInterface
* *
* @todo WARNING: This interface is going to receive some additions as part of * @todo WARNING: This interface is going to receive some additions as part of
* https://www.drupal.org/node/2346999. * https://www.drupal.org/node/2346999.

9
core/lib/Drupal/Component/Plugin/Context/ContextInterface.php
View File

@ -3,7 +3,14 @@
namespace Drupal\Component\Plugin\Context; namespace Drupal\Component\Plugin\Context;
/** /**
* A generic context interface for wrapping data a plugin needs to operate. * Provides data and definitions for plugins during runtime and administration.
*
* Plugin contexts are satisfied by ContextInterface implementing objects.
* These objects always contain a definition of what data they will provide
* during runtime. During run time, ContextInterface implementing objects must
* also provide the corresponding data value.
*
* @see \Drupal\Component\Plugin\Context\ContextDefinitionInterface
*/ */
interface ContextInterface { interface ContextInterface {

5
core/lib/Drupal/Core/Plugin/Context/ContextDefinitionInterface.php
View File

@ -5,7 +5,10 @@ namespace Drupal\Core\Plugin\Context;
use Drupal\Component\Plugin\Context\ContextDefinitionInterface as ComponentContextDefinitionInterface; use Drupal\Component\Plugin\Context\ContextDefinitionInterface as ComponentContextDefinitionInterface;
/** /**
* Interface for context definitions. * Interface to define definition objects in ContextInterface via TypedData.
*
* @see \Drupal\Component\Plugin\Context\ContextDefinitionInterface
* @see \Drupal\Core\Plugin\Context\ContextInterface
*/ */
interface ContextDefinitionInterface extends ComponentContextDefinitionInterface { interface ContextDefinitionInterface extends ComponentContextDefinitionInterface {

5
core/lib/Drupal/Core/Plugin/Context/ContextInterface.php
View File

@ -6,7 +6,10 @@ use Drupal\Component\Plugin\Context\ContextInterface as ComponentContextInterfac
use Drupal\Core\Cache\CacheableDependencyInterface; use Drupal\Core\Cache\CacheableDependencyInterface;
/** /**
* Interface for context. * Context data and definitions for plugins supporting caching and return docs.
*
* @see \Drupal\Component\Plugin\Context\ContextInterface
* @see \Drupal\Core\Plugin\Context\ContextDefinitionInterface
*/ */
interface ContextInterface extends ComponentContextInterface, CacheableDependencyInterface { interface ContextInterface extends ComponentContextInterface, CacheableDependencyInterface {