/RichText

Easily show RichText(html) in SwiftUI

Primary LanguageSwiftMIT LicenseMIT

RichText

github

Swift: 5.1+ iOS: 13.0+

스크린샷 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(ColorScheme.auto)
                .imageRadius(12)
                .fontType(FontType.system)
                .foregroundColor(light: Color.primary, dark: Color.primary)
                .linkColor(light: Color.blue, dark: Color.blue)
                .colorPreference(forceColor: .onlyLinks)
                .customCSS("")
                .placeholder {
                    Text("loading")
                }
        }
    }
}

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: "1.7.0"))
]

Sample Text

Click
import SwiftUI
import RichText

struct RichText_Test: View {
    @State var  html = """
        <h1>Non quam nostram quidem, inquit Pomponius iocans;</h1>
        
        <img src = "https://user-images.githubusercontent.com/73557895/126889699-a735f993-2d95-4897-ae40-bcb932dc23cd.png">
        

        <p>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. <i>Quam illa ardentis amores excitaret sui! Cur tandem?</i> </p>

        <dl>
            <dt><dfn>Avaritiamne minuis?</dfn></dt>
            <dd>Placet igitur tibi, Cato, cum res sumpseris non concessas, ex illis efficere, quod velis?</dd>
            <dt><dfn>Immo videri fortasse.</dfn></dt>
            <dd>Quae qui non vident, nihil umquam magnum ac cognitione dignum amaverunt.</dd>
            <dt><dfn>Si longus, levis.</dfn></dt>
            <dd>Ita ne hoc quidem modo paria peccata sunt.</dd>
        </dl>


        <ol>
            <li>Possumusne ergo in vita summum bonum dicere, cum id ne in cena quidem posse videamur?</li>
            <li>Placet igitur tibi, Cato, cum res sumpseris non concessas, ex illis efficere, quod velis?</li>
            <li>Unum nescio, quo modo possit, si luxuriosus sit, finitas cupiditates habere.</li>
        </ol>


        <blockquote cite="http://loripsum.net">
            Aristoteles, Xenocrates, tota illa familia non dabit, quippe qui valitudinem, vires, divitias, gloriam, multa alia bona esse dicant, laudabilia non dicant.
        </blockquote>


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

        <ul>
            <li>Cur igitur, inquam, res tam dissimiles eodem nomine appellas?</li>
            <li>Omnia peccata paria dicitis.</li>
        </ul>


        <h2>Laboro autem non sine causa;</h2>

        <p>Itaque contra est, ac dicitis; <code>Illa argumenta propria videamus, cur omnia sint paria peccata.</code> </p>

        <pre>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.
        </pre>



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

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

How To Use

Variable explanation

  • html : which you want to show (String type)

Modifier

Modifier Default
.lineHeight(_ lineHeight: CGFloat) 170
.imageRadius(_ imageRadius: CGFloat) 0
.fontType(_ fontType: FontType) .system
.colorScheme(_ colorScheme: ColorScheme) .auto
.colorImportant(_ colorImportant: Bool) false
.placeholder<T>(@ViewBuilder content: () -> T) nil
.linkOpenType(_ linkOpenType: LinkOpenType) .SFSafariView()
.linkColor(_ linkColor: ColorSet) ColorSet(light: "#007AFF", dark: "#0A84FF", isImportant: true)
  • lineHeight (default: 170) : Height of each line
  • imageRadius (default: 0) : Radius of image corner
  • fontType(default : .system): Font type in html view
  • colorScheme(default : .automatic) : light or dark mode (it changes text color)
  • colorImportant (default: false) : css '!important', It ignores the color in variable 'html' when colorImportant is true.
  • placeholder (default: nil) : What to display until Richtext views are completely drawn (View type)
  • linkOpenType (default: .SFSafariView()) : When the user clicks the link contained in html, Way to Show Webview
  • linkColor (default: ColorSet(light: "#007AFF", dark: "#0A84FF")) : linkColor (Color, UIColor)

Known Issues

Ambiguous use of '' The problem occurred by renaming the enum. For now, please use it like FontType.system.

Planned (Future work):

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