Difference between revisions of "lure"

Line 8: Line 8:
 
Although we have a working prototype of the xml/html parser and DOM Object, we do not yet have a working renderer. Given the sheer size of the W3C DOM specification, this area will serve to document and track the current status of DOM Interface implementations.  
 
Although we have a working prototype of the xml/html parser and DOM Object, we do not yet have a working renderer. Given the sheer size of the W3C DOM specification, this area will serve to document and track the current status of DOM Interface implementations.  
  
== LURE DOM Reference ==
+
== LURE Reference ==
  
 +
==== LURE Function Reference ====
 +
 +
{|
 +
! align="left" | Function
 +
! align="left" style="padding-left:10px;" | Description
 +
! align="left" style="padding-left:10px;" | Implemented
 +
|-
 +
| lure.load()
 +
| align="left" style="padding-left:10px;" | Load function to handle loading XML/HTML data from various sources (ex: flatfile)
 +
| align="left" style="padding-left:10px;" | Yes
 +
|-
 +
| lure.save()
 +
| align="left" style="padding-left:10px;" | Saves a LURE DOM Object to flat file
 +
| align="left" style="padding-left:10px;" | No
 +
|-
 +
| lure.update()
 +
| align="left" style="padding-left:10px;" | Update function
 +
| align="left" style="padding-left:10px;" | No
 +
|-
 +
| lure.draw()
 +
| align="left" style="padding-left:10px;" | Draw function to render html to the lure window (if any html exists in the LURE DOM)
 +
| align="left" style="padding-left:10px;" | No
 +
|-
 +
| lure.mousepressed()
 +
| align="left" style="padding-left:10px;" |
 +
| align="left" style="padding-left:10px;" | No
 +
|-
 +
| lure.mousereleased()
 +
| align="left" style="padding-left:10px;" |
 +
| align="left" style="padding-left:10px;" | No
 +
|-
 +
| lure.keypressed()
 +
| align="left" style="padding-left:10px;" |
 +
| align="left" style="padding-left:10px;" | No
 +
|-
 +
| lure.keyreleased()
 +
| align="left" style="padding-left:10px;" |
 +
| align="left" style="padding-left:10px;" | No
 +
|}
 +
 +
==== LURE xml/html DOM Reference ====
 
Objects present in this table are DOM objects currently planned for implementation. Not all W3C DOM objects will be implemented.  
 
Objects present in this table are DOM objects currently planned for implementation. Not all W3C DOM objects will be implemented.  
  

Revision as of 08:07, 3 November 2011

Summary

LURE is an attempt to implement a hybrid xml/html DOM parser and renderer for the Love2d game engine. The goal of LURE is to provide the following:

  • A non-validating xml/html parser which generates a (somewhat) W3C Standards complaint DOM Object for use with love.
  • A html renderer which will display html markup in the love window.

Although we have a working prototype of the xml/html parser and DOM Object, we do not yet have a working renderer. Given the sheer size of the W3C DOM specification, this area will serve to document and track the current status of DOM Interface implementations.

LURE Reference

LURE Function Reference

Function Description Implemented
lure.load() Load function to handle loading XML/HTML data from various sources (ex: flatfile) Yes
lure.save() Saves a LURE DOM Object to flat file No
lure.update() Update function No
lure.draw() Draw function to render html to the lure window (if any html exists in the LURE DOM) No
lure.mousepressed() No
lure.mousereleased() No
lure.keypressed() No
lure.keyreleased() No

LURE xml/html DOM Reference

Objects present in this table are DOM objects currently planned for implementation. Not all W3C DOM objects will be implemented.

Object Description Implemented
DOM Node The Node object represents a single node in the document tree Yes
DOM NodeList The NodeList object represents an ordered list of nodes Yes
DOM NamedNodeMap The NamedNodeMap object represents an unordered list of nodes. Yes
DOM document The Document object represents the entire XML/HTML document. Yes
DOM Element The Element object represents an element in an XML/HTML document Yes
DOM Attribute The Attr object represents an attribute of an Element object. Yes
DOM Text The Text object represents the textual content of an element or attribute. Yes
DOM CDATA The CDATASection object represents a CDATA section in a document. Yes
DOM Comment The Comment object represents the content of comment nodes in a document. Yes
DOM Window The Window object represents Love window No

xml/html Parser Preview

The parser in its current state implements many of the core DOM node objects. Although the library is not yet ready for prototype release, below is an example of the current xml/html parser and some basic use of the resulting DOM Object.

Below is very simple xml/html markup:

<html>
	<head>
		<title>Lure Test Page</title>		
	</head>
	<body>
		<div id="div1">
			this is a sentence<br>separated by a break line.
			<div id="div2">Hello</div>
			<div id="div3">World</div>			
		</div>
	</body>
</html>

And to parse and work with the DOM in LURE:

require("lure.lua")

htmlDoc = Lure.load("test.html")
print(htmlDoc.getElementById("div1").childNodes[1].data)
--OUTPUT: this is a sentence

print(htmlDoc.childNodes[1].childNodes[2].childNodes[1].childNodes[3].data)
--OUTPUT: separated by a break line.

newElement = htmlDoc.createElement("div")
newElement.setAttribute("id", "myNewElement")
htmlDoc.childNodes[1].childNodes[2].appendChild(newElement)
print(htmlDoc.getElementById("myNewElement").getAttribute("id"))
--OUTPUT: myNewElement


MORE TO COME!