VisibleSelection.h [plain text]
#pragma once
#include "TextGranularity.h"
#include "VisiblePosition.h"
#include <wtf/EnumTraits.h>
namespace WebCore {
enum class SelectionDirection : uint8_t { Forward, Backward, Right, Left };
class VisibleSelection {
public:
WEBCORE_EXPORT VisibleSelection();
static constexpr auto defaultAffinity = VisiblePosition::defaultAffinity;
VisibleSelection(const Position& anchor, const Position& focus, Affinity = defaultAffinity, bool isDirectional = false);
VisibleSelection(const Position&, Affinity, bool isDirectional = false);
WEBCORE_EXPORT VisibleSelection(const SimpleRange&, Affinity = defaultAffinity, bool isDirectional = false);
WEBCORE_EXPORT VisibleSelection(const VisiblePosition&, bool isDirectional = false);
WEBCORE_EXPORT VisibleSelection(const VisiblePosition& anchor, const VisiblePosition& focus, bool isDirectional = false);
WEBCORE_EXPORT static VisibleSelection selectionFromContentsOfNode(Node*);
void setAffinity(Affinity affinity) { m_affinity = affinity; }
Affinity affinity() const { return m_affinity; }
void setBase(const Position&);
void setBase(const VisiblePosition&);
void setExtent(const Position&);
void setExtent(const VisiblePosition&);
Position uncanonicalizedStart() const;
Position uncanonicalizedEnd() const;
Position anchor() const;
Position focus() const;
WEBCORE_EXPORT Optional<SimpleRange> range() const;
Position base() const { return m_base; }
Position extent() const { return m_extent; }
Position start() const { return m_start; }
Position end() const { return m_end; }
VisiblePosition visibleStart() const { return VisiblePosition(m_start, isRange() ? Affinity::Downstream : affinity()); }
VisiblePosition visibleEnd() const { return VisiblePosition(m_end, isRange() ? Affinity::Upstream : affinity()); }
VisiblePosition visibleBase() const { return VisiblePosition(m_base, isRange() ? (isBaseFirst() ? Affinity::Upstream : Affinity::Downstream) : affinity()); }
VisiblePosition visibleExtent() const { return VisiblePosition(m_extent, isRange() ? (isBaseFirst() ? Affinity::Downstream : Affinity::Upstream) : affinity()); }
operator VisiblePositionRange() const { return { visibleStart(), visibleEnd() }; }
bool isNone() const { return m_type == Type::None; }
bool isCaret() const { return m_type == Type::Caret; }
bool isRange() const { return m_type == Type::Range; }
bool isCaretOrRange() const { return !isNone(); }
bool isNonOrphanedRange() const { return isRange() && !start().isOrphan() && !end().isOrphan(); }
bool isNoneOrOrphaned() const { return isNone() || start().isOrphan() || end().isOrphan(); }
bool isBaseFirst() const { return m_anchorIsFirst; }
bool isDirectional() const { return m_isDirectional; }
void setIsDirectional(bool isDirectional) { m_isDirectional = isDirectional; }
WEBCORE_EXPORT bool isAll(EditingBoundaryCrossingRule) const;
void appendTrailingWhitespace();
WEBCORE_EXPORT bool expandUsingGranularity(TextGranularity granularity);
WEBCORE_EXPORT Optional<SimpleRange> firstRange() const;
WEBCORE_EXPORT Optional<SimpleRange> toNormalizedRange() const;
WEBCORE_EXPORT Element* rootEditableElement() const;
WEBCORE_EXPORT bool isContentEditable() const;
WEBCORE_EXPORT bool hasEditableStyle() const;
WEBCORE_EXPORT bool isContentRichlyEditable() const;
Node* nonBoundaryShadowTreeRootNode() const;
WEBCORE_EXPORT bool isInPasswordField() const;
WEBCORE_EXPORT static Position adjustPositionForEnd(const Position& currentPosition, Node* startContainerNode);
WEBCORE_EXPORT static Position adjustPositionForStart(const Position& currentPosition, Node* startContainerNode);
#if ENABLE(TREE_DEBUGGING)
void debugPosition() const;
String debugDescription() const;
void showTreeForThis() const;
#endif
void setWithoutValidation(const Position&, const Position&);
private:
void validate(TextGranularity = TextGranularity::CharacterGranularity);
void setBaseAndExtentToDeepEquivalents();
void adjustSelectionRespectingGranularity(TextGranularity);
void adjustSelectionToAvoidCrossingShadowBoundaries();
void adjustSelectionToAvoidCrossingEditingBoundaries();
void updateSelectionType();
Position m_anchor; Position m_focus; Position m_base; Position m_extent; Position m_start; Position m_end;
Affinity m_affinity { defaultAffinity };
enum class Type : uint8_t { None, Caret, Range };
Type m_type { Type::None };
bool m_anchorIsFirst : 1; bool m_isDirectional : 1; };
inline bool operator==(const VisibleSelection& a, const VisibleSelection& b)
{
return a.start() == b.start() && a.end() == b.end() && a.affinity() == b.affinity() && a.isBaseFirst() == b.isBaseFirst() && a.isDirectional() == b.isDirectional();
}
inline bool operator!=(const VisibleSelection& a, const VisibleSelection& b)
{
return !(a == b);
}
WEBCORE_EXPORT WTF::TextStream& operator<<(WTF::TextStream&, const VisibleSelection&);
}
#if ENABLE(TREE_DEBUGGING)
void showTree(const WebCore::VisibleSelection&);
void showTree(const WebCore::VisibleSelection*);
#endif
namespace WTF {
template<> struct EnumTraits<WebCore::SelectionDirection> {
using values = EnumValues<
WebCore::SelectionDirection,
WebCore::SelectionDirection::Forward,
WebCore::SelectionDirection::Backward,
WebCore::SelectionDirection::Right,
WebCore::SelectionDirection::Left
>;
};
}