textcontent-parsing - Revision history

GRegorLove: /* Element to string */ s/value/child/

2018-08-28T01:40:18Z

Element to string: s/value/child/

← Older revision		Revision as of 01:40, 28 August 2018
Line 42:		Line 42:
	#*** Append a string containing a single <code>U+000A LF</code> code point to '''<var>output</var>'''		#*** Append a string containing a single <code>U+000A LF</code> code point to '''<var>output</var>'''
	#** <code>P</code>		#** <code>P</code>
	#**# Let '''<var>value</var>''' be the result of running [[#Element_to_string\|this algorithm]] on '''<var>~~value~~</var>'''		#**# Let '''<var>value</var>''' be the result of running [[#Element_to_string\|this algorithm]] on '''<var>child</var>'''
	#**# Prepend a single <code>U+000A LF</code> code point to '''<var>value</var>'''		#**# Prepend a single <code>U+000A LF</code> code point to '''<var>value</var>'''
	#**# Append '''<var>value</var>''' to '''<var>output</var>'''		#**# Append '''<var>value</var>''' to '''<var>output</var>'''

GRegorLove: /* Element to string */ formatting fix

2018-08-27T20:43:50Z

Element to string: formatting fix

← Older revision		Revision as of 20:43, 27 August 2018
Line 40:		Line 40:
	#**# Append '''<var>value</var>''' to '''<var>output</var>'''		#**# Append '''<var>value</var>''' to '''<var>output</var>'''
	#** <code>BR</code>		#** <code>BR</code>
	#*** Append a string containing a single <code>U+000A L</code>F code point to '''<var>output</var>'''		#*** Append a string containing a single <code>U+000A LF</code> code point to '''<var>output</var>'''
	#** <code>P</code>		#** <code>P</code>
	#**# Let '''<var>value</var>''' be the result of running [[#Element_to_string\|this algorithm]] on '''<var>value</var>'''		#**# Let '''<var>value</var>''' be the result of running [[#Element_to_string\|this algorithm]] on '''<var>value</var>'''

GRegorLove: /* whitespace in pre elements */ s/newlines/whitespace/

2018-08-27T20:34:17Z

whitespace in pre elements: s/newlines/whitespace/

← Older revision		Revision as of 20:34, 27 August 2018
Line 61:		Line 61:

	=== whitespace in pre elements ===		=== whitespace in pre elements ===
	This algorithm doesn't currently preserve ~~newlines~~ in <code>pre</code> elements. There's some agreement in [https://github.com/microformats/microformats2-parsing/issues/15#issuecomment-407707386 this issue] that it ''should'' be preserved and mf2py currently does that.		This algorithm doesn't currently preserve whitespace in <code>pre</code> elements. There's some agreement in [https://github.com/microformats/microformats2-parsing/issues/15#issuecomment-407707386 this issue] that it ''should'' be preserved and mf2py currently does that.

	=== add a new topic ===		=== add a new topic ===

GRegorLove: /* Brainstorming */ === whitespace in pre elements ===

2018-08-27T20:32:46Z

Brainstorming: === whitespace in pre elements ===

← Older revision		Revision as of 20:32, 27 August 2018
Line 60:		Line 60:
	Discuss issues and improvements to the algorithm here.		Discuss issues and improvements to the algorithm here.

	* ...		=== whitespace in pre elements ===
			This algorithm doesn't currently preserve newlines in <code>pre</code> elements. There's some agreement in [https://github.com/microformats/microformats2-parsing/issues/15#issuecomment-407707386 this issue] that it ''should'' be preserved and mf2py currently does that.

			=== add a new topic ===

	== References ==		== References ==

GRegorLove: /* Implementations */ +php-mf2

2018-08-27T20:21:04Z

Implementations: +php-mf2

← Older revision		Revision as of 20:21, 27 August 2018
Line 54:		Line 54:
	List parsers that have implemented this algorithm. Note any differences as this specification evolves.		List parsers that have implemented this algorithm. Note any differences as this specification evolves.

			* '''php-mf2''' implements the [http://microformats.org/wiki/index.php?title=textcontent-parsing&oldid=66933 initial version] of this algorithm as of [https://github.com/microformats/php-mf2/tree/v0.4.4 v0.4.4]
	* ...		* ...

GRegorLove: New page: This is a '''draft''' specification for parsing `textContent` based on Martijn van der Ven's algorithm. [https://wiki.zegnat.net/media/textparsing.html] == Stat...

2018-08-27T20:17:19Z

New page: This is a '''draft''' specification for parsing <code>textContent</code> based on Martijn van der Ven's algorithm. [https://wiki.zegnat.net/media/textparsing.html] == Stat...

New page

This is a '''draft''' specification for parsing <code>textContent</code> based on [[User:Zegnat|Martijn van der Ven]]'s algorithm. [https://wiki.zegnat.net/media/textparsing.html]

== Status ==
This is a draft specification.

== Algorithm ==
=== Plain text of element ===
To get the plain text for an [https://dom.spec.whatwg.org/#interface-element Element] '''<var>input</var>''':

# Let '''<var>output</var>''' be the result of running [[#Element_to_string|Element to string]] on '''<var>input</var>'''
# Remove any sequence of one or more consecutive <code>U+0020 SPACE</code> [https://infra.spec.whatwg.org/#code-point code points] directly before and after an <code>U+000A LF</code> code point from '''<var>output</var>'''
# [https://infra.spec.whatwg.org/#strip-leading-and-trailing-ascii-whitespace Strip leading and trailing ASCII whitespace] from '''<var>output</var>'''
# Replace any sequence of one or more consecutive <code>U+0020 SPACE</code> code points in '''<var>output</var>''' with a single <code>U+0020 SPACE</code> code point
# Return '''<var>output</var>'''

=== Element to string ===
To get the string value for an [https://dom.spec.whatwg.org/#interface-element Element] '''<var>input</var>''':

# Let '''<var>output</var>''' be an empty [https://infra.spec.whatwg.org/#list list]
# Let '''<var>children</var>''' be the [https://dom.spec.whatwg.org/#concept-tree-child children] of '''<var>input</var>''' in [https://dom.spec.whatwg.org/#concept-tree-order tree order]
# [https://infra.spec.whatwg.org/#list-iterate For each] '''<var>child</var>''' in '''<var>children</var>''':
#* If '''<var>child</var>''' is a [https://dom.spec.whatwg.org/#interface-text Text] node:
#*# Let '''<var>value</var>''' be the [https://dom.spec.whatwg.org/#dom-node-textcontent textContent] of '''<var>child</var>'''
#*# Replace any <code>U+0009 TAB</code>, <code>U+000A LF</code>, and <code>U+000D CR</code> code points in '''<var>value</var>''' with a single <code>U+0020 SPACE</code> code point
#*# [https://infra.spec.whatwg.org/#list-append Append] '''<var>value</var>''' to output
#* If '''<var>child</var>''' is an Element, switch on its [https://dom.spec.whatwg.org/#dom-element-tagname tagName]:
#** <code>SCRIPT</code>
#** <code>STYLE</code>
#*** [https://infra.spec.whatwg.org/#iteration-continue Continue]
#** <code>IMG</code>
#**# If '''<var>child</var>''' has an alt attribute, then:
#**## Let '''<var>value</var>''' be the contents of the alt attribute
#**## Strip leading and trailing ASCII whitespace from '''<var>value</var>'''
#**# Else if '''<var>child</var>''' has a src attribute, then:
#**## Let '''<var>value</var>''' be the contents of the src attribute
#**## Strip leading and trailing ASCII whitespace from '''<var>value</var>'''
#**## Set '''<var>value</var>''' to the absolute URL created by resolving '''<var>value</var>''' following the containing document’s language’s rules
#**# Else continue
#**# Append and prepend a single <code>U+0020 SPACE</code> code point to '''<var>value</var>'''
#**# Append '''<var>value</var>''' to '''<var>output</var>'''
#** <code>BR</code>
#*** Append a string containing a single <code>U+000A L</code>F code point to '''<var>output</var>'''
#** <code>P</code>
#**# Let '''<var>value</var>''' be the result of running [[#Element_to_string|this algorithm]] on '''<var>value</var>'''
#**# Prepend a single <code>U+000A LF</code> code point to '''<var>value</var>'''
#**# Append '''<var>value</var>''' to '''<var>output</var>'''
#** Any other value
#**# Let '''<var>value</var>''' be the result of running [[#Element_to_string|this algorithm]] on '''<var>child</var>'''
#**# Append '''<var>value</var>''' to '''<var>output</var>'''
#* Else continue
# Return the [https://infra.spec.whatwg.org/#string-concatenate concatenation] of '''<var>output</var>'''

== Implementations ==
List parsers that have implemented this algorithm. Note any differences as this specification evolves.

* ...

== Brainstorming ==
Discuss issues and improvements to the algorithm here.

* ...

== References ==
* <dfn>Element</dfn>: https://dom.spec.whatwg.org/#interface-element
* <dfn>Code point</dfn>: https://infra.spec.whatwg.org/#code-point
* <dfn>Strip leading and trailing ASCII whitespace</dfn>: https://infra.spec.whatwg.org/#strip-leading-and-trailing-ascii-whitespace
* <dfn>Children</dfn>: https://dom.spec.whatwg.org/#concept-tree-child
* <dfn>Tree order</dfn>: https://dom.spec.whatwg.org/#concept-tree-order
* <dfn>For each</dfn>: https://infra.spec.whatwg.org/#list-iterate
* <dfn>Text node</dfn>: https://dom.spec.whatwg.org/#interface-text
* <dfn>textContent</dfn>: https://dom.spec.whatwg.org/#dom-node-textcontent
* <dfn>Append</dfn>: https://infra.spec.whatwg.org/#list-append
* <dfn>tagName</dfn>: https://dom.spec.whatwg.org/#dom-element-tagname
* <dfn>Continue</dfn>: https://infra.spec.whatwg.org/#iteration-continue
* <dfn>Concatenation</dfn>: https://infra.spec.whatwg.org/#string-concatenate