HTMLEditor-SwiftUI

HTMLEditor-SwiftUI is a Swift package designed for macOS (v13 and above) that provides a SwiftUI-based text editor with HTML syntax highlighting.

Features

• Built-in syntax highlighting for HTML content.
• Customizable themes and color schemes for the editor.
• Parsing HTML into an AST for highlighting.

Adding HTMLEditor-SwiftUI to Your Project

To add HTMLEditor-SwiftUI to your Swift project, follow these steps:

1. Open your project in Xcode.
2. Go to File > Add Packages....
3. Enter the following URL in the search bar:

   https://github.com/your-repo/HTMLEditor-SwiftUI.git
   

4. Select the version rule (e.g., "Up to Next Major Version") and click "Add Package".
5. Import the package in your Swift files where needed:

   import HTMLEditor

Demo App

This repository includes a demo app located in the HTMLEditorDemoApp/ directory. The demo app showcases the capabilities of the HTMLEditor-SwiftUI package, including syntax highlighting and theme customization. To try it out:

1. Open the HTMLEditor-Demo.xcodeproj file in Xcode.
2. Build and run the app on your macOS system.

License

This project is licensed under the MIT License. See the LICENSE file for details.

Contributions

Contributions are welcome! Feel free to open issues or submit pull requests to improve the package.

Usage Example

Here is a simple example demonstrating the usage of HTMLEditorView in a SwiftUI view:

import SwiftUI
import HTMLEditor

struct ContentView: View {
    @State private var htmlContent: String = "<p>Hello, World!</p>"

    var body: some View {
        HTMLEditorView(html: $htmlContent)
            .frame(minWidth: 400, minHeight: 300)
            .padding()
    }
}

Custom Theme Example

You can provide your own color theme to the HTML editor. Here's an example:

import SwiftUI
import HTMLEditor

struct CustomThemeView: View {
    @State private var htmlContent: String = "<p>Custom Theme Example</p>"

    private let customTheme = HTMLEditorTheme(
        light: HTMLEditorColorScheme(
            foreground: NSColor.blue,
            background: NSColor.yellow,
            tag: NSColor.purple,
            attributeName: NSColor.orange,
            attributeValue: NSColor.green,
            font: NSFont.monospacedSystemFont(ofSize: 16, weight: .bold)
        ),
        dark: HTMLEditorColorScheme(
            foreground: NSColor.white,
            background: NSColor.black,
            tag: NSColor.red,
            attributeName: NSColor.cyan,
            attributeValue: NSColor.magenta,
            font: NSFont.monospacedSystemFont(ofSize: 16, weight: .bold)
        )
    )

    var body: some View {
        HTMLEditor(html: $html, theme: customTheme)
            .frame(minWidth: 400, minHeight: 300)
            .padding()
    }
}