$ grep -r Tag: «swiftui»

Этот релиз посвящен обеспечению совместимости с Swift 6.3, существенному переписыванию обработки подсветки синтаксиса и значительному улучшению отзывчивости при редактировании очень больших HTML-документов.

Добавлено

• Добавлен исполняемый таргет HTMLEditorBenchmarks для проведения повторяемых замеров производительности.
• Добавлена поддержка бенчмарков для: полного планирования подсветки, повторного использования перекрытий (overlap reuse), инвалидации правок, переназначения видимой подсветки и путей локальной перерисовки больших документов.
• Добавлены специализированные регрессионные тесты для:
  • повторного использования кэша планировщика и инвалидации в рамках документа;
  • крайних случаев с некорректными NSRange и кодировкой UTF-16;
  • подсветки значений атрибутов в кавычках и без них;
  • переназначения состояния видимой подсветки;
  • покрытия подсветки на уровне блоков;
  • политик редактирования и прокрутки больших документов.

Изменено

• Runtime редактора была отрефакторена на более мелкие специализированные компоненты, включая отдельные файлы для жизненного цикла координатора, вьюпорта, редактирования, политик, покрытия, структурных диапазонов и состояния видимой подсветки.
• Синтаксический анализатор был разбит на компоненты на базе планировщика и исполнителя для более четкого разделения этапов сканирования, планирования и применения подсветки.
• Редактор переведен на адаптивную модель выполнения, которая меняет свое поведение в зависимости от размера документа, вместо того чтобы обрабатывать все HTML-документы одинаково.

Улучшено

• Значительно улучшена производительность при редактировании больших документов благодаря:
  • приоритетной подсветке видимой области;
  • кэшированию планировщика в пределах документа и целевой инвалидации;
  • кэшированию планов видимых диапазонов;
  • отслеживанию покрытия подсветки на уровне блоков;
  • выравниванию структурных «грязных» диапазонов вокруг правок;
  • двухфазному редактированию больших файлов с немедленным микро-проходом и отложенной расширенной перерисовкой;
  • объединению частых правок для снижения частоты перерисовок;
  • семантической подсветке во время простоя прокрутки;
  • отложенной синхронизации привязок для больших документов;
  • автоматическому включению режима allowsNonContiguousLayout в режиме работы с большими файлами.
• Повышена стабильность подсветки при наборе текста в середине очень большого HTML-документа за счет сохранения состояния видимого оверлея и уменьшения частоты перерисовок вокруг курсора.
• Улучшена настройка производительности для больших файлов с помощью выделенных бенчмарков и runtime-зондов.

Исправлено

• Исправлены проблемы компиляции и конкурентности, необходимые для совместимости с Swift 6.3.
• Исправлено несколько проблем в путях обновления редактора, связанных с состоянием координатора, задачами подсветки и поведением main-actor.
• Исправлены регрессии подсветки и крайние случаи, связанные с:
  • частичными тегами;
  • пустым вводом;
  • большими объемами данных;
  • раскраской значений атрибутов;
  • потерей видимой подсветки при редактировании больших файлов;
  • некорректными или обрезанными видимыми диапазонами.

Примечания

• Для небольших HTML-документов по-прежнему используется семантическая подсветка всего документа.
• Очень большие HTML-файлы теперь автоматически переключаются в более консервативный, ориентированный на производительность режим редактирования, чтобы обеспечить плавность прокрутки и набора текста.

Попробуйте на GitHub: https://github.com/makoni/HTMLEditor-SwiftUI

Star Fork

Потратил еще немного времени на HTMLEditor для SwiftUI. В новой версии 1.0.3 внесены значительные улучшения производительности (спасибо Claude Code).

Попробуйте его на GitHub: https://github.com/makoni/HTMLEditor-SwiftUI

Несколько месяцев назад я захотел добавить в одно из своих приложений текстовый редактор с подсветкой синтаксиса HTML. Я попробовал пару библиотек, найденных на GitHub, но ни одна из них мне не подошла. В основном они слишком тяжеловесные и пытаются уместить в себе всё сразу. И в конечном итоге они работают нестабильно и с багами.

Вдохновившись концепцией «vibe coding», я сделал свой собственный вариант. Он отлично работает и не пытается быть полноценной IDE или серьезным редактором кода. Это просто простой SwiftUI компонент с текстовым редактором и подсветкой синтаксиса. Цвета можно настроить с помощью простой структуры.

Проект на GitHub: https://github.com/makoni/HTMLEditor-SwiftUI

TextEditor в SwiftUI все еще не имеет API для получения выделения пользователя. Но так как внутри используется NSTextView, мы можем подписаться на его уведомления.

Вот пример того, как получить подстроку из пользовательского выделения:

До macOS 15:

import SwiftUI

struct ContentView: View {
    @State var myString = "Привет, мир"
    @State var selectedString = ""

    var body: some View {
        HStack {
            Text("Выделение:")
                .foregroundStyle(.secondary)
            Text("\"\(selectedString)\"")
        }.padding()

        TextEditor(text: $myString)
            .font(.title)
            .onReceive(NotificationCenter.default.publisher(
                for: NSTextView.didChangeSelectionNotification
            ), perform: { notification in
                guard let textView = notification.object as? NSTextView else { return }

                // Проверяем, тот ли это текст, который нам нужен
                guard textView.string == myString else { return }

                let selectionRage = textView.selectedRange()

                let start = String.Index(
                    utf16Offset: selectionRage.lowerBound, in: myString
                )
                let end = String.Index(
                    utf16Offset: selectionRage.upperBound, in: myString
                )
                let subStringRange: Range<String.Index> = start..<end

                selectedString = String(myString[subStringRange])
        })
    }
}

На macOS 15+ появилась новая структура TextSelection, которую можно использовать в подписчике .onChange:

import SwiftUI

struct ContentView: View {
    @State var myString = "Привет, мир"
    @SSState var selectedString = ""
    @State private var selection: TextSelection?

    var body: some View {
        HStack {
            Text("Выделение:")
                .foregroundStyle(.secondary)
            Text("\"\(selectedString)\"")
        }.padding()

        TextEditor(text: $myString, selection: $selection)
            .font(.title)
            .onChange(of: selection) {
                if let selection = selection.take() {
                    if case let .selection(range) = selection.indices {
                        selectedString = String(myString[range])
                    }
                }
            }
    }
}

Чтобы использовать массив моделей во вью List в SwiftUI, эти модели должны соответствовать протоколу Identifiable.

Вот пример модели:

struct MyDataModel {
    let title: String
    let message: String
} 

А вот пример вью SwiftUI, в котором хотим показать список:

struct TestView: View {
    var dataArray: [MyDataModel]
    var body: some View {
        List(dataArray) { data in
            VStack {
                Text(data.title)
                Text(data.message)
            }
        }
    }
} 

Если использовать MyDataModel внутри List, Xcode выдаст ошибку:

Иногда модель просто так не поменять. Например, она может быть из стороннего SDK, который вы используете в приложении. Но можно написать обёртку для этой структуры, которая соответствует протоколу Identifiable:

struct MyDataModelWrapper: Identifiable {
    var id = UUID()
    var data: MyDataModel
}

let testDataModel = MyDataModel(
    title: "Title 1",
    message: "I wanna be used inside of a List"
)

let wrappedData = MyDataModelWrapper(data: testDataModel)

Тогда вью будет выглядеть так:

struct TestView: View {
    var dataArray: [MyDataModelWrapper] 

    some View {
        List(dataArray) { wrappedData in
            VStack {
                Text(wrappedData.data.title)
                Text(wrappedData.data.message)
            }
        }
    }
}

Готово.