1	<?php
2
3	namespace Flow\Parsoid;
4
5	use DOMElement;
6	use Flow\Model\Reference;
7
8	/**
9	* Find and create References for DOM elements within parsoid HTML
10	*/
11	interface Extractor {
12	/**
13	* XPath selector that finds elements to be processed with self::perform
14	*
15	* @return string
16	*/
17	public function getXPath();
18
19	/**
20	* Generate one or no references for a DOMElement found with self::getXPath
21	*
22	* @param ReferenceFactory $factory
23	* @param DOMElement $element
24	* @return Reference|null
25	*/
26	public function perform( ReferenceFactory $factory, DOMElement $element );
27	}