` and viewBox.
*/
function symbolGeometry(string $file): string
{
$svg = trim((string) file_get_contents(__DIR__.'/../../../resources/svg/symbols/'.$file.'.svg'));
return substr($svg, (int) strpos($svg, '><') + 1);
}
it('draws a symbol inline, hidden from screen readers, 24px by default', function () {
$this->blade('')
->assertSee('data-md-icon', false)
->assertDontSee('--md-icon-size', false)
->assertDontSee('class=', false)
->assertSee('aria-hidden="true"', false)
->assertSee('fill="currentColor"', false)
->assertSee('viewBox="0 -960 960 960"', false);
});
it('draws the size it is given, and still takes a caller\'s class', function () {
$this->blade('')
->assertSee('style="--md-icon-size: 32px"', false);
$this->blade('')
->assertSee('class="size-4 text-primary"', false);
});
it('ignores a size that is not a whole number of pixels in range', function () {
foreach (['large', '4', '300', '20.5'] as $size) {
$this->blade('')
->assertDontSee('--md-icon-size', false);
}
});
it('takes the 20 cut for a size of 20 or less, unless optical says otherwise', function () {
expect((string) $this->blade(''))->toContain(symbolGeometry('outlined-20/home'))
->and((string) $this->blade(''))->toContain(symbolGeometry('outlined-20/home'))
->and((string) $this->blade(''))->toContain(symbolGeometry('outlined/home'))
->and((string) $this->blade(''))->toContain(symbolGeometry('outlined/home'));
});
it('mirrors a directional symbol only when asked', function () {
$this->blade('')->assertSee('data-md-mirror-rtl', false);
$this->blade('')->assertDontSee('data-md-mirror-rtl', false);
});
it('draws its size from a stylesheet in the components layer', function () {
$css = (string) file_get_contents(__DIR__.'/../../../resources/css/components/icon.css');
expect($css)->toContain('@layer material.components')
->toContain('inline-size: var(--md-icon-size, 24px)')
->toContain('[data-md-icon][data-md-mirror-rtl]:dir(rtl)')
->and((string) file_get_contents(__DIR__.'/../../../resources/css/components.css'))->toContain("@import './components/icon.css';");
});
it('names the icon for a screen reader when it carries the meaning alone', function () {
$this->blade('')
->assertSee('aria-label="Password protected"', false)
->assertSee('role="img"', false)
->assertDontSee('aria-hidden', false);
});
it('draws the filled symbol when asked', function () {
$outlined = (string) $this->blade('');
$filled = (string) $this->blade('');
expect($filled)->not->toBe($outlined)
->and($filled)->toContain('blade('');
$dense = (string) $this->blade('');
expect($dense)->not->toBe($standard)
->and($dense)->toContain('class="size-5"')
->and($dense)->toContain('fill="currentColor"')
->and($dense)->toContain(symbolGeometry('outlined-20/home'));
});
it('combines the filled state with the 20 cut', function () {
$outlined = (string) $this->blade('');
$filled = (string) $this->blade('');
expect($filled)->not->toBe($outlined)
->and($outlined)->toContain(symbolGeometry('outlined-20/favorite'))
->and($filled)->toContain(symbolGeometry('filled-20/favorite'))
->and($filled)->not->toContain(symbolGeometry('filled/favorite'));
});
it('falls back to the 24 cut for an optical size it does not ship', function () {
$standard = (string) $this->blade('');
expect((string) $this->blade(''))->toBe($standard)
->and((string) $this->blade(''))->toBe($standard)
->and((string) $this->blade(''))->toBe($standard);
});
it('refuses a name that is not a symbol', function () {
expect(fn () => $this->blade(''))
->toThrow(ViewException::class, 'There is no Material Symbol named [not_a_symbol_at_all].');
});
it('points a Heroicon name at the symbol catalogue', function () {
expect(fn () => $this->blade(''))
->toThrow(ViewException::class, 'is not a Material Symbol name');
});
it('ships every symbol outlined and filled in both cuts, painted in the text colour', function () {
$symbols = SvgFile::symbolNames();
expect(count($symbols))->toBeGreaterThan(4000);
foreach (['filled', 'outlined-20', 'filled-20'] as $folder) {
$names = array_map(fn (string $file): string => basename($file, '.svg'), glob(__DIR__."/../../../resources/svg/symbols/{$folder}/*.svg"));
expect($names)->toEqual($symbols, "{$folder} holds a different catalogue than outlined");
}
foreach (['outlined', 'filled', 'outlined-20', 'filled-20'] as $folder) {
foreach (['home', 'search', 'cloud_upload', 'content_copy', 'delete'] as $name) {
expect(file_get_contents(__DIR__."/../../../resources/svg/symbols/{$folder}/{$name}.svg"))
->toStartWith('