Skip to content

Commit 9fb20fc

Browse files
authored
Update numbering.md
1 parent b7c97db commit 9fb20fc

File tree

1 file changed

+32
-4
lines changed

1 file changed

+32
-4
lines changed

docs/usage/styles/numbering.md

Lines changed: 32 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -29,17 +29,45 @@ See [`Sample_14_ListItem`](/samples/Sample_14_ListItem.php) for more code sample
2929
- `align`. Same as alignment.
3030
- `alignment`. Supports all alignment modes since 1st Edition of ECMA-376 standard up till ISO/IEC 29500:2012.
3131
* 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.
3333
- `format`. Numbering format.
3434
* See [`SimpleType > NumberFormat`](../simpletypes/numberformat.md).
35-
- `hanging`. Hanging in `twip`.
35+
- `hanging`. Indentation removed from the first line in `twip`.
3636
- `hint`. Font content type, `default`, `eastAsia`, or `cs`.
37-
- `left`. Left in `twip`.
37+
- `left`. Left indentation in `twip`.
3838
- `restart`. Restart numbering level symbol.
3939
- `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.
4041
- `suffix`. Content between numbering symbol and paragraph text, `tab`, `space`, or `nothing`. `tab` is default.
4142
- `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.
53+
- `` Bullet
54+
- `` Open bullet
55+
- `·` Middle dot
56+
- `o` Small letter o
57+
- `` Circle
58+
- `` Open circle
59+
- `` Dotted circle
60+
- `` Dagger
61+
- `` Double dagger
62+
- `#` Number sign
63+
- `§` Section sign
64+
- `` Single right arrow
65+
- `»` Double right arrow
66+
- `` Right arrow
67+
- `` Square
68+
- `` Open square
69+
- `` Small square
70+
- `` Small open square
4371

4472
## Used In
4573
- [`Styles > ListItem`](../styles/list.md).

0 commit comments

Comments
 (0)