list/utils
@ckeditor/ckeditor5-list/src/utils
Filtering
Functions
-
createUIComponent( editor, commandName, label, icon )
private static
Helper method for creating a UI button and linking it with an appropriate command.
Parameters
editor : Editor
The editor instance to which the UI component will be added.
commandName : String
The name of the command.
label : Object
The button label.
icon : String
The source of the icon.
-
createViewListItemElement( writer ) → ContainerElement
static
Creates a list item
ContainerElement
. -
generateLiInUl( modelItem, conversionApi ) → ContainerElement
static
Helper function that creates a
<ul><li></li></ul>
or (<ol>
) structure out of the givenmodelItem
modellistItem
element. Then, it binds the created view list item ( - ) with the model
listItem
element. The function then returns the created view list item ( - ).
Parameters
modelItem : Item
Model list item.
conversionApi : UpcastConversionApi
Conversion interface.
Returns
ContainerElement
View list element.
getSiblingListItem( modelItem, options = { [options.sameIndent], [options.smallerIndent], [options.listIndent] } ) → Item | null
static
Helper function that searches for a previous list item sibling of a given model item that meets the given criteria passed by the options object.
Parameters
modelItem : Item
options : Object
Search criteria.
Properties[ options.sameIndent ] : Boolean
Whether the sought sibling should have the same indentation.
Defaults to
false
[ options.smallerIndent ] : Boolean
Whether the sought sibling should have a smaller indentation.
Defaults to
false
[ options.listIndent ] : Number
The reference indentation.
Returns
Item | null
injectViewList( modelItem, injectedItem, conversionApi, model )
static
Helper function that inserts a view list at a correct place and merges it with its siblings.
It takes a model list item element (modelItem
) and a corresponding view list item element (injectedItem
). The view list item
should be in a view list element (<ul>
or <ol>
) and should be its only child.
See comments below to better understand the algorithm.
Parameters
modelItem : Item
Model list item.
injectedItem : ContainerElement
conversionApi : UpcastConversionApi
Conversion interface.
model : Model
The model instance.
mergeViewLists( viewWriter, firstList, secondList ) → Position | null
static
Helper function that takes two parameters that are expected to be view list elements, and merges them. The merge happens only if both parameters are list elements of the same type (the same element name and the same class attributes).
Parameters
viewWriter : DowncastWriter
The writer instance.
firstList : Item
The first element to compare.
secondList : Item
The second element to compare.
Returns
Position | null
The position after merge or
null
when there was no merge.
positionAfterUiElements( viewPosition ) → Position
static
Helper function that for a given view.Position
, returns a view.Position
that is after all view.UIElement
s that
are after the given position.