Incomplete¶
The incomplete
tag use for determine empty cell template when rendering result in some command like View Command that generate rows with data present as cells like view-card template.
Note
Renderable Commands at last can contains only one incomplete
tag.
1 2 3 | <incomplete>
[template]
</incomplete>
|
Important
The incomplete
tag has no attribute or child tags.
template html
¶
Determine template that rendering process use it as place holder in empty cell in generate output result.
In incomplete
tag, child element represents template
.
Tip
incomplete
tag use mostly with divider-tag
.
For more information see Divider.
Remarks¶
The incomplete
tag used with Divider for present empty cell in grid base result.
Suppose we have db.numbers
data source like this:
id |
Name |
---|---|
1 |
A |
2 |
B |
3 |
C |
4 |
D |
5 |
E |
6 |
F |
7 |
G |
8 |
H |
9 |
I |
And a Print Command command like this:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 | <basis core="print" datamembername="db.numbers">
<layout>
<table>
<tr>@child</tr>
</table>
</layout>
<face replace="true">
<td>@id</td>
</face>
<divider rowcount="4">
</tr><tr>
</divider>
</basis>
|
Generated result is:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 | <table>
<tr>
<td>1</td>
<td>2</td>
<td>3</td>
<td>4</td>
</tr>
<tr>
<td>5</td>
<td>6</td>
<td>7</td>
<td>8</td>
</tr>
<tr>
<td>9</td>
</tr>
</table>
|
As you see generate result is not well-formatted
, because in last tr
tag only one td
tag presented but must be four.
For fix this problem,we must use incomplete
tag like this:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | <basis core="print" datamembername="db.numbers">
<layout>
<table>
<tr>@child</tr>
</table>
</layout>
<face replace="true">
<td>@id</td>
</face>
<divider rowcount="4">
</tr><tr>
</divider>
<incomplete>
<td>*<td>
</incomplete>
</basis>
|
In incomplete
tag template
, contain td
tag that repeat and add to rendering result for cover not-exist data item.
So rendering result be well-formatted:
1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 | <table>
<tr>
<td>1</td>
<td>2</td>
<td>3</td>
<td>4</td>
</tr>
<tr>
<td>5</td>
<td>6</td>
<td>7</td>
<td>8</td>
</tr>
<tr>
<td>9</td>
<td>*<td>
<td>*<td>
<td>*<td>
</tr>
</table>
|