2 Dom.Create

boxgaming edited this page 2023-09-25 13:46:55 -05:00

Table of Contents

• Syntax
• Parameters
• Examples
• See Also

Creates a new html element and adds it to the current page.

The function version of this keyword will return an object reference to the DOM element which can be further manipulated or passed in as input to subsequent DOM operations.

Syntax

domElement = Dom.Create (elementName$ [, parent] [, text$] [,elementId$] [, insertBefore])

Dom.Create elementName$ [, parent] [, text$] [,elementId$] [, insertBefore]

Parameters

• The elementName$ parameter indicates the type of html element to be created (i.e. "div", "input", "button").
• The option parent parameter can be either the object returned from a previous Dom.Create method or Dom.Get method or the String id of the parent element. The created element will be appended to the end of the current contents of the parent element (unless the insertBefore parameter is specified).
• The optional text$ parameter will set the inner text content of the created element. For form input elements this will set the element's value attribute.
• The optional elementId$ parameter will set the id attribute of the created element. This id can be referenced by subsequent DOM methods.
• The optional insertBefore parameter can be either the object returned from a previous Dom.Create or Dom.Get method or the String id of a sibling html element. The newly created element will be inserted into the specified parent container element immediately before the indicated insertBefore element.

Examples

Example1: Create a new html BUTTON element inside a DIV panel which will be placed beneath the screen canvas.

Import Dom From "lib/web/dom.bas"

Dim panel, btn
panel = Dom.Create("div")
btn = Dom.Create("button", panel, "Push Me")

See Also

Dom.Add Dom.Container Dom.Event Dom.Get Dom.GetImage Dom.Remove

QBasic Language Support
Supported Keywords
Unsupported Keywords
Samples