cupertino_lists_enhanced 0.1.3

Enhanced cupertino lists. Provides a list of options in the style of the iOS settings app. Choose an item (or items) from a list of options.

Cupertino style options lists

• A list of options in the style of the iOS settings app. Choose an item (or items) from a list of options.
• Improves CupertinoListTile and CupertinoListSection widgets from the standard library to provide behaviour more closely resembling iOS.

Features

• Single-selection: Select a single item from a list of options.
• Multi-selection: Select multiple items from a list of options.
• Disable certain choices
• Place the check mark at the leading or trailing edge
• showCupertinoSingleSelectionPage provides a full screen dialog to select an option, similar to the iOS settings app
• Additional Customisation: Combine new-style curved lists with original-style headers and footers, like the iOS settings app
  • Use the headerType and footerType arguments of EnhancedCupertinoListSection, CupertinoMultiSelection and CupertinoSingleSelection
• EnhancedCupertinoListTile provides functionality that resembles the behaviour of iOS more closely

Why use EnhancedCupertinoListTile?

CupertinoListTile, provided by Flutter's standard widget library, is great, but its behaviour is different to iOS in certain ways. EnhancedCupertinoListTile aims to be an improved CupertinoListTile, providing additional features and resembling the behaviour of iOS more closely.

• In iOS, when the title or subtitle text is too long to fit on one line, it will wrap onto several lines. However, CupertinoListTile from Flutter's standard library will attempt to fit the text onto one line, and long text strings will be cut off, potentially leading to important information to be lost. EnhancedCupertinoListTile more closely resembles iOS behaviour by wrapping long text strings over several lines
• EnhancedCupertinoListTile resembles real iOS behaviour by giving titles and subtitles priority over the additionalInfo for the space. The additionalInfo text will use spare space left by the title and subtitles, and an ellipsis will be added if there isn't room to show it all. (Standard CupertinoListTiles give priority to the additionalInfo over the titles and subtitles - causing the title and subtitle to be cut off - and will throw an overflow error if the additionalInfo is too long).
• See the following section for examples of the differences

This section explains the real behaviour of iOS, the behaviour of CupertinoListTile from the standard library, and the behaviour of EnhancedCupertinoListTile from this library.

Text Wrapping

• Actual iOS behaviour:
  • Text is wrapped over several lines if there isn't enough space

• CupertinoListTile behaviour:
  • Text is not wrapped over several lines, and some text may be lost

• EnhancedCupertinoListTile behaviour:
  • Text is wrapped over several lines if there isn't enough space

Text priority

• Actual iOS behaviour:
  • title has the priority, additional info takes remaining space and an ellipsis is added if it overflows

• CupertinoListTile behaviour:
  • additionalInfo has the priority, title is cut off

• EnhancedCupertinoListTile behaviour:
  • title has the priority, additional info takes remaining space and an ellipsis is added if it overflows

Documentation

Documentation is available within the source code and here.

Feature requests and bugs

Please provide feature requests and bugs at the issue tracker.