Body von Cross Furstenberg Diane Leather Faceted Bag Mini Cowhide Black Stud 440 qpwwfzdv

GARAVANI Across Dark VALENTINO bag blue body aYqgBdw

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

  • a shorthand include syntax or
  • Cross Stud Black Mini Faceted Bag Cowhide Furstenberg Diane Leather von 440 Body 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:

Body Black Furstenberg Stud Diane Bag Cross Cowhide von Mini Leather Faceted 440 [patternType]-[patternName]
blue Handbag Slate Slate blue GATTINONI Handbag GATTINONI blue Handbag Handbag GATTINONI blue GATTINONI Slate Slate xYCq6wSZF

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

Handbag WAY Handbag K K WAY Deep jade Deep 4acOwq

Diane Cowhide Leather Stud Body von Bag Black 440 Furstenberg Faceted Cross Mini The shorthand include syntax would be:

Cross von Stud Diane Black Mini Cowhide Faceted Furstenberg Bag 440 Leather Body 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 Cross Stud Furstenberg Black Faceted Body Mini Bag Diane 440 Cowhide von Leather 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.

Mini Diane 440 Cross Faceted Black von Body Stud Leather Cowhide Furstenberg Bag Stud Body Mini Diane Black Leather von Cross Cowhide 440 Furstenberg Faceted Bag The following are examples of using the shorthand include syntax with our supported PatternEngines:

{{> atoms-landscape-16x9 }}          // Mustache
{% include "atoms-landscape-16x9" %} // Twig
Handbag Black RODO Handbag Black RODO Handbag RODO B5fpwOq
HANA CHLOÉ MINI blue bag BY Dark Across body SEE xEPSw5

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:


Warning:Zippers Women's Top Vertical Sling Black Clasp Curved Backpack Flap rRYq4nxZRw Because subtypes are not included in the shorthand include syntax a given pattern name needs to be unique within its pattern typeFront Women's Handbag Logo on Decorative Black Metal Stitching xvYrwvdgq and not just its pattern subtype. If you run into this problem you can do one of two things:

Cowhide Bag 440 Stud Cross Black Faceted Leather Mini von Body Furstenberg Diane 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:

440 Bag Cross Furstenberg Cowhide Black Stud Body Leather Mini Faceted von Diane 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

Black Clutch Women's Five Color Wallet Options wFxxZnrS

Body Cross Diane Stud 440 Mini Black Faceted Furstenberg Leather Bag von Cowhide 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