-
Notifications
You must be signed in to change notification settings - Fork 215
WIP composition
The way to create and compose the ui for your application using montage is primarily by expressing this in the markup of your templates.
...
<script type="text/montage-serialization">{
"repetition": {
"prototype": "montage/ui/repetition.reel",
"properties": {
"element": {"#": "repetition"},
"content": [1,2,3]
}
}
"text": {
"prototype": "montage/ui/dynamic-text.reel",
"properties": {
"element": {"#": "text"},
"value": "hello"
}
}
}</script>
...
<body>
<ul data-montage-id="repetition">
<li data-montage-id="text"></li>
</ul>
</body>
...Via the markup we are passing a parameter to the Repetition (the li element) and this will tell the repetition to repeat the li and its associated DynamicText as many times as there are values in the content array. In this case three times.
...
<script type="text/montage-serialization">{
"condition": {
"prototype": "montage/ui/condition.reel",
"properties": {
"element": {"#": "condition"},
"condition": false
}
}
"text": {
"prototype": "montage/ui/dynamic-text.reel",
"properties": {
"element": {"#": "text"},
"value": "This is the truth"
}
}
}</script>
...
<body>
<div data-montage-id="condition">
<span data-montage-id="text"></span>
</div>
</body>
...The span is a parameter to the Condition that tells it to show that element when the condition property is true. In this casse the condition will make sure the span is not visible on the screen.
Given the desired usage for CustomComponent.
...
<script type="text/montage-serialization">{
"customComponent": {
"prototype": "my/custom-component.reel",
"properties": {
"element": {"#": "customComponent"}
}
}
"text": {
"prototype": "montage/ui/dynamic-text.reel",
"properties": {
"element": {"#": "text"},
"value": "I'm included."
}
}
}</script>
...
<body>
<div data-montage-id="customComponent">
<span data-montage-id="text"></span> <- innerTemplate
</div>
</body>
...The CustomComponent can make use of a template argument to include all the contents of it's innerTemplate. A template argument is an element that has the attribute data-arg. This marks the element as a placeholder that will replaced by the innerTemplate.
my/custom-component.reel/custom-component.html
...
<script type="text/montage-serialization">{
"owner": {
"prototype": "my/custom-component.reel"
}
}</script>
...
<body>
<div class="my-CustomComponent--prettyFrame">
<span data-arg="*"></span>
</div>
</body>
...The Substitution component allows you to branch the component tree based on a key in your data
...
<script type="text/montage-serialization">{
"customerNameSubstitution": {
"prototype": "montage/ui/substitution.reel"
"properties": {
"element": {"#": "customerNameSubstitution"},
"switchComponents": {
"read" : "montage/ui/dynamic-text.reel"
"edit" : "montage/ui/input-text.reel"
}
"switchValue": "read"
},
"bindings": {
"value": {
"<-": "@customer.name"
}
}
}
}</script>
...
<body>
Customer name: <div data-montage-id="customerNameSubstitution"></div>
</body>
...The Exposition component allows you to specify components that might or might not be related but need to occupy the same space in the dom.
...
<script type="text/montage-serialization">{
"preferences": {
"prototype": "montage/ui/exposition.reel"
"properties": {
"element": {"#": "preferences"}
},
"bindings": {
"value": {
"<-": "@customer.name"
}
}
},
"displayPanel": {...},
"networkPanel": {...},
"usersPanel": {...}
}</script>
...
<body>
<div data-montage-id="preferences">
<div data-param="display" data-montage-id="displayPanel"></div>
<div data-param="network" data-montage-id="networkPanel"></div>
<div data-param="users" data-montage-id="usersPanel"></div>
</div>
</body>
...