@expand
Fetches a list of content instance by first extracting a set of node id values from properties of a node. Useful when using _relators in a parent node and you wish to load all the resulting associated nodes in a single Dust tag.
Parameters
| parameter | required | description |
|---|---|---|
| list | lost of nodes | |
| key | JSON "path" to the property containing the ID of the record to fetch | |
| type | the type of node to query for (definition QName) | |
| sort | the field to sort on | |
| sortDirection | the direction to sort in (either 1 for ascending or -1 for descending) | |
| limit | the number of records to return | |
| skip | a position to skip ahead to in the record set | |
| scope | if "page", then only relatives related to the current page will be returned | |
| as | specifies the name of the results variable (by default - rows) |
|
| field | the name of a property to match against) | |
| fieldRegex | the match to run against the field) | |
| fieldValue | the fixed value to check against the field) | |
| near | geolocation coordinates to query around | |
| locale | the locale to use in retrieving content |
Response
The response is a JSON object representing the node. The exact properties contained here will be dependent on the properties of your content.
Examples
Example #1: Retrieve by Node ID
{@query type="test:homePagePromo" as="promos"}
{@expand list="promos" key="promo.image.id" as="expandedPromos"}
{#expandedPromos}
<div class="col-5">
<h3>{title}</h3>
</div>
{/expandedPromos}
{/expand}
{/query}