1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79 80 81 82 83 84 85 86 87 88 89 90 91 92 93 94 95 96 97 98 99 100 101 102 103 104 105 106 107 108 109 110 111 112 113 114 115 116 117 118 119 120 121 122 123 124 125 126 127 128 129 130 131 132 133 134 135 136 137 138 139 140 141 142 143 144 145 146 147 148 149 150 151 152 153 154 155 156 157 158 159 160 161 162 163 164 165 166 167 168 169 170 171 172 173 174 175 176 177 178 179 180 181 182 183 184 185 186 187 188 189 190 191 192 193 194 195 196 197 198 199 200 201 202 203 204 205 206 207 208 209 210 211 212 213 214 215 216 217 218 219 220 221 222 223 224 225 226 227 228 229 230 231 232 233 234 235 236 237 238 239 240 241 242 243
|
/*
* Copyright (C) 2006-2020 Apple Inc. All rights reserved.
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Library General Public
* License as published by the Free Software Foundation; either
* version 2 of the License, or (at your option) any later version.
*
* This library is distributed in the hope that it will be useful,
* but WITHOUT ANY WARRANTY; without even the implied warranty of
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
* Library General Public License for more details.
*
* You should have received a copy of the GNU Library General Public License
* along with this library; see the file COPYING.LIB. If not, write to
* the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor,
* Boston, MA 02110-1301, USA.
*
*/
#pragma once
#include "DictationContext.h"
#include "SimpleRange.h"
#include <variant>
#include <wtf/Forward.h>
#include <wtf/OptionSet.h>
#include <wtf/UUID.h>
#include <wtf/WeakPtr.h>
#include <wtf/text/MakeString.h>
#include <wtf/text/WTFString.h>
#if PLATFORM(IOS_FAMILY)
#import <wtf/RetainPtr.h>
#endif
namespace WebCore {
class DocumentMarker;
namespace WritingTools {
using TextSuggestionID = WTF::UUID;
using SessionID = WTF::UUID;
}
} // namespace WebCore
namespace WTF {
template<typename T> struct IsDeprecatedWeakRefSmartPointerException;
template<> struct IsDeprecatedWeakRefSmartPointerException<WebCore::DocumentMarker> : std::true_type { };
}
namespace WebCore {
enum class DocumentMarkerType : uint32_t {
Spelling = 1 << 0,
Grammar = 1 << 1,
TextMatch = 1 << 2,
// Text has been modified by spell correction, reversion of spell correction or other type of substitution.
// On some platforms, this prevents the text from being autocorrected again. On post Snow Leopard Mac OS X,
// if a Replacement marker contains non-empty description, a reversion UI will be shown.
Replacement = 1 << 3,
// Renderer needs to add underline indicating that the text has been modified by spell
// correction. Text with Replacement marker doesn't necessarily has CorrectionIndicator
// marker. For instance, after some text has been corrected, it will have both Replacement
// and CorrectionIndicator. However, if user further modifies such text, we would remove
// CorrectionIndicator marker, but retain Replacement marker.
CorrectionIndicator = 1 << 4,
// Correction suggestion has been offered, but got rejected by user.
RejectedCorrection = 1 << 5,
// Text has been modified by autocorrection. The description of this marker is the original text before autocorrection.
Autocorrected = 1 << 6,
// On some platforms, this prevents the text from being spellchecked again.
SpellCheckingExemption = 1 << 7,
// This marker indicates user has deleted an autocorrection starting at the end of the
// range that bears this marker. In some platforms, if the user later inserts the same original
// word again at this position, it will not be autocorrected again. The description of this
// marker is the original word before autocorrection was applied.
DeletedAutocorrection = 1 << 8,
// This marker indicates that the range of text spanned by the marker is entered by voice dictation,
// and it has alternative text.
DictationAlternatives = 1 << 9,
#if ENABLE(TELEPHONE_NUMBER_DETECTION)
TelephoneNumber = 1 << 10,
#endif
#if PLATFORM(IOS_FAMILY)
// FIXME: iOS should share the same dictation mark system with the other platforms.
DictationPhraseWithAlternatives = 1 << 11,
DictationResult = 1 << 12,
#endif
// This marker indicates that the user has selected a text candidate.
AcceptedCandidate = 1 << 13,
// This marker indicates that the user has initiated a drag with this content.
DraggedContent = 1 << 14,
#if ENABLE(PLATFORM_DRIVEN_TEXT_CHECKING)
// This marker maintains state for the platform text checker.
PlatformTextChecking = 1 << 15,
#endif
#if ENABLE(WRITING_TOOLS)
WritingToolsTextSuggestion = 1 << 16,
#endif
TransparentContent = 1 << 17,
};
// A range of a node within a document that is "marked", such as the range of a misspelled word.
// It optionally includes a description that could be displayed in the user interface.
class DocumentMarker : public CanMakeWeakPtr<DocumentMarker> {
public:
static constexpr OptionSet<DocumentMarkerType> allMarkers();
struct DictationData {
DictationContext context;
String originalText;
};
#if ENABLE(PLATFORM_DRIVEN_TEXT_CHECKING)
struct PlatformTextCheckingData {
String key;
String value;
};
#endif
#if ENABLE(WRITING_TOOLS)
struct WritingToolsTextSuggestionData {
enum class State: uint8_t {
Accepted,
Rejected
};
enum class Decoration: uint8_t {
None,
Underline,
};
String originalText;
WritingTools::TextSuggestionID suggestionID;
State state { State::Accepted };
Decoration decoration { Decoration::None };
};
#endif
struct TransparentContentData {
RefPtr<Node> node;
WTF::UUID uuid;
};
using Data = std::variant<
String
, DictationData // DictationAlternatives
#if PLATFORM(IOS_FAMILY)
, Vector<String> // DictationPhraseWithAlternatives
, RetainPtr<id> // DictationResult
#endif
, RefPtr<Node> // DraggedContent
#if ENABLE(PLATFORM_DRIVEN_TEXT_CHECKING)
, PlatformTextCheckingData // PlatformTextChecking
#endif
#if ENABLE(WRITING_TOOLS)
, WritingToolsTextSuggestionData // WritingToolsTextSuggestion
#endif
, TransparentContentData // TransparentContent
>;
DocumentMarker(DocumentMarkerType, OffsetRange, Data&& = { });
DocumentMarkerType type() const { return m_type; }
unsigned startOffset() const { return m_range.start; }
unsigned endOffset() const { return m_range.end; }
String description() const;
const Data& data() const { return m_data; }
void clearData() { m_data = String { }; }
// Offset modifications are done by DocumentMarkerController.
// Other classes should not call following setters.
void setStartOffset(unsigned offset) { m_range.start = offset; }
void setEndOffset(unsigned offset) { m_range.end = offset; }
void shiftOffsets(int delta);
private:
DocumentMarkerType m_type;
OffsetRange m_range;
Data m_data;
};
constexpr auto DocumentMarker::allMarkers() -> OptionSet<DocumentMarkerType>
{
return {
DocumentMarkerType::AcceptedCandidate,
DocumentMarkerType::Autocorrected,
DocumentMarkerType::CorrectionIndicator,
DocumentMarkerType::DeletedAutocorrection,
DocumentMarkerType::DictationAlternatives,
DocumentMarkerType::DraggedContent,
DocumentMarkerType::Grammar,
DocumentMarkerType::RejectedCorrection,
DocumentMarkerType::Replacement,
DocumentMarkerType::SpellCheckingExemption,
DocumentMarkerType::Spelling,
DocumentMarkerType::TextMatch,
#if ENABLE(TELEPHONE_NUMBER_DETECTION)
DocumentMarkerType::TelephoneNumber,
#endif
#if PLATFORM(IOS_FAMILY)
DocumentMarkerType::DictationPhraseWithAlternatives,
DocumentMarkerType::DictationResult,
#endif
#if ENABLE(PLATFORM_DRIVEN_TEXT_CHECKING)
DocumentMarkerType::PlatformTextChecking,
#endif
#if ENABLE(WRITING_TOOLS)
DocumentMarkerType::WritingToolsTextSuggestion,
#endif
DocumentMarkerType::TransparentContent,
};
}
inline DocumentMarker::DocumentMarker(DocumentMarkerType type, OffsetRange range, Data&& data)
: m_type(type)
, m_range(range)
, m_data(WTFMove(data))
{
}
inline void DocumentMarker::shiftOffsets(int delta)
{
m_range.start += delta;
m_range.end += delta;
}
inline String DocumentMarker::description() const
{
if (auto* description = std::get_if<String>(&m_data))
return *description;
#if ENABLE(WRITING_TOOLS)
if (auto* data = std::get_if<DocumentMarker::WritingToolsTextSuggestionData>(&m_data))
return makeString("('"_s, data->originalText, "', state: "_s, enumToUnderlyingType(data->state), ')');
#endif
return emptyString();
}
} // namespace WebCore
|