class PluralTranslation in Drupal 10

Defines an annotation object for strings that require plural forms.

Note that the return values for both 'singular' and 'plural' keys needs to be passed to \Drupal\Core\StringTranslation\TranslationInterface::formatPlural().

For example, the annotation can look like this:

  label_count = @ PluralTranslation(
    singular = "@count item",
    plural = "@count items",
    context = "cart_items",
  ),

Remove spaces after @ in your actual plugin - these are put into this sample code so that it is not recognized as annotation.

Code samples that make use of this annotation class and the definition sample above:

// Returns: 1 item
$entity_type
  ->getCountLabel(1);

// Returns: 5 items
$entity_type
  ->getCountLabel(5);

Hierarchy

• class \Drupal\Component\Annotation\AnnotationBase implements AnnotationInterface
  • class \Drupal\Core\Annotation\PluralTranslation

See also

\Drupal\Core\Entity\EntityType::getSingularLabel()

\Drupal\Core\Entity\EntityType::getPluralLabel()

\Drupal\Core\Entity\EntityType::getCountLabel()

Related topics

Annotation for translatable text

Describes how to put translatable UI text into annotations.

Annotations

Annotations for class discovery and metadata description.

1 file declares its use of PluralTranslation

PluralTranslationTest.php in core/tests/Drupal/Tests/Core/Annotation/PluralTranslationTest.php

File

core/lib/Drupal/Core/Annotation/PluralTranslation.php, line 43

Namespace

Drupal\Core\Annotation

class PluralTranslation extends AnnotationBase {

  /**
   * The string for the singular case.
   *
   * @var string
   */
  protected $singular;

  /**
   * The string for the plural case.
   *
   * @var string
   */
  protected $plural;

  /**
   * The context the source strings belong to.
   *
   * @var string
   */
  protected $context;

  /**
   * Constructs a new class instance.
   *
   * @param array $values
   *   An associative array with the following keys:
   *   - singular: The string for the singular case.
   *   - plural: The string for the plural case.
   *   - context: The context the source strings belong to.
   *
   * @throws \InvalidArgumentException
   *   Thrown when the keys 'singular' or 'plural' are missing from the $values
   *   array.
   */
  public function __construct(array $values) {
    if (!isset($values['singular'])) {
      throw new \InvalidArgumentException('Missing "singular" value in the PluralTranslation annotation');
    }
    if (!isset($values['plural'])) {
      throw new \InvalidArgumentException('Missing "plural" value in the PluralTranslation annotation');
    }
    $this->singular = $values['singular'];
    $this->plural = $values['plural'];
    if (isset($values['context'])) {
      $this->context = $values['context'];
    }
  }

  /**
   * {@inheritdoc}
   */
  public function get() {
    return [
      'singular' => $this->singular,
      'plural' => $this->plural,
      'context' => $this->context,
    ];
  }

}

Members

Name	Modifiers	Type	Description	Overrides
AnnotationBase::$class	protected	property	The class used for this annotated class.
AnnotationBase::$id	public	property	The annotated class ID.	1
AnnotationBase::$provider	protected	property	The provider of the annotated class.
AnnotationBase::getClass	public	function	Gets the class of the annotated class. Overrides AnnotationInterface::getClass
AnnotationBase::getId	public	function	Gets the unique ID for this annotated class. Overrides AnnotationInterface::getId	1
AnnotationBase::getProvider	public	function	Gets the name of the provider of the annotated class. Overrides AnnotationInterface::getProvider
AnnotationBase::setClass	public	function	Sets the class of the annotated class. Overrides AnnotationInterface::setClass
AnnotationBase::setProvider	public	function	Sets the name of the provider of the annotated class. Overrides AnnotationInterface::setProvider
PluralTranslation::$context	protected	property	The context the source strings belong to.
PluralTranslation::$plural	protected	property	The string for the plural case.
PluralTranslation::$singular	protected	property	The string for the singular case.
PluralTranslation::get	public	function	Gets the value of an annotation. Overrides AnnotationInterface::get
PluralTranslation::__construct	public	function	Constructs a new class instance.