Heads up! To view this whole video, sign in with your Courses account or enroll in your free 7-day trial. Sign In Enroll

Preview

Start a free Courses trial
to watch this video

Sign up for Treehouse

Multiple Macros

2:51 with Alena Holligan

We'll look at writing and using multiple macros.

You may add as many Macros to a file as you want, but it's a good idea to group macros logically.

You can add a second form macro to our forms.twig file:

{% macro textarea(name, value, rows=5, help) %}
    <div class="form-group">
        <label for="input{{ name }}">{{ name|title }}</label>
        {% if help %}<small class="form-text text-muted">{{ help }}</small>{% endif %}
        <textarea class="form-control" id="input{{ name }}" name="{{ name }}" placeholder="Enter your {{ name }}" rows="{{ rows }}">{{ value }}</textarea>
    </div>
{% endmacro %}

You only need to import the file containing the macro once. Then you may access any macro from that file.

{{ forms.input('name', post.name) }}
{{ forms.textarea('message') }}

Alternatively, you can import individual macro names from a template into the current namespace via the from tag and optionally alias them:

{% from 'forms.twig' import forms as textarea %}
{{ textarea('message') }}

Twig allows you to put the name of the macro after the end tag for better readability:{% endmacro input %} Of course, the name after the endmacro word must match the macro name.

Let's add a second macro for a text area. 0:00
Back in our form, we're going to 0:07
add another macro named textarea. 0:13
End macro. 0:18
Once again, I've included the HTML for the textarea group. 0:21
You can check the notes. 0:26
We're going to need a name and a value again, 0:31
so let's start with those, name and value. 0:34
Both for and id are going 0:38
to use input name, and input name. 0:43
For the label we'll use name with a filter of title. 0:51
And then for the name field we'll use just name. 0:55
Our placeholder, we'll use name, but 1:04
before that we'll say, Enter your, then we can add our value. 1:07
This will go between the opening and closing text area tags. 1:12
Value, and escape for good measure. 1:18
The only other variable we need for this is rows. 1:22
We'll add rows here. 1:28
We then add rows as an argument. 1:33
Rows and we set the default = 5. 1:36
The difference between setting the default value here and 1:41
setting the default value in the body of the macro is that if I pass an empty or 1:45
null value, it will not use the default. 1:51
It will use that empty or null value. 1:54
Now let's go to the contact template and call our macro. 1:57
We've already imported our forms file. 2:04
This time, instead of input, we say forms.textarea. 2:06
But we still wanna pass a name, message, and a value. 2:14
post.message. 2:20
We can either pass, or not pass the rows. 2:23
Let's go back to the browser, and check out our form again. 2:26
We have our three fields. 2:33
And then keep any value we entered. 2:36
Twig is about display, so I'm not going to actually make this form do anything, 2:41
but if you want help with that, check the notes associated with this video. 2:46

You need to sign up for Treehouse in order to download course files.

Sign up