public function getElementsById($id, $tags = '*')
{
// what are we doing?
$tag = $this->convertTagsToString($tags);
$log = usingLog()->startAction("get '{$tag}' elements with id '{$id}'");
// prepare the list of tags
if (is_string($tags)) {
$tags = array($tags);
}
// build up the xpath to use
$xpathList = array();
foreach ($tags as $tag) {
$xpathList[] = 'descendant::' . $tag . '[@id = "' . $id . '"]';
}
// find the matches
$elements = $this->getElementsByXpath($xpathList);
// log the result
$log->endAction(count($elements) . " element(s) found");
// return the elements
return $elements;
}