n3d1117/expandabletext
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.
Installation
Available via the Swift Package Manager. Requires iOS 13+.
https://github.com/n3d1117/ExpandableTextFeatures
- Customizable line limit
- Customizable font, color, and
morebutton appearance with SwiftUI-like modifiers - Automatically hide
morebutton 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
<table> <tr> <td>
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)</td> <td>
[Basic usage demo] </td> </tr> </table>
Customization options
<table> <tr> <td>
ExpandableText(loremIpsum)
.font(.headline)
.foregroundColor(.secondary)
.lineLimit(4)
.moreButtonText("read more")
.moreButtonFont(.headline.bold())
.moreButtonColor(.red)
.enableCollapse(true)
.expandAnimation(.easeInOut(duration: 2))
.trimMultipleNewlinesWhenTruncated(false)</td> <td>
[Customization demo] </td> </tr> </table>
Credits
- NuPlay/ExpandableText for inspiration and some portions of code
License
Available under The Unlicense license. See LICENSE file for further information.
</tr> </table>
Package Metadata
Repository: n3d1117/expandabletext
Default branch: main
README: README.md