Chris@18: <?php
Chris@18: 
Chris@18: namespace Drupal\Core\Ajax;
Chris@18: 
Chris@18: use Drupal\Core\Asset\AttachedAssets;
Chris@18: 
Chris@18: /**
Chris@18:  * AJAX command for a JavaScript Drupal.announce() call.
Chris@18:  *
Chris@18:  * @ingroup ajax
Chris@18:  */
Chris@18: class AnnounceCommand implements CommandInterface, CommandWithAttachedAssetsInterface {
Chris@18: 
Chris@18:   /**
Chris@18:    * The assertive priority attribute value.
Chris@18:    *
Chris@18:    * @var string
Chris@18:    */
Chris@18:   const PRIORITY_ASSERTIVE = 'assertive';
Chris@18: 
Chris@18:   /**
Chris@18:    * The polite priority attribute value.
Chris@18:    *
Chris@18:    * @var string
Chris@18:    */
Chris@18:   const PRIORITY_POLITE = 'polite';
Chris@18: 
Chris@18:   /**
Chris@18:    * The text to be announced.
Chris@18:    *
Chris@18:    * @var string
Chris@18:    */
Chris@18:   protected $text;
Chris@18: 
Chris@18:   /**
Chris@18:    * The priority that will be used for the announcement.
Chris@18:    *
Chris@18:    * @var string
Chris@18:    */
Chris@18:   protected $priority;
Chris@18: 
Chris@18:   /**
Chris@18:    * Constructs an AnnounceCommand object.
Chris@18:    *
Chris@18:    * @param string $text
Chris@18:    *   The text to be announced.
Chris@18:    * @param string|null $priority
Chris@18:    *   (optional) The priority that will be used for the announcement. Defaults
Chris@18:    *   to NULL which will not set a 'priority' in the response sent to the
Chris@18:    *   client and therefore the JavaScript Drupal.announce() default of 'polite'
Chris@18:    *   will be used for the message.
Chris@18:    */
Chris@18:   public function __construct($text, $priority = NULL) {
Chris@18:     $this->text = $text;
Chris@18:     $this->priority = $priority;
Chris@18:   }
Chris@18: 
Chris@18:   /**
Chris@18:    * {@inheritdoc}
Chris@18:    */
Chris@18:   public function render() {
Chris@18:     $render = [
Chris@18:       'command' => 'announce',
Chris@18:       'text' => $this->text,
Chris@18:     ];
Chris@18:     if ($this->priority !== NULL) {
Chris@18:       $render['priority'] = $this->priority;
Chris@18:     }
Chris@18:     return $render;
Chris@18:   }
Chris@18: 
Chris@18:   /**
Chris@18:    * {@inheritdoc}
Chris@18:    */
Chris@18:   public function getAttachedAssets() {
Chris@18:     $assets = new AttachedAssets();
Chris@18:     $assets->setLibraries(['core/drupal.announce']);
Chris@18:     return $assets;
Chris@18:   }
Chris@18: 
Chris@18: }