Added some upgrade notes about the new toolbar design
This commit is contained in:
parent
22f6bc5003
commit
9df0f8b4b8
@ -136,3 +136,64 @@ DependencyInjection
|
||||
<service id="foo" class="stdClass" shared="false" />
|
||||
</services>
|
||||
```
|
||||
|
||||
Web Development Toolbar
|
||||
-----------------------
|
||||
|
||||
The web development toolbar has been completely redesigned. This update has
|
||||
introduced some changes in the HTML markup of the toolbar items.
|
||||
|
||||
Before:
|
||||
|
||||
Information was wrapped with simple `<span>` elements:
|
||||
|
||||
```twig
|
||||
{% block toolbar %}
|
||||
{% set icon %}
|
||||
<span>
|
||||
<svg ...></svg>
|
||||
<span>{{ '%.1f'|format(collector.memory / 1024 / 1024) }} MB</span>
|
||||
</span>
|
||||
{% endset %}
|
||||
{% endblock %}
|
||||
```
|
||||
|
||||
After:
|
||||
|
||||
Information is now semantically divided into values and labels according to
|
||||
the `class` attribute of each `<span>` element:
|
||||
|
||||
```twig
|
||||
{% block toolbar %}
|
||||
{% set icon %}
|
||||
<svg ...></svg>
|
||||
<span class="sf-toolbar-value">
|
||||
{{ '%.1f'|format(collector.memory / 1024 / 1024) }}
|
||||
</span>
|
||||
<span class="sf-toolbar-label">MB</span>
|
||||
{% endset %}
|
||||
{% endblock %}
|
||||
```
|
||||
|
||||
Most of the blocks designed for the previous toolbar will still be displayed
|
||||
correctly. However, if you want to support both the old and the new toolbar,
|
||||
it's better to make use of the new `profiler_markup_version` variable passed
|
||||
to the toolbar templates:
|
||||
|
||||
```twig
|
||||
{% block toolbar %}
|
||||
{% set profiler_markup_version = profiler_markup_version|default(1) %}
|
||||
|
||||
{% set icon %}
|
||||
{% if profiler_markup_version == 1 %}
|
||||
|
||||
{# code for the original toolbar #}
|
||||
|
||||
{% else %}
|
||||
|
||||
{# code for the new toolbar (Symfony 2.8+) #}
|
||||
|
||||
{% endif %}
|
||||
{% endset %}
|
||||
{% endblock %}
|
||||
```
|
||||
|
Reference in New Issue
Block a user