DXC Logo
Halstack Design System
v16.1.0

Bulleted List

Bulleted list are used to display text items in a bulleted format.

Introduction

Bulleted lists are used to present grouped information in a clear, scannable format. They help users quickly identify key points or related items without following a specific order. In Halstack, the bulleted list component supports customizable icon variants, and nesting levels to adapt to different content needs while maintaining consistency and readability across the interface. Use this component to enhance clarity and break down complex information into digestible chunks.

Anatomy

Bulleted list anatomy
  1. 1.
    Bullet point: a small visual marker placed before each list item. It provides visual separation and helps emphasize each individual entry within the list. The default style is a filled circle.
  2. 2.
    Label: the text content associated with each bullet point. It conveys the actual information and should be clear, concise, and scannable for easy reading.

Types

Disc

Disc are the default type, represented by a filled circle. It is commonly used for the most standard lists where content doesn't require special emphasis or categorization.

Circle

Showcased like an empty circle marker, they offer a lighter visual alternative. It is frequently used for secondary or nested lists, or when a subtler design is preferred.

Square

Square types consist of a solid square marker that draws slightly more attention. This type is mostly used for lists that need more visual weight, or for lists that need to be differentiated from standard content blocks.

Number

This type of bulleted list display items in a numbered sequence. They are used for lists that contain ordered steps, instructions, or any content where sequence or priority is important.

Icon

In this type of bulleted list, the visual marker is an icon instead of a standard one. They are commonly used for lists that benefit from visual cues to reinforce meaning, such as warning icons, checkmarks or status indicators.

Best practices

  • Choose the appropriate bullet type for the context: use discs for standard lists, numbers for sequences or steps, and icons when a visual cue adds clarity or emphasis.
  • Keep list items concise and scannable: lists should be easy to read at a glance. Use brief, clear phrasing.
  • Maintain parallel structure: ensure that all list items follow a consistent grammatical pattern to improve readability.
  • Avoid overusing nested lists: deeply nested lists can be hard to follow. Limit nesting to one level if possible.
  • Use punctuation consistently: if one item ends in a period, all items should, unless they're just short phrases or single words.
  • Use spacing to improve legibility: ensure there is enough vertical space between items, especially in longer lists.