1/*
2 * Copyright (C) 2014 Igalia S.L.
3 *
4 * This library is free software; you can redistribute it and/or
5 * modify it under the terms of the GNU Lesser General Public
6 * License as published by the Free Software Foundation; either
7 * version 2 of the License, or (at your option) any later version.
8 *
9 * This library is distributed in the hope that it will be useful,
10 * but WITHOUT ANY WARRANTY; without even the implied warranty of
11 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
12 * Lesser General Public License for more details.
13 *
14 * You should have received a copy of the GNU Lesser General Public
15 * License along with this library; if not, write to the Free Software
16 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA
17 */
18
19#ifndef WebKitDOMDeprecated_h
20#define WebKitDOMDeprecated_h
21
22#if !defined(WEBKIT_DISABLE_DEPRECATED)
23
24#include <glib.h>
25#include <webkitdom/WebKitDOMNode.h>
26#include <webkitdom/WebKitDOMHTMLElement.h>
27#include <webkitdom/webkitdomdefines.h>
28
29G_BEGIN_DECLS
30
31/**
32 * webkit_dom_html_element_get_inner_html:
33 * @self: a #WebKitDOMHTMLElement
34 *
35 * Returns: a #gchar
36 *
37 * Deprecated: 2.8: Use webkit_dom_element_get_inner_html() instead.
38 */
39WEBKIT_DEPRECATED_FOR(webkit_dom_element_get_inner_html) gchar*
40webkit_dom_html_element_get_inner_html(WebKitDOMHTMLElement* self);
41
42/**
43 * webkit_dom_html_element_set_inner_html:
44 * @self: a #WebKitDOMHTMLElement
45 * @contents: a #gchar with contents to set
46 * @error: a #GError or %NULL
47 *
48 * Deprecated: 2.8: Use webkit_dom_element_set_inner_html() instead.
49 */
50WEBKIT_DEPRECATED_FOR(webkit_dom_element_set_inner_html) void
51webkit_dom_html_element_set_inner_html(WebKitDOMHTMLElement* self, const gchar* contents, GError** error);
52
53/**
54 * webkit_dom_html_element_get_outer_html:
55 * @self: a #WebKitDOMHTMLElement
56 *
57 * Returns: a #gchar
58 *
59 * Deprecated: 2.8: Use webkit_dom_element_get_outer_html() instead.
60 */
61WEBKIT_DEPRECATED_FOR(webkit_dom_element_get_outer_html) gchar*
62webkit_dom_html_element_get_outer_html(WebKitDOMHTMLElement* self);
63
64/**
65 * webkit_dom_html_element_set_outer_html:
66 * @self: a #WebKitDOMHTMLElement
67 * @contents: a #gchar with contents to set
68 * @error: a #GError or %NULL
69 *
70 * Deprecated: 2.8: Use webkit_dom_element_set_outer_html() instead.
71 */
72WEBKIT_DEPRECATED_FOR(webkit_dom_element_set_outer_html) void
73webkit_dom_html_element_set_outer_html(WebKitDOMHTMLElement* self, const gchar* contents, GError** error);
74
75/**
76 * webkit_dom_html_element_get_children:
77 * @self: A #WebKitDOMHTMLElement
78 *
79 * Returns: (transfer full): A #WebKitDOMHTMLCollection
80 *
81 * Deprecated: 2.10: Use webkit_dom_element_get_children() instead.
82 */
83WEBKIT_DEPRECATED_FOR(webkit_dom_element_get_children) WebKitDOMHTMLCollection*
84webkit_dom_html_element_get_children(WebKitDOMHTMLElement* self);
85
86/**
87 * webkit_dom_document_get_elements_by_tag_name:
88 * @self: A #WebKitDOMDocument
89 * @tag_name: a #gchar with the tag name
90 *
91 * Returns: (transfer full): a #WebKitDOMNodeList
92 *
93 * Deprecated: 2.12: Use webkit_dom_document_get_elements_by_tag_name_as_html_collection() instead.
94 */
95WEBKIT_DEPRECATED_FOR(webkit_dom_document_get_elements_by_tag_name_as_html_collection) WebKitDOMNodeList*
96webkit_dom_document_get_elements_by_tag_name(WebKitDOMDocument* self, const gchar* tag_name);
97
98/**
99 * webkit_dom_document_get_elements_by_tag_name_ns:
100 * @self: A #WebKitDOMDocument
101 * @namespace_uri: a #gchar with the namespace URI
102 * @tag_name: a #gchar with the tag name
103 *
104 * Returns: (transfer full): a #WebKitDOMNodeList
105 *
106 * Deprecated: 2.12: Use webkit_dom_document_get_elements_by_tag_name_ns_as_html_collection() instead.
107 */
108WEBKIT_DEPRECATED_FOR(webkit_dom_document_get_elements_by_tag_name_as_html_collection) WebKitDOMNodeList*
109webkit_dom_document_get_elements_by_tag_name_ns(WebKitDOMDocument* self, const gchar* namespace_uri, const gchar* tag_name);
110
111
112/**
113 * webkit_dom_document_get_elements_by_class_name:
114 * @self: A #WebKitDOMDocument
115 * @class_name: a #gchar with the tag name
116 *
117 * Returns: (transfer full): a #WebKitDOMNodeList
118 *
119 * Deprecated: 2.12: Use webkit_dom_document_get_elements_by_class_name_as_html_collection() instead.
120 */
121WEBKIT_DEPRECATED_FOR(webkit_dom_document_get_elements_by_class_name_as_html_collection) WebKitDOMNodeList*
122webkit_dom_document_get_elements_by_class_name(WebKitDOMDocument* self, const gchar* class_name);
123
124/**
125 * webkit_dom_element_get_elements_by_tag_name:
126 * @self: A #WebKitDOMElement
127 * @tag_name: a #gchar with the tag name
128 *
129 * Returns: (transfer full): a #WebKitDOMNodeList
130 *
131 * Deprecated: 2.12: Use webkit_dom_element_get_elements_by_tag_name_as_html_collection() instead.
132 */
133WEBKIT_DEPRECATED_FOR(webkit_dom_element_get_elements_by_tag_name_as_html_collection) WebKitDOMNodeList*
134webkit_dom_element_get_elements_by_tag_name(WebKitDOMElement* self, const gchar* tag_name);
135
136/**
137 * webkit_dom_element_get_elements_by_tag_name_ns:
138 * @self: A #WebKitDOMElement
139 * @namespace_uri: a #gchar with the namespace URI
140 * @tag_name: a #gchar with the tag name
141 *
142 * Returns: (transfer full): a #WebKitDOMNodeList
143 *
144 * Deprecated: 2.12: Use webkit_dom_element_get_elements_by_tag_name_ns_as_html_collection() instead.
145 */
146WEBKIT_DEPRECATED_FOR(webkit_dom_element_get_elements_by_tag_name_as_html_collection) WebKitDOMNodeList*
147webkit_dom_element_get_elements_by_tag_name_ns(WebKitDOMElement* self, const gchar* namespace_uri, const gchar* tag_name);
148
149
150/**
151 * webkit_dom_element_get_elements_by_class_name:
152 * @self: A #WebKitDOMElement
153 * @class_name: a #gchar with the tag name
154 *
155 * Returns: (transfer full): a #WebKitDOMNodeList
156 *
157 * Deprecated: 2.12: Use webkit_dom_element_get_elements_by_class_name_as_html_collection() instead.
158 */
159WEBKIT_DEPRECATED_FOR(webkit_dom_element_get_elements_by_class_name_as_html_collection) WebKitDOMNodeList*
160webkit_dom_element_get_elements_by_class_name(WebKitDOMElement* self, const gchar* class_name);
161
162/**
163 * webkit_dom_node_clone_node:
164 * @self: A #WebKitDOMNode
165 * @deep: A #gboolean
166 * @error: #GError
167 *
168 * Returns: (transfer none): A #WebKitDOMNode
169 *
170 * Deprecated: 2.14: Use webkit_dom_node_clone_node_with_error() instead.
171 */
172WEBKIT_DEPRECATED_FOR(webkit_dom_node_clone_node_with_error) WebKitDOMNode*
173webkit_dom_node_clone_node(WebKitDOMNode* self, gboolean deep, GError** error);
174
175
176/**
177 * webkit_dom_document_get_default_charset:
178 * @self: A #WebKitDOMDocument
179 *
180 * Returns: A #gchar
181 *
182 * Deprecated: 2.14
183 */
184WEBKIT_DEPRECATED gchar*
185webkit_dom_document_get_default_charset(WebKitDOMDocument* self);
186
187/**
188 * webkit_dom_text_replace_whole_text:
189 * @self: A #WebKitDOMText
190 * @content: A #gchar
191 * @error: #GError
192 *
193 * Returns: (transfer none): A #WebKitDOMText
194 *
195 * Deprecated: 2.14
196 */
197WEBKIT_DEPRECATED WebKitDOMText*
198webkit_dom_text_replace_whole_text(WebKitDOMText* self, const gchar* content, GError** error);
199
200/**
201 * webkit_dom_html_input_element_get_capture:
202 * @self: A #WebKitDOMHTMLInputElement
203 *
204 * Returns: A #gboolean
205 *
206 * Deprecated: 2.14: Use webkit_dom_html_input_element_get_capture_type() instead.
207 */
208WEBKIT_DEPRECATED_FOR(webkit_dom_html_input_element_get_capture_type) gboolean
209webkit_dom_html_input_element_get_capture(WebKitDOMHTMLInputElement* self);
210
211/**
212 * webkit_dom_html_document_get_design_mode:
213 * @self: A #WebKitDOMHTMLDocument
214 *
215 * Returns: A #gchar
216 *
217 * Deprecated: 2.14: Use webkit_dom_document_get_design_mode() instead.
218 */
219WEBKIT_DEPRECATED_FOR(webkit_dom_document_get_design_mode) gchar*
220webkit_dom_html_document_get_design_mode(WebKitDOMHTMLDocument* self);
221
222/**
223 * webkit_dom_html_document_set_design_mode:
224 * @self: A #WebKitDOMHTMLDocument
225 * @value: A #gchar
226 *
227 * Deprecated: 2.14: Use webkit_dom_document_set_design_mode() instead.
228 */
229WEBKIT_DEPRECATED_FOR(webkit_dom_document_set_design_mode) void
230webkit_dom_html_document_set_design_mode(WebKitDOMHTMLDocument* self, const gchar* value);
231
232/**
233 * webkit_dom_html_document_get_compat_mode:
234 * @self: A #WebKitDOMHTMLDocument
235 *
236 * Returns: A #gchar
237 *
238 * Deprecated: 2.14: Use webkit_dom_document_get_compat_mode() instead.
239 */
240WEBKIT_DEPRECATED_FOR(webkit_dom_document_get_compat_mode) gchar*
241webkit_dom_html_document_get_compat_mode(WebKitDOMHTMLDocument* self);
242
243/**
244 * webkit_dom_html_document_get_embeds:
245 * @self: A #WebKitDOMHTMLDocument
246 *
247 * Returns: (transfer full): A #WebKitDOMHTMLCollection
248 *
249 * Deprecated: 2.14: Use webkit_dom_document_get_embeds() instead.
250 */
251WEBKIT_DEPRECATED_FOR(webkit_dom_document_get_embeds) WebKitDOMHTMLCollection*
252webkit_dom_html_document_get_embeds(WebKitDOMHTMLDocument* self);
253
254/**
255 * webkit_dom_html_document_get_plugins:
256 * @self: A #WebKitDOMHTMLDocument
257 *
258 * Returns: (transfer full): A #WebKitDOMHTMLCollection
259 *
260 * Deprecated: 2.14: Use webkit_dom_document_get_plugins() instead.
261 */
262WEBKIT_DEPRECATED_FOR(webkit_dom_document_get_plugins) WebKitDOMHTMLCollection*
263webkit_dom_html_document_get_plugins(WebKitDOMHTMLDocument* self);
264
265/**
266 * webkit_dom_html_document_get_scripts:
267 * @self: A #WebKitDOMHTMLDocument
268 *
269 * Returns: (transfer full): A #WebKitDOMHTMLCollection
270 *
271 * Deprecated: 2.14: Use webkit_dom_document_get_scripts() instead.
272 */
273WEBKIT_DEPRECATED_FOR(webkit_dom_document_get_scripts) WebKitDOMHTMLCollection*
274webkit_dom_html_document_get_scripts(WebKitDOMHTMLDocument* self);
275
276/**
277 * webkit_dom_node_get_namespace_uri:
278 * @self: A #WebKitDOMNode
279 *
280 * Returns: A #gchar
281 *
282 * Deprecated: 2.14: Use webkit_dom_attr_get_namespace_uri() or webkit_dom_element_get_namespace_uri() instead.
283 */
284WEBKIT_DEPRECATED gchar*
285webkit_dom_node_get_namespace_uri(WebKitDOMNode* self);
286
287/**
288 * webkit_dom_node_get_prefix:
289 * @self: A #WebKitDOMNode
290 *
291 * Returns: A #gchar
292 *
293 * Deprecated: 2.14: Use webkit_dom_attr_get_prefix() or webkit_dom_element_get_prefix() instead.
294 */
295WEBKIT_DEPRECATED gchar*
296webkit_dom_node_get_prefix(WebKitDOMNode* self);
297
298/**
299 * webkit_dom_node_set_prefix:
300 * @self: A #WebKitDOMNode
301 * @value: A #gchar
302 * @error: #GError
303 *
304 * Deprecated: 2.14
305 */
306WEBKIT_DEPRECATED void
307webkit_dom_node_set_prefix(WebKitDOMNode* self, const gchar* value, GError** error);
308
309/**
310 * webkit_dom_node_get_local_name:
311 * @self: A #WebKitDOMNode
312 *
313 * Returns: A #gchar
314 *
315 * Deprecated: 2.14: Use webkit_dom_attr_get_local_name() or webkit_dom_element_get_local_name() instead.
316 */
317WEBKIT_DEPRECATED gchar*
318webkit_dom_node_get_local_name(WebKitDOMNode* self);
319
320#define WEBKIT_DOM_TYPE_ENTITY_REFERENCE (webkit_dom_entity_reference_get_type())
321#define WEBKIT_DOM_ENTITY_REFERENCE(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), WEBKIT_DOM_TYPE_ENTITY_REFERENCE, WebKitDOMEntityReference))
322#define WEBKIT_DOM_ENTITY_REFERENCE_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass), WEBKIT_DOM_TYPE_ENTITY_REFERENCE, WebKitDOMEntityReferenceClass)
323#define WEBKIT_DOM_IS_ENTITY_REFERENCE(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), WEBKIT_DOM_TYPE_ENTITY_REFERENCE))
324#define WEBKIT_DOM_IS_ENTITY_REFERENCE_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), WEBKIT_DOM_TYPE_ENTITY_REFERENCE))
325#define WEBKIT_DOM_ENTITY_REFERENCE_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj), WEBKIT_DOM_TYPE_ENTITY_REFERENCE, WebKitDOMEntityReferenceClass))
326
327typedef struct _WebKitDOMEntityReference WebKitDOMEntityReference;
328typedef struct _WebKitDOMEntityReferenceClass WebKitDOMEntityReferenceClass;
329
330struct _WebKitDOMEntityReference {
331 WebKitDOMNode parent_instance;
332};
333
334struct _WebKitDOMEntityReferenceClass {
335 WebKitDOMNodeClass parent_class;
336};
337
338WEBKIT_DEPRECATED GType webkit_dom_entity_reference_get_type(void);
339
340/**
341 * webkit_dom_node_iterator_get_expand_entity_references:
342 * @self: A #WebKitDOMNodeIterator
343 *
344 * This function has been removed from the DOM spec and it just returns %FALSE.
345 *
346 * Returns: A #gboolean *
347 * Deprecated: 2.12
348 */
349WEBKIT_DEPRECATED gboolean webkit_dom_node_iterator_get_expand_entity_references(WebKitDOMNodeIterator* self);
350
351/**
352 * webkit_dom_tree_walker_get_expand_entity_references:
353 * @self: A #WebKitDOMTreeWalker
354 *
355 * This function has been removed from the DOM spec and it just returns %FALSE.
356 *
357 * Returns: A #gboolean
358 *
359 * Deprecated: 2.12
360 */
361WEBKIT_DEPRECATED gboolean webkit_dom_tree_walker_get_expand_entity_references(WebKitDOMTreeWalker* self);
362
363/**
364 * webkit_dom_document_create_entity_reference:
365 * @self: A #WebKitDOMDocument
366 * @name: (allow-none): A #gchar
367 * @error: #GError
368 *
369 * This function has been removed from the DOM spec and it just returns %NULL.
370 *
371 * Returns: (transfer none): A #WebKitDOMEntityReference
372 *
373 * Deprecated: 2.12
374 */
375WEBKIT_DEPRECATED WebKitDOMEntityReference* webkit_dom_document_create_entity_reference(WebKitDOMDocument* self, const gchar* name, GError** error);
376
377#define WEBKIT_DOM_TYPE_HTML_BASE_FONT_ELEMENT (webkit_dom_html_base_font_element_get_type())
378#define WEBKIT_DOM_HTML_BASE_FONT_ELEMENT(obj) (G_TYPE_CHECK_INSTANCE_CAST((obj), WEBKIT_DOM_TYPE_HTML_BASE_FONT_ELEMENT, WebKitDOMHTMLBaseFontElement))
379#define WEBKIT_DOM_HTML_BASE_FONT_ELEMENT_CLASS(klass) (G_TYPE_CHECK_CLASS_CAST((klass), WEBKIT_DOM_TYPE_HTML_BASE_FONT_ELEMENT, WebKitDOMHTMLBaseFontElementClass)
380#define WEBKIT_DOM_IS_HTML_BASE_FONT_ELEMENT(obj) (G_TYPE_CHECK_INSTANCE_TYPE((obj), WEBKIT_DOM_TYPE_HTML_BASE_FONT_ELEMENT))
381#define WEBKIT_DOM_IS_HTML_BASE_FONT_ELEMENT_CLASS(klass) (G_TYPE_CHECK_CLASS_TYPE((klass), WEBKIT_DOM_TYPE_HTML_BASE_FONT_ELEMENT))
382#define WEBKIT_DOM_HTML_BASE_FONT_ELEMENT_GET_CLASS(obj) (G_TYPE_INSTANCE_GET_CLASS((obj), WEBKIT_DOM_TYPE_HTML_BASE_FONT_ELEMENT, WebKitDOMHTMLBaseFontElementClass))
383
384typedef struct _WebKitDOMHTMLBaseFontElement WebKitDOMHTMLBaseFontElement;
385typedef struct _WebKitDOMHTMLBaseFontElementClass WebKitDOMHTMLBaseFontElementClass;
386
387struct _WebKitDOMHTMLBaseFontElement {
388 WebKitDOMHTMLElement parent_instance;
389};
390
391struct _WebKitDOMHTMLBaseFontElementClass {
392 WebKitDOMHTMLElementClass parent_class;
393};
394
395WEBKIT_DEPRECATED GType
396webkit_dom_html_base_font_element_get_type(void);
397
398/**
399 * webkit_dom_html_base_font_element_get_color:
400 * @self: A #WebKitDOMHTMLBaseFontElement
401 *
402 * This function has been removed from the DOM spec and it just returns %NULL.
403 *
404 * Returns: A #gchar
405 *
406 * Deprecated: 2.12
407 */
408WEBKIT_DEPRECATED gchar*
409webkit_dom_html_base_font_element_get_color(WebKitDOMHTMLBaseFontElement* self);
410
411/**
412 * webkit_dom_html_base_font_element_set_color:
413 * @self: A #WebKitDOMHTMLBaseFontElement
414 * @value: A #gchar
415 *
416 * This function has been removed from the DOM spec and it does nothing.
417 *
418 * Deprecated: 2.12
419 */
420WEBKIT_DEPRECATED void
421webkit_dom_html_base_font_element_set_color(WebKitDOMHTMLBaseFontElement* self, const gchar* value);
422
423/**
424 * webkit_dom_html_base_font_element_get_face:
425 * @self: A #WebKitDOMHTMLBaseFontElement
426 *
427 * This function has been removed from the DOM spec and it just returns %NULL.
428 *
429 * Returns: A #gchar
430 *
431 * Deprecated: 2.12
432 */
433WEBKIT_DEPRECATED gchar*
434webkit_dom_html_base_font_element_get_face(WebKitDOMHTMLBaseFontElement* self);
435
436/**
437 * webkit_dom_html_base_font_element_set_face:
438 * @self: A #WebKitDOMHTMLBaseFontElement
439 * @value: A #gchar
440 *
441 * This function has been removed from the DOM spec and it does nothing.
442 *
443 * Deprecated: 2.12
444 */
445WEBKIT_DEPRECATED void
446webkit_dom_html_base_font_element_set_face(WebKitDOMHTMLBaseFontElement* self, const gchar* value);
447
448/**
449 * webkit_dom_html_base_font_element_get_size:
450 * @self: A #WebKitDOMHTMLBaseFontElement
451 *
452 * This function has been removed from the DOM spec and it just returns 0.
453 *
454 * Returns: A #glong
455 *
456 * Deprecated: 2.12
457 */
458WEBKIT_DEPRECATED glong
459webkit_dom_html_base_font_element_get_size(WebKitDOMHTMLBaseFontElement* self);
460
461/**
462 * webkit_dom_html_base_font_element_set_size:
463 * @self: A #WebKitDOMHTMLBaseFontElement
464 * @value: A #glong
465 *
466 * This function has been removed from the DOM spec and it does nothing.
467 *
468 * Deprecated: 2.12
469 */
470WEBKIT_DEPRECATED void
471webkit_dom_html_base_font_element_set_size(WebKitDOMHTMLBaseFontElement* self, glong value);
472
473/**
474 * webkit_dom_element_get_webkit_region_overset:
475 * @self: A #WebKitDOMElement
476 *
477 * CSS Regions support has been removed. This function does nothing.
478 *
479 * Returns: %NULL
480 *
481 * Deprecated: 2.20
482**/
483WEBKIT_DEPRECATED gchar*
484webkit_dom_element_get_webkit_region_overset(WebKitDOMElement* self);
485
486G_END_DECLS
487
488#endif /* WEBKIT_DISABLE_DEPRECATED */
489
490#endif
491