1 | /* |
2 | * Copyright (C) 2004 Apple Inc. All rights reserved. |
3 | * |
4 | * Redistribution and use in source and binary forms, with or without |
5 | * modification, are permitted provided that the following conditions |
6 | * are met: |
7 | * 1. Redistributions of source code must retain the above copyright |
8 | * notice, this list of conditions and the following disclaimer. |
9 | * 2. Redistributions in binary form must reproduce the above copyright |
10 | * notice, this list of conditions and the following disclaimer in the |
11 | * documentation and/or other materials provided with the distribution. |
12 | * |
13 | * THIS SOFTWARE IS PROVIDED BY APPLE INC. ``AS IS'' AND ANY |
14 | * EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE |
15 | * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR |
16 | * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL APPLE INC. OR |
17 | * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, |
18 | * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, |
19 | * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR |
20 | * PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY |
21 | * OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT |
22 | * (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE |
23 | * OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. |
24 | */ |
25 | |
26 | #pragma once |
27 | |
28 | #include "ExceptionOr.h" |
29 | #include "FloatSize.h" |
30 | #include "FragmentScriptingPermission.h" |
31 | #include "HTMLInterchange.h" |
32 | #include <wtf/Forward.h> |
33 | #include <wtf/Function.h> |
34 | #include <wtf/HashMap.h> |
35 | |
36 | namespace WebCore { |
37 | |
38 | class ArchiveResource; |
39 | class ContainerNode; |
40 | class Document; |
41 | class DocumentFragment; |
42 | class Element; |
43 | class Frame; |
44 | class HTMLElement; |
45 | class Node; |
46 | class Page; |
47 | struct PresentationSize; |
48 | class QualifiedName; |
49 | class Range; |
50 | class VisibleSelection; |
51 | |
52 | void replaceSubresourceURLs(Ref<DocumentFragment>&&, HashMap<AtomString, AtomString>&&); |
53 | void removeSubresourceURLAttributes(Ref<DocumentFragment>&&, WTF::Function<bool(const URL&)> shouldRemoveURL); |
54 | |
55 | enum class MSOListQuirks { CheckIfNeeded, Disabled }; |
56 | std::unique_ptr<Page> createPageForSanitizingWebContent(); |
57 | String sanitizeMarkup(const String&, MSOListQuirks = MSOListQuirks::Disabled, Optional<WTF::Function<void(DocumentFragment&)>> fragmentSanitizer = WTF::nullopt); |
58 | String sanitizedMarkupForFragmentInDocument(Ref<DocumentFragment>&&, Document&, MSOListQuirks, const String& originalMarkup); |
59 | |
60 | WEBCORE_EXPORT Ref<DocumentFragment> createFragmentFromText(Range& context, const String& text); |
61 | WEBCORE_EXPORT Ref<DocumentFragment> createFragmentFromMarkup(Document&, const String& markup, const String& baseURL, ParserContentPolicy = AllowScriptingContent); |
62 | ExceptionOr<Ref<DocumentFragment>> createFragmentForInnerOuterHTML(Element&, const String& markup, ParserContentPolicy); |
63 | RefPtr<DocumentFragment> createFragmentForTransformToFragment(Document&, const String& sourceString, const String& sourceMIMEType); |
64 | Ref<DocumentFragment> createFragmentForImageAndURL(Document&, const String&, PresentationSize preferredSize); |
65 | ExceptionOr<Ref<DocumentFragment>> createContextualFragment(Element&, const String& markup, ParserContentPolicy); |
66 | |
67 | bool isPlainTextMarkup(Node*); |
68 | |
69 | // These methods are used by HTMLElement & ShadowRoot to replace the children with respected fragment/text. |
70 | ExceptionOr<void> replaceChildrenWithFragment(ContainerNode&, Ref<DocumentFragment>&&); |
71 | |
72 | enum class ResolveURLs : uint8_t { No, Yes, YesExcludingLocalFileURLsForPrivacy }; |
73 | enum class ConvertBlocksToInlines : uint8_t { No, Yes }; |
74 | enum class SerializeComposedTree : uint8_t { No, Yes }; |
75 | WEBCORE_EXPORT String serializePreservingVisualAppearance(const Range&, Vector<Node*>* = nullptr, AnnotateForInterchange = AnnotateForInterchange::No, ConvertBlocksToInlines = ConvertBlocksToInlines::No, ResolveURLs = ResolveURLs::No); |
76 | String serializePreservingVisualAppearance(const VisibleSelection&, ResolveURLs = ResolveURLs::No, SerializeComposedTree = SerializeComposedTree::No, Vector<Node*>* = nullptr); |
77 | |
78 | enum class SerializedNodes : uint8_t { SubtreeIncludingNode, SubtreesOfChildren }; |
79 | enum class SerializationSyntax : uint8_t { HTML, XML }; |
80 | WEBCORE_EXPORT String serializeFragment(const Node&, SerializedNodes, Vector<Node*>* = nullptr, ResolveURLs = ResolveURLs::No, Vector<QualifiedName>* tagNamesToSkip = nullptr, SerializationSyntax = SerializationSyntax::HTML); |
81 | |
82 | String urlToMarkup(const URL&, const String& title); |
83 | |
84 | WEBCORE_EXPORT String documentTypeString(const Document&); |
85 | |
86 | } |
87 | |