element.go

package goDom

type (
	attributes map[string]string
	classList  []string
	children   []*Element
	// DOM element with fields and element's DOM API.
	Element struct {
		TagName                string     // https://developer.mozilla.org/en-US/docs/Web/API/Element/tagName
		TextContent            string     // https://developer.mozilla.org/en-US/docs/Web/API/Node/textContent
		Attributes             attributes // https://developer.mozilla.org/en-US/docs/Web/API/Element/attributes
		Children               children   // https://developer.mozilla.org/en-US/docs/Web/API/Element/children
		ClassName              string     // https://developer.mozilla.org/en-US/docs/Web/API/Element/className
		ClassList              classList  // https://developer.mozilla.org/en-US/docs/Web/API/Element/classList
		Id                     string     // https://developer.mozilla.org/en-US/docs/Web/API/Element/id
		ParentElement          *Element   // https://developer.mozilla.org/en-US/docs/Web/API/Node/parentElement
		NextElementSibling     *Element   // https://developer.mozilla.org/en-US/docs/Web/API/Element/nextElementSibling
		PreviousElementSibling *Element   // https://developer.mozilla.org/en-US/docs/Web/API/Element/previousElementSibling
		domAPI
	}
)

// Get HTML attribute.
// https://developer.mozilla.org/en-US/docs/Web/API/Element/getAttribute
//
// Examples:
//
//	hrefAttr, err := yourElement.GetAttribute("href") // existed attribute value or err if not
func (e *Element) GetAttribute(attr string) (string, error) {
	if val, ok := e.Attributes[attr]; ok {
		return val, nil
	}

	return "", notFoundErr{Params: attr, Msg: "Attribute not found."}
}

// Element has HTML attribute.
// https://developer.mozilla.org/en-US/docs/Web/API/Element/hasAttribute
//
// Examples:
//
//	hasHrefAttr := yourElement.HasAttribute("href") // true if attribute existed
func (e *Element) HasAttribute(attr string) bool {
	_, err := e.GetAttribute(attr)

	return err == nil
}

// Find element by query selector inside element. Exactly as yourElement.querySelector() in browser DOM.
// https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelector
//
// Examples:
//
//	element, err := yourElement.QuerySelector("div#lal .lol") // get element inside another element. err if not found
func (e *Element) QuerySelector(queryStr string) (*Element, error) {
	return e.querySelector(queryStr, e)
}

// Find elements by query selector inside element. Exactly as yourElement.querySelectorAll() in browser DOM.
// https://developer.mozilla.org/en-US/docs/Web/API/Document/querySelectorAll
//
// Examples:
//
//	elements, err := yourElement.QuerySelector("#my_lol .lolipop") // get elements inside another element. err if not found
func (e *Element) QuerySelectorAll(queryStr string) ([]*Element, error) {
	return e.querySelectorAll(queryStr, e)
}

// Find element by id inside element. Exactly as yourElement.getElementById() in browser DOM.
// https://developer.mozilla.org/en-US/docs/Web/API/Document/getElementById
//
// Examples:
//
//	element, err := yourElement.GetElementById("piu") // get elements inside another element. err if not found
func (e *Element) GetElementById(id string) (*Element, error) {
	return e.getElementById(id, e)
}

// Find elements by CSS class name inside element. Exactly as yourElement.getElementsByClassName() in browser DOM.
// https://developer.mozilla.org/en-US/docs/Web/API/Document/getElementsByClassName
//
// Examples:
//
//	elements, err := yourElement.GetElementsByClassName(".lolipop") // get elements inside another element. err if not found
func (e *Element) GetElementsByClassName(class string) ([]*Element, error) {
	return e.getElementsByClassName(class, e)
}

// Find elements by tag name inside element. Exactly as yourElement.getElementsByTagName() in browser DOM.
// https://developer.mozilla.org/en-US/docs/Web/API/Element/getElementsByTagName
//
// Examples:
//
//	elements, err := yourElement.GetElementsByTagName("li") // get elements inside another element. err if not found
func (e *Element) GetElementsByTagName(tag string) ([]*Element, error) {
	return e.getElementsByTagName(tag, e)
}

// If DOM element contains inside itself another DOM element.
// https://developer.mozilla.org/en-US/docs/Web/API/Node/contains
//
// Examples:
//
//	parent, _ := document.QuerySelector(".pups")
//	child, _ := document.GetElementById("wee")
//	contains := parent.Contains(child) // true if parent contains inside itself child
func (e *Element) Contains(el *Element) bool {
	return e.contains(e, el)
}