Ordered and unordered lists

The list feature lets you create ordered (numbered) and unordered (bulleted) lists. The unique thing about them is that you can put any content inside each list item (including block elements like paragraphs and tables), retaining the continuity of numbering and indentation.

Use the editor below to see the list feature in action. You can use toolbar buttons to insert both ordered and unordered lists .

You can also use Markdown code recognized by the autoformatting feature:

• Start a line with * or - followed by a space for a bulleted list.
• Start a line with 1. or 1) followed by a space for a numbered list.

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 more styles for list markers, 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 full-featured editor example.

The list style feature introduces some more styles for the list item markers. When enabled, it adds 3 styles for unordered lists and 6 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.

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.

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

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

ClassicEditor
	.create( document.querySelector( '#editor' ), {
		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( document.querySelector( '#editor' ), {
		licenseKey: '<YOUR_LICENSE_KEY>',
		plugins: [ List, Bold, /* ... */ ],
		toolbar: [ 'bulletedList', 'numberedList', 'bold', /* ... */ ]
		list: {
			enableListItemMarkerFormatting: false
		}
	} )
	.then( /* ... */ )
	.catch( /* ... */ );

The List plugin provides the ordered (numbered) and unordered (bulleted) features for CKEditor 5. Additional list properties, such as list marker styles, start index, or reversed list order, are provided by the ListProperties plugin.

After installing the editor, add the feature to your plugin list and toolbar configuration:

import { ClassicEditor, List } from 'ckeditor5';

ClassicEditor
	.create( document.querySelector( '#editor' ), {
		licenseKey: '<YOUR_LICENSE_KEY>', // Or 'GPL'.
		plugins: [ List, /* ... */ ],
		toolbar: [ 'bulletedList', 'numberedList', /* ... */ ]
		list: {
			// Configuration.
		}
	} )
	.then( /* ... */ )
	.catch( /* ... */ );

const { ClassicEditor, List } = CKEDITOR;

ClassicEditor
	.create( document.querySelector( '#editor' ), {
		licenseKey: '<YOUR_LICENSE_KEY>',
		plugins: [ List, /* ... */ ],
		toolbar: [ 'bulletedList', 'numberedList', /* ... */ ]
		list: {
			// Configuration.
		}
	} )
	.then( /* ... */ )
	.catch( /* ... */ );

After installing the editor, add ListProperties to your plugin list and toolbar configuration:

To enable selected sub-features of the list properties, add their configuration to your editor. Set true for each feature you want to enable:

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

ClassicEditor
	.create( document.querySelector( '#editor' ), {
		plugins: [ List, ListProperties, /* ... */ ],
		toolbar: [ 'bulletedList', 'numberedList', /* ... */ ],
		list: {
			properties: {
				styles: true,
				startIndex: true,
				reversed: true
			}
		}
	} )
	.then( /* ... */ )
	.catch( /* ... */ );

const { ClassicEditor, List, ListProperties } = CKEDITOR;

ClassicEditor
	.create( document.querySelector( '#editor' ), {
		plugins: [ List, ListProperties, /* ... */ ],
		toolbar: [ 'bulletedList', 'numberedList', /* ... */ ],
		list: {
			properties: {
				styles: true,
				startIndex: true,
				reversed: true
			}
		}
	} )
	.then( /* ... */ )
	.catch( /* ... */ );

Starting with version 45.1.1, list items (<li> elements) in the editor data output contain an additional attribute data-list-item-id. The attribute is necessary to ensure that the lists feature work correctly with other editor features and mechanisms.

<ul>
    <li data-list-item-id="e72808ee4144975064acb5d66e5cfba13">Hello</li>
    <li data-list-item-id="e5d719ab356409767e9d4358485476358">There!</li>
</ul>

If data loaded in the editor does not contain the data-list-item-id attributes on list items, they will be automatically added when data is saved.

If you wish to save the editor contents without this attribute, you can set the skipListItemIds flag to true when calling editor.getData() method. However, please note, that data without IDs should be used only for presentation purposes (such as displaying the document as HTML), and should not be used to initialize the editor.

editor.getData( { skipListItemIds: true } );

Such output will not contain data-list-item-id attribute:

<ul>
    <li>Hello</li>
    <li>There!</li>
</ul>

These CKEditor 5 features provide similar functionality:

• To-do lists – Create a list of interactive checkboxes with labels.
• Multi-level lists – Multi-level lists allow the user to set different markers (symbols, text or numbers) to display at each level of the list.
• Block indentation – Set indentation for text blocks such as paragraphs or headings and lists.
• Autoformatting – Format the text on the go with Markdown code.

The List plugin registers:

• The 'numberedList' command.
• The 'bulletedList' command.
• The 'indentList' command.
• The 'outdentList' command.
• The 'numberedList' UI button.
• The 'bulletedList' UI button.

The ListProperties plugin registers:

• The listStyle command. It accepts the type of the list style to set. If not set, it uses the default marker (usually decimal).

  editor.execute( 'listStyle', { type: 'lower-roman' } );
  

  Copy code

  The available types are:

  • For bulleted lists: 'disc', 'circle', and 'square'.
  • For numbered lists: 'decimal', 'decimal-leading-zero', 'lower-roman', 'upper-roman', 'lower-latin', and 'upper-latin'.

• The listStart command. It is a number and defaults to 1 (meaning a list starts with 1). If enabled, it accepts a numerical value for the start attribute.

  editor.execute( 'listStart', { startIndex: 3 } );
  

  Copy code

• The listReversed command. It is a Boolean and defaults to false (meaning the list order is ascending).

  editor.execute( 'listReversed', { reversed: true } );
  

  Copy code

• The numberedList UI split button. It overrides the UI button registered by the List plugin.

• The bulletedList UI split button. It overrides the UI button registered by the List plugin.

The source code of the feature is available on GitHub at https://github.com/ckeditor/ckeditor5/tree/master/packages/ckeditor5-list.