# list(type:width:) Returns a format style to format a list of strings. ``` static func list(type: ListFormatStyle.ListType, width: ListFormatStyle.Width = .standard) -> Self where Self == ListFormatStyle, Base : Sequence, Base.Element == String ``` ## Parameters `type` The list type to apply, such as cumulative ([`ListFormatStyle.ListType.and`](/documentation/Foundation/ListFormatStyle/ListType-swift.enum/and)) or alternative ([`ListFormatStyle.ListType.or`](/documentation/Foundation/ListFormatStyle/ListType-swift.enum/or)) elements. `width` The width to use when formatting, such as [`ListFormatStyle.Width.standard`](/documentation/Foundation/ListFormatStyle/Width-swift.enum/standard) or [`ListFormatStyle.Width.narrow`](/documentation/Foundation/ListFormatStyle/Width-swift.enum/narrow). ## Return Value A list format style that formats a string array as a textual list of items. ## Discussion Use the dot-notation form of this type method when the call point allows the use of [`ListFormatStyle`](/documentation/Foundation/ListFormatStyle), and the element type is . You typically do this when calling the method of . The following example creates an array of strings, then uses and the list format style provided by this method to format the items. It modifies the list format style to use the `en_US` locale, so the resulting string uses US English conventions for commas and conjunctions (“and”). ```swift let items = ["Atlantic", "Pacific", "Indian", "Arctic", "Southern"] let formatted = items.formatted( .list(type:.and) .locale(Locale(identifier: "en_US"))) // "Atlantic, Pacific, Indian, Arctic, and Southern" ``` --- Copyright © 2026 Apple Inc. All rights reserved. | [Terms of Use](https://www.apple.com/legal/internet-services/terms/site.html) | [Privacy Policy](https://www.apple.com/privacy/privacy-policy)