You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Copy file name to clipboardExpand all lines: docs/usage/styles/numbering.md
+32-4Lines changed: 32 additions & 4 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -29,17 +29,45 @@ See [`Sample_14_ListItem`](/samples/Sample_14_ListItem.php) for more code sample
29
29
-`align`. Same as alignment.
30
30
-`alignment`. Supports all alignment modes since 1st Edition of ECMA-376 standard up till ISO/IEC 29500:2012.
31
31
* See [`SimpleType > Jc`](../simpletypes/jc.md) for possible values.
32
-
-`font`. Font name, e.g. `Arial`.
32
+
-`font`. Font name, e.g. `Arial`. Applies only to the numbering level text, e.g. 1., IV), or a bullet.
33
33
-`format`. Numbering format.
34
34
* See [`SimpleType > NumberFormat`](../simpletypes/numberformat.md).
35
-
-`hanging`. Hanging in `twip`.
35
+
-`hanging`. Indentation removed from the first line in `twip`.
36
36
-`hint`. Font content type, `default`, `eastAsia`, or `cs`.
37
-
-`left`. Left in `twip`.
37
+
-`left`. Left indentation in `twip`.
38
38
-`restart`. Restart numbering level symbol.
39
39
-`start`. Starting value. `1` is default.
40
+
* Always use integers for the starting value. If the `format` is `NumberFormat::UPPER_LETTER` and you want to start at `E`, then set `start` to 5.
40
41
-`suffix`. Content between numbering symbol and paragraph text, `tab`, `space`, or `nothing`. `tab` is default.
41
42
-`tabPos`. Tab position in `twip`.
42
-
-`text`. Numbering level text e.g. %1 for nonbullet or bullet character.
43
+
-`text`. Numbering level text, where `%#` will be replaced with the symbol for a particular level.
44
+
* If the `format` is `NumberFormat::DECIMAL`, `%1` will return the first-level number (1, 2, 3, 4), `%2` will return the second-level number, and so on.
45
+
* If the `format` is `NumberFormat::DECIMAL`, `%1.%2.` will return both the first-level and second level number with periods, 1.1., 1.2., 1.3., 1.4.
46
+
* If the `format` is `NumberFormat::UPPER_ROMAN`, `((%1))` will return the first-level upper roman character, ((I)), ((II)), ((III)), ((IV)).
47
+
* If the `format` is `NumberFormat::UPPER_ROMAN` for the first level and `NumberFormat::DECIMAL` for the second level, `%1.%2` will return IV.1, IV.2, IV.3 for second level items after IV.
48
+
* If the `format` is `NumberFormat::BULLET`, `#` will return #, `•` will return •, and `o` will return o.
49
+
* Regardless of `format`, `Item.` will return Item.
50
+
51
+
## Bullets
52
+
For easy copying, here are some common bullet symbols using a standard unicode font.
0 commit comments