You are here

Home » API reference » Express 8 » Link.php

class Link in Express 8

Pre-render callback for the "link" element type.

Plugin annotation


@BootstrapPrerender("link",
  action = @BootstrapConstant(
    "\Drupal\bootstrap\Bootstrap::CALLBACK_PREPEND"
  )
)

Hierarchy

Expanded class hierarchy of Link

See also

\Drupal\Core\Render\Element\Link::preRenderLink()

File

themes/contrib/bootstrap/src/Plugin/Prerender/Link.php, line 28
Contains \Drupal\bootstrap\Plugin\Prerender\Link.

Namespace

Drupal\bootstrap\Plugin\Prerender
View source 
class Link extends PrerenderBase {

  /**
   * {@inheritdoc}
   */
  public static function preRenderElement(Element $element) {

    // Injects the icon into the title (the only way this is possible).
    if ($icon =& $element
      ->getProperty('icon')) {
      $title = $element
        ->getProperty('title');

      // Handle #icon_only.
      if ($element
        ->getProperty('icon_only')) {
        if ($attribute_title = $element
          ->getAttribute('title', '')) {
          $title .= ' - ' . $attribute_title;
        }
        $element
          ->setAttribute('title', $title)
          ->addClass('icon-only')
          ->setProperty('title', $icon);
        if (Bootstrap::getTheme()
          ->getSetting('tooltip_enabled')) {
          $element
            ->setAttribute('data-toggle', 'tooltip');
        }
        return;
      }

      // Handle #icon_position.
      $position = $element
        ->getProperty('icon_position', 'before');

      // Render #icon and trim it (so it doesn't add underlines in whitespace).
      $rendered_icon = trim(Element::create($icon)
        ->renderPlain());

      // Default position is before.
      $markup = "{$rendered_icon}@title";
      if ($position === 'after') {
        $markup = "@title{$rendered_icon}";
      }

      // Replace the title and set an icon position class.
      $element
        ->setProperty('title', new FormattableMarkup($markup, [
        '@title' => $title,
      ]))
        ->addClass("icon-{$position}");
    }
  }

}

Members

Namesort descending Modifiers Type Description Overrides
Link::preRenderElement public static function Pre-render element callback. Overrides PrerenderBase::preRenderElement
PrerenderBase::preRender public static function Pre-render render array element callback. Overrides PrerenderInterface::preRender