List properties

Besides the basic functionality of creating ordered and unordered lists, CKEditor 5 offers formatting tools that let you control the lists. You can enable features such as customizing list markers with additional styles, setting the start index, or reversing the list order separately or all at once. Check out the individual demos below or see all list properties working together in the feature-rich editor example.

The list style feature introduces more styles for the list item markers. When enabled, it adds three styles for unordered lists and six styles for ordered lists to choose from. The user will be able to set or change the list style via the dropdown. It opens when you click the arrow next to the appropriate list button in the toolbar.

The following unordered list styles are available:

• disk (•)
• circle (◦)
• square (▪)

The following ordered list styles are available:

• decimal (1.)
• decimal-leading-zero (01.)
• lower-roman (i.)
• upper-roman (I.)
• lower-latin (a.)
• upper-latin (A.)

Additional numbering style that needs configuration:

• arabic-indic numbers (١.)

In the editor below, use the ordered or unordered list dropdown to choose the desired marker type for each list.

The list start index feature allows the user to choose the starting point of an ordered list. By default, this would be 1 (or A, or I – see the list styles section). Sometimes you may want to start a list with some other digit or letter, though.

When this feature is enabled, an extra dropdown option is available in the ordered list toolbar button. Thanks to it, the user may set or change the starting marker.

In the editor below, notice how the ordering continues in the second list. To achieve continuous numbering of all spaceships from the example, go to the first item of the last list. Then use the ordered list dropdown input field to set the start index.

The reversed list feature lets the user reverse the numbering order of a list, changing it from ascending to descending. This is useful in countdowns and things-to-do lists that need to reproduce steps in a reversed order (for example, in disassembly instructions).

When this feature is enabled, an extra dropdown switch is available in the ordered list toolbar button. Thanks to it, the user may reverse the order of a list with a single click.

Click the second list and use the ordered list dropdown switch to choose whether to reverse the numbering order.

Replacing the screen of your Nintendo Game Boy

Disassembling the console

1. Remove the game cartridge from the slot. Open the battery compartment and remove the batteries.
2. Remove the six triwing (Y-type screwdriver needed) screws located at the top and middle of the back case and inside the battery compartment.
3. Separate the front and back case halves. Be extra careful not to pull the cable ribbon that connects both parts. Detach the ribbon carefully.
4. Remove the ten Philips screws holding the mainboard to the front case. Carefully take the mainboard out of the case.
5. Detach three plastic clips on the backside of the board and remove two Philips screws on the front, below the screen.
6. Desolder the display connectors from the mainboard.

Reassembling the console

1. Solder the display connector to the mainboard.
2. Fasten the two screws below the screen and reattach three plastic clips on the backside of the mainboard
3. Put the mainboard carefully inside the front case and screw in ten Philips screws holding the mainboard.
4. Reattach the main cable ribbon to the back casing and put the case halves together.
5. Fasten the six triwing screws inside the battery compartment and on the back of the case.
6. Reload three AA-size batteries, close the compartment cover, and insert your favorite game cartridge to play!

The list item marker formatting feature automatically applies text formatting to list item markers when the entire content of the list item shares the same formatting. It integrates with the font feature and basic styles feature, supporting the following formatting options:

• Bold and italic (from basic styles),
• Font color, font size, and font family (from font).

When this feature is enabled, if the whole list item content is consistently styled using any of the supported formats, the bullet or number marker will reflect the same style automatically. For example, if a list item is entirely bold, its marker will appear bold as well.

Select the entire content of a list item and apply a format like bold, italic, or a font style. If the whole item is formatted, the list marker will automatically update to match.

For every supported format, the feature adds a class to the <li> element. When the format carries a value, it also sets a CSS variable on the same element:

The content styles use these classes and variables to style the ::marker pseudo-element of the list item. Font size is an exception: the variable holds numerical sizes, while the default named presets use dedicated classes, as described in the note below.

The feature sets the variables on the <li> element itself, so redefining them in :root does not affect formatted items. To take control of a marker style, declare the property for the marker directly. The CSS below keeps one font family for all markers, while bold, italic, font color, and font size still follow the content of the item:

.ck-content ol > li.ck-list-marker-font-family::marker,
.ck-content ul > li.ck-list-marker-font-family::marker {
    font-family: var(--ck-content-font-family);
}

The browser draws the marker outside the content of the list item, ending right before that content. A marker in a monospace font family or in a bigger font size is wider, and the extra width extends to the left. As a result, the markers of a list with mixed formatting no longer start at the same position, while the content of the items stays aligned. Padding on the list does not change this, because it moves the markers together with the content.

The width of a marker comes from the font itself. Every font family has its own glyph metrics, because type designers give characters different widths, spacing, and proportions. The same marker text therefore takes a different amount of space in each font. Monospace fonts give every character the same width. In a numbered marker, the period then takes as much space as a digit, and most of that space stays empty. The gap before the content of the item looks bigger, but the content has not moved.

If your content requires all markers to start at the same position, use one of these options:

• Keep one font family and one font size for all markers, as shown in Styling the markers with CSS.
• Disable marker formatting, so that markers always use the content font.

Apply the same CSS wherever the content is presented outside the editor. For example in the published content styles, and in the style sheets passed to the export to PDF or export to Word features.

This feature is enabled by default. To disable it, use the following configuration:

import { ClassicEditor, List, Bold } from 'ckeditor5';

ClassicEditor
	.create( {
		licenseKey: '<YOUR_LICENSE_KEY>', // Or 'GPL'.
		plugins: [ List, Bold, /* ... */ ],
		toolbar: [ 'bulletedList', 'numberedList', 'bold', /* ... */ ]
		list: {
			enableListItemMarkerFormatting: false
		}
	} )
	.then( /* ... */ )
	.catch( /* ... */ );

const { ClassicEditor, List, Bold } = CKEDITOR;

ClassicEditor
	.create( {
		licenseKey: '<YOUR_LICENSE_KEY>',
		plugins: [ List, Bold, /* ... */ ],
		toolbar: [ 'bulletedList', 'numberedList', 'bold', /* ... */ ]
		list: {
			enableListItemMarkerFormatting: false
		}
	} )
	.then( /* ... */ )
	.catch( /* ... */ );