Skip to content

Latest commit

 

History

History
92 lines (73 loc) · 2.78 KB

README.md

File metadata and controls

92 lines (73 loc) · 2.78 KB

ExpandableText

build swift-version ios-version xcode-version license

An expandable text view that displays a truncated version of its contents with a "more" button that expands the view to show the full contents.

iOS 13+ compatible, fully customizable, written in SwiftUI.

Installation

Available via the Swift Package Manager. Requires iOS 13+.

https://github.com/n3d1117/ExpandableText

Features

  • Customizable line limit
  • Customizable font, color, and more button appearance with SwiftUI-like modifiers
  • Automatically hide more button if the whole text fits within the view
  • Support right-to-left languages
  • Support re-collapsing text by tapping on expanded text body (by @JThramer)
  • Support custom expand animation
  • Automatically trim multiple new lines when truncated (can be disabled)

Usage

Basic usage

import ExpandableText

let loremIpsum = """
Lorem ipsum dolor sit amet, consectetur adipiscing 
elit, sed do eiusmod tempor incididunt ut labore et 
dolore magna aliqua. Ut enim ad minim veniam, quis 
nostrud exercitation ullamco laboris nisi ut aliquip 
ex ea commodo consequat. Duis aute irure dolor in 
reprehenderit in voluptate velit esse cillum dolore 
eu fugiat nulla pariatur.
"""

ExpandableText(loremIpsum)

Basic usage demo

Customization options

ExpandableText(loremIpsum)
  .font(.headline)
  .foregroundColor(.secondary)
  .lineLimit(4)
  .moreButtonText("read more")
  .moreButtonFont(.headline.bold())
  .moreButtonColor(.red)
  .enableCollapse(true)
  .expandAnimation(.easeInOut(duration: 2))
  .trimMultipleNewlinesWhenTruncated(false)

Customization demo

Credits

License

Available under The Unlicense license. See LICENSE file for further information.