iska
b693a60358
Do not allocate empty collections for child nodes or attributes when initializing new HTML Nodes or Elements. These are initialized the first time they are accessed. Analogously, the mutable data string of CharacterData is also allocated with the empty string on first access.
124 lines
3.0 KiB
Objective-C
124 lines
3.0 KiB
Objective-C
//
|
|
// HTMLElement.h
|
|
// HTMLKit
|
|
//
|
|
// Created by Iska on 05/10/14.
|
|
// Copyright (c) 2014 BrainCookie. All rights reserved.
|
|
//
|
|
|
|
#import <Foundation/Foundation.h>
|
|
#import "HTMLNamespaces.h"
|
|
#import "HTMLNode.h"
|
|
#import "HTMLDOMTokenList.h"
|
|
|
|
NS_ASSUME_NONNULL_BEGIN
|
|
|
|
/**
|
|
A HTML Element.
|
|
|
|
https://html.spec.whatwg.org/multipage/dom.html#elements
|
|
https://html.spec.whatwg.org/multipage/syntax.html#elements-2
|
|
*/
|
|
@interface HTMLElement : HTMLNode
|
|
|
|
/**
|
|
The namesapce of this element.
|
|
|
|
@see HTMLNamespace
|
|
*/
|
|
@property (nonatomic, assign, readonly) HTMLNamespace htmlNamespace;
|
|
|
|
/**
|
|
The elemen's tag name.
|
|
*/
|
|
@property (nonatomic, copy, readonly) NSString *tagName;
|
|
|
|
/**
|
|
The elemen's id attribute value. Empty string if the element has no id attribute.
|
|
*/
|
|
@property (nonatomic, copy) NSString *elementId;
|
|
|
|
/**
|
|
The elemen's class attribute value. Empty string if the element has no class attribute.
|
|
*/
|
|
@property (nonatomic, copy) NSString *className;
|
|
|
|
/**
|
|
The element's class attribute as a DOM Token List
|
|
|
|
@see HTMLDOMTokenList
|
|
*/
|
|
@property (nonatomic, strong, readonly) HTMLDOMTokenList *classList;
|
|
|
|
/**
|
|
The element's attribites.
|
|
*/
|
|
@property (nonatomic, strong) NSMutableDictionary<NSString *, NSString *> *attributes;
|
|
|
|
/**
|
|
@warning Use one of the initWithTagName: methods instead.
|
|
*/
|
|
- (instancetype)init NS_UNAVAILABLE;
|
|
|
|
/**
|
|
Initializes a new HTML element with the given tag name.
|
|
|
|
@param tagname The tag name.
|
|
@return A new HTML element.
|
|
*/
|
|
- (instancetype)initWithTagName:(NSString *)tagName;
|
|
|
|
/**
|
|
Initializes a new HTML element with the given tag name and attributes.
|
|
|
|
@param tagname The tag name.
|
|
@param attributes The attributes.
|
|
@return A new HTML element.
|
|
*/
|
|
- (instancetype)initWithTagName:(NSString *)tagName attributes:(nullable NSDictionary<NSString *, NSString *> *)attributes;
|
|
|
|
/**
|
|
Initializes a new HTML element with the given tag name, namespace, and attributes.
|
|
|
|
@param tagname The tag name.
|
|
@param namespace The namespace.
|
|
@param attributes The attributes.
|
|
@return A new HTML element.
|
|
*/
|
|
- (instancetype)initWithTagName:(NSString *)tagName namespace:(HTMLNamespace)htmlNamespace attributes:(nullable NSDictionary<NSString *, NSString *> *)attributes;
|
|
|
|
/**
|
|
Checks whether this element has an attribute with the given name.
|
|
|
|
@param name The attribute name.
|
|
@return `YES` if the element has such an attributes, `NO` otherwise.
|
|
*/
|
|
- (BOOL)hasAttribute:(NSString *)name;
|
|
|
|
/**
|
|
Returns the value of the attribute with the given name.
|
|
|
|
@param name The attribute's name.
|
|
@return The attribute's value, `nil` if the element doesn't have such attribute.
|
|
*/
|
|
- (nullable NSString *)objectForKeyedSubscript:(NSString *)name;
|
|
|
|
/**
|
|
Set the value of the attribute with the given name.
|
|
|
|
@param value The value to set.
|
|
@param name The attribute's name.
|
|
*/
|
|
- (void)setObject:(NSString *)value forKeyedSubscript:(NSString *)attribute;
|
|
|
|
/**
|
|
Removes the attribute with the given name.
|
|
|
|
@param name The attribute to remove.
|
|
*/
|
|
- (void)removeAttribute:(NSString *)name;
|
|
|
|
@end
|
|
|
|
NS_ASSUME_NONNULL_END
|