Bummer! This is just a preview. You need to be signed in with a Basic account to view the entire video.

Preview

Start a free Basic 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.

  • 0:00

    Let's add a second macro for a text area.

  • 0:07

    Back in our form, we're going to

  • 0:13

    add another macro named textarea.

  • 0:18

    End macro.

  • 0:21

    Once again, I've included the HTML for the textarea group.

  • 0:26

    You can check the notes.

  • 0:31

    We're going to need a name and a value again,

  • 0:34

    so let's start with those, name and value.

  • 0:38

    Both for and id are going

  • 0:43

    to use input name, and input name.

  • 0:51

    For the label we'll use name with a filter of title.

  • 0:55

    And then for the name field we'll use just name.

  • 1:04

    Our placeholder, we'll use name, but

  • 1:07

    before that we'll say, Enter your, then we can add our value.

  • 1:12

    This will go between the opening and closing text area tags.

  • 1:18

    Value, and escape for good measure.

  • 1:22

    The only other variable we need for this is rows.

  • 1:28

    We'll add rows here.

  • 1:33

    We then add rows as an argument.

  • 1:36

    Rows and we set the default = 5.

  • 1:41

    The difference between setting the default value here and

  • 1:45

    setting the default value in the body of the macro is that if I pass an empty or

  • 1:51

    null value, it will not use the default.

  • 1:54

    It will use that empty or null value.

  • 1:57

    Now let's go to the contact template and call our macro.

  • 2:04

    We've already imported our forms file.

  • 2:06

    This time, instead of input, we say forms.textarea.

  • 2:14

    But we still wanna pass a name, message, and a value.

  • 2:20

    post.message.

  • 2:23

    We can either pass, or not pass the rows.

  • 2:26

    Let's go back to the browser, and check out our form again.

  • 2:33

    We have our three fields.

  • 2:36

    And then keep any value we entered.

  • 2:41

    Twig is about display, so I'm not going to actually make this form do anything,

  • 2:46

    but if you want help with that, check the notes associated with this video.

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

Sign up