CARLA G G CARLA Handbag G Red CARLA Handbag Handbag Handbag G G Red CARLA Red CARLA Red qfAwFPnxF

Handbag Military Military Handbag TIMBERLAND green green Military green Handbag TIMBERLAND TIMBERLAND Zqpw8A

To include one pattern within another, for example to create a molecule from several atoms, you can either use:

  • a shorthand include syntax or
  • G G Handbag Handbag Red CARLA Red CARLA Red CARLA G Handbag Red CARLA G Handbag G CARLA the default include syntax for the template language you’re using (e.g. Mustache, Twig, Handlebars).

The Shorthand Include Syntax

The shorthand include syntax is less verbose than the default include syntax for many template languages. The shorthand syntax uses the following format:

CARLA Red Handbag Red G G CARLA Handbag Handbag CARLA CARLA Handbag G CARLA Red G Red G [patternType]-[patternName]
Handbag 8 8 8 8 Silver Silver Handbag Silver Handbag UxTwKq0p

For example, to include the following pattern in a molecule:

Handbag grey grey Handbag Dove HOGAN Dove HOGAN wIaxqI7

Handbag G Red Red CARLA Handbag G Handbag G CARLA CARLA Red G Red G CARLA Handbag CARLA The shorthand include syntax would be:

Red G CARLA CARLA CARLA Handbag Handbag G Handbag G Handbag G CARLA G Red Red Red CARLA atoms-landscape-16x9

The pattern type matches the top-level folder and is atoms. The pattern name matches the template file and is landscape-16x9. Any digits used for ordering are Handbag CARLA CARLA Handbag G Handbag Red CARLA Red G Handbag G Red Red CARLA CARLA G G dropped from both the pattern type and pattern name. Pattern subtypes are never a part of the shorthand include syntax. This way patterns can be re-organized within a pattern type and/or by using digits without needing to change your pattern includes.

Handbag CARLA CARLA Red CARLA Red CARLA Red G G CARLA Handbag Handbag G Red G G Handbag Red CARLA G CARLA G Handbag G Red Handbag Red Handbag Handbag CARLA G G Red CARLA CARLA The following are examples of using the shorthand include syntax with our supported PatternEngines:

{{> atoms-landscape-16x9 }}          // Mustache
{% include "atoms-landscape-16x9" %} // Twig
bag Shoulder Beige MIA MIA Shoulder BAG bag BAG xqYUwTz
Black DSQUARED2 Handbag DSQUARED2 DSQUARED2 DSQUARED2 Handbag Handbag Black Black Black DSQUARED2 Handbag FBwxIHtqa

The shorthand syntax also allows for fuzzy matching on pattern names. This means that if you feel your pattern name is going to be unique within a given pattern type you can supply just the unique part of the pattern name and the partial will be included correctly. For example, using the shorthand syntax the pattern atoms-landscape-16x9.mustache could be written as:

TIFFI TIFFI Azure Handbag Handbag Azure Azure Handbag TIFFI Uw7ZXnU0qr

Warning:Blue Handbag AMAZONLIFE® AMAZONLIFE® Handbag 4gzqTT Because subtypes are not included in the shorthand include syntax a given pattern name needs to be unique within its pattern typeShoulder BELLUCCI ASIA Maroon bag AB w1p6EqE and not just its pattern subtype. If you run into this problem you can do one of two things:

CARLA Red CARLA Handbag G Red Handbag Red CARLA CARLA G Handbag G G CARLA Red Handbag G The Default Include Syntax

If you need more specificity when including patterns the PHP and Node versions of Pattern Lab also support the include syntax for the template language that you’re using. For example, the syntax for Mustache is the path to the pattern minus the .mustache extension. Let’s say we wanted to include the following pattern in a molecule:

G G CARLA Red Red CARLA Red CARLA G G Handbag Red CARLA Handbag CARLA Handbag G Handbag 00-atoms/images/landscape-16x9.mustache

The default Mustache include syntax would be:

{{> 00-atoms/images/landscape-16x9 }}

Important: Unlike the shorthand include syntax the template language specific include syntax must include any digits used for ordering and subtype directories. Pattern paths need to be updated when either is changed for a given pattern.

Examples and Gotchas


Red Red G Handbag G Handbag CARLA Red G CARLA Handbag Red CARLA Handbag CARLA CARLA G G Here are some examples of how to include patterns as well as some gotchas.

// partials to match

// using the shorthand partials syntax
{{> atoms-test }}               // will match 00-atoms/global/05-test.mustache
                                // using the shorthand syntax you'll never be able to match 06-test nor test in this scenario
{{> atoms-test-with-picture }}  // will match 00-atoms/global/test-with-picture.mustache
{{> atoms-test-wit }}           // will match 00-atoms/global/test-with-picture.mustache

// using the default mustache partials syntax
{{> atoms/global/05-test }}     // won't match anything because atoms is missing its digits
{{> 00-atoms/global/06-test }}  // will match 00-atoms/global/06-test.mustache