A section of text that forms a single list.
- macOS 10.4+
The visible elements of the list, including list markers, appear in the text as they do for lists created by hand. The list object, however, allows the list to be recognized as such by the text system. This enables automatic creation of markers and spacing. Text lists are used in HTML import and export.
Text lists appear as attributes on paragraphs, as part of the paragraph style. An
NSParagraph may have an array of text lists, representing the nested lists containing the paragraph, in order from outermost to innermost. For example, if list1 contains four paragraphs, the middle two of which are also in the inner list2, then the text lists array for the first and fourth paragraphs is (list1), while the text lists array for the second and third paragraphs is (list1, list2).
NSAttributed has convenience methods for lists, such as
range(of:, which determines the range covered by a list, and
item, which determines the ordinal position within a list of a particular item.