NuPlay / RichText

Easily show RichText(html) in SwiftUI
MIT License
209 stars 36 forks source link
attributedstring html ios richtext sfsafariviewcontroller swift swiftpackagemanager swiftui swiftui-components text uicomponents wkwebview

RichText

Swift: 5.1+ iOS: 13.0+ macOS-10.15+

github

스크린샷 2021-08-28 오전 12 14 09 스크린샷 2021-08-28 오전 12 13 59
LightMode DarkMode

Code

import SwiftUI
import RichText

struct RichText_Test: View {
    @State var  html = ""

    var body: some View {
       ScrollView{
            RichText(html: html)
                .lineHeight(170)
                .colorScheme(.auto)
                .imageRadius(12)
                .fontType(.system)
                .foregroundColor(light: Color.primary, dark: Color.primary)
                .linkColor(light: Color.blue, dark: Color.blue)
                .colorPreference(forceColor: .onlyLinks)
                .linkOpenType(.SFSafariView())
                .customCSS("")
                .placeholder {
                    Text("loading")
                }
                .transition(.easeOut)
        }
    }
}

struct RichText_Test_Previews: PreviewProvider {
    static var previews: some View {
        RichText_Test()
    }
}

Swift Package Manager

The Swift Package Manager is a tool for automating the distribution of Swift code and is integrated into the swift compiler.

Once you have your Swift package set up, adding RichText as a dependency is as easy as adding it to the dependencies value of your Package.swift.

dependencies: [
    .package(url: "https://github.com/NuPlay/RichText.git", .upToNextMajor(from: "2.0.0"))
]

More

import SwiftUI
import RichText

struct RichText_Test: View {
    @State var  html = ""

    let config: Configuration = Configuration(customCSS: String, fontType: FontType, fontColor: ColorSet, lineHeight: CGFloat, colorScheme: ColorScheme, imageRadius: CGFloat, linkOpenType: LinkOpenType, linkColor: ColorSet, isColorsImportant: ColorPreference)

    var body: some View {
       ScrollView{
        RichText(html: text, configuration: config, placeholder: AnyView?)
                .lineHeight(170)
                .colorScheme(.auto)
                .imageRadius(12)
                .fontType(.system)
                .foregroundColor(light: Color.primary, dark: Color.primary)
                .linkColor(light: Color.blue, dark: Color.blue)
                .colorPreference(forceColor: .onlyLinks)
                .linkOpenType(.SFSafariView())
                .customCSS("")
                .placeholder {
                    Text("loading")
                }
                .transition(.easeOut)
        }
    }
}

struct RichText_Test_Previews: PreviewProvider {
    static var previews: some View {
        RichText_Test()
    }
}

Custom Font

import SwiftUI
import RichText

struct RichText_Test: View {
    @State private var  html = ""

    var body: some View {
       ScrollView{
        RichText(html: html)
        .fontType(.customName("Noto Sans"))
        .customCSS("""
                 @font-face {
                        font-family: 'Noto Sans';
                        src: url("NotoSans-Regular.ttf") format('truetype');
                            }
                """)
        }
    }
}

struct RichText_Test_Previews: PreviewProvider {
    static var previews: some View {
        RichText_Test()
    }
}

Sample Text

Click
```swift import SwiftUI import RichText struct RichText_Test: View { @State var html = """

Non quam nostram quidem, inquit Pomponius iocans;

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Quis istum dolorem timet? Sit sane ista voluptas. Quis est tam dissimile homini. Duo Reges: constructio interrete. Quam illa ardentis amores excitaret sui! Cur tandem?

Avaritiamne minuis?
Placet igitur tibi, Cato, cum res sumpseris non concessas, ex illis efficere, quod velis?
Immo videri fortasse.
Quae qui non vident, nihil umquam magnum ac cognitione dignum amaverunt.
Si longus, levis.
Ita ne hoc quidem modo paria peccata sunt.
  1. Possumusne ergo in vita summum bonum dicere, cum id ne in cena quidem posse videamur?
  2. Placet igitur tibi, Cato, cum res sumpseris non concessas, ex illis efficere, quod velis?
  3. Unum nescio, quo modo possit, si luxuriosus sit, finitas cupiditates habere.
Aristoteles, Xenocrates, tota illa familia non dabit, quippe qui valitudinem, vires, divitias, gloriam, multa alia bona esse dicant, laudabilia non dicant.

Scrupulum, inquam, abeunti; Conferam tecum, quam cuique verso rem subicias; Audeo dicere, inquit. Maximus dolor, inquit, brevis est. Nos commodius agimus.

  • Cur igitur, inquam, res tam dissimiles eodem nomine appellas?
  • Omnia peccata paria dicitis.

Laboro autem non sine causa;

Itaque contra est, ac dicitis; Illa argumenta propria videamus, cur omnia sint paria peccata.

Nunc dicam de voluptate, nihil scilicet novi, ea tamen, quae
        te ipsum probaturum esse confidam.

        Sin est etiam corpus, ista explanatio naturae nempe hoc
        effecerit, ut ea, quae ante explanationem tenebamus,
        relinquamus.
        
""" var body: some View { ScrollView{ RichText(html: html) .lineHeight(170) .colorScheme(.auto) .imageRadius(12) .fontType(.system) .foregroundColor(light: Color.primary, dark: Color.primary) .linkColor(light: Color.blue, dark: Color.blue) .colorPreference(forceColor: .onlyLinks) .customCSS("") .linkOpenType(.SFSafariView()) .placeholder { Text("loading") } .transition(.easeOut) } } } struct RichText_Test_Previews: PreviewProvider { static var previews: some View { RichText_Test() } } ```

If use for macOS

macOS Guide

How To Use

Variable explanation

Modifier

Modifier Default
.foregroundColor(light: Color, dark: Color) (light: "000000", dark: "F2F2F2")
.imageRadius(_ imageRadius: CGFloat) 0
.customCSS(_ customCSS: String) ""
.lineHeight(_ lineHeight: CGFloat) 170
.colorScheme(_ colorScheme: ColorScheme) .auto
.fontType(_ fontType: FontType) .system
.linkColor(_ linkColor: ColorSet) ColorSet(light: "#007AFF", dark: "#0A84FF", isImportant: true)
.linkOpenType(_ linkOpenType: LinkOpenType) .Safari
.placeholder<T>(@ViewBuilder content: () -> T) nil
.colorPreference(forceColor: ColorPreference) .onlyLinks
.transition(_ transition: Animation?) .none

Known Issues

If you are trying to display very large content, it may not be displayed.

Planned (Future work):

A variety of options. If you need any options, leave them in the issues or discussion.