umarks > container > order
| Required/Optional | Optional |
|---|---|
| Format | Positive integer |
| Restrictions | N/A |
| Parent Element | <container> |
| Child Elements | None |
| Default Value | 1,000,000 |
| Number Allowed | 1 |
Description
The optional <order> tag indicates the position of the item within its container. This ensures the user’s running order is maintained.
If it is absent a value of 1,000,000 is assumed i.e. it will be placed at the end.
NB: This value is compared with any other item that shares the same parent i.e. other containers, separators and links.
Location
Nested inside the <container> element.
<container>
<title>UK News</title>
<updated>2010-01-10T23:59:59</updated>
<parent>/News Sites/</parent>
<order>1</order>
</container>
Recommendations
| Reading from UMarks file | Elements with the same parent should be sorted thus: order THEN updated. If the tag is missing or empty a value of 1,000,000 should be assumed. |
|---|---|
| Writing to UMarks file | If the value is missing the entire tag should be removed, therefore this is not necessary: <order>1000000</order>. Similarly, <order></order> is illegal. If the item is moved i.e. the order changes, then reorder all items in the same container (everything with the same parent), starting from 1. |
See also
- umarks > container
- umarks > container > title
- umarks > container > updated
- umarks > container > parent
- Download sample files
- Overview of UMarks Tags
Feedback and criticism
We welcome feedback and criticism on any any aspect of UMarks, especially the tags, elements and general format of UMarks itself. So please don't hesitate to get in touch if you have anything to add. We read everything we get, and we never spam or retain your details in any way.
