Include html text inside a Drupal 8 generated link

Question

I have a hard time to style a link via the Drupal 8 render structure. This link needs to be displayed in my custom module:

$add_link = \Drupal::l('<i class="fa fa-cog"></i>' . t('Add new project'), $url);

So between de tags I want a Font awesome icon in front of the text. But Drupal print all html out as readable text.

I also notice that the l() function is deprecated in Drupal 8. So what is the best way to do this in the Drupal 8 render structure?

Answer 1

If, like me, you wanted to use a render array of #type => 'link' and include an icon with it then you can do the following:

<?php
use Drupal\Core\Render\Markup;
use Drupal\Core\Url;

$form['actions']['reset_password'] = [
  '#type' => 'link',
  '#title' => Markup::create('<span class="glyphicon glyphicon-cog"></span> Forgot / Reset Password'),
  '#url' => Url::fromRoute('user.pass'),
];