HTML::Microformats::DocumentContext3pm

Constructor

"$context = HTML::Microformats::DocumentContext->new($dom, $baseuri)"

Creates a new context from a DOM document and a base URI.

$dom will be modified, so if you care about keeping it pristine, make a clone first.

Public Methods

"$context->cache"

A Microformat cache for the context. This prevents the same microformat object from being parsed and reparsed - e.g. an adr parsed first in its own right, and later as a child of an hCard.

"$context->document"

Return the modified DOM document.

"$context->uri( [$relative_reference] )"

Called without a parameter, returns the context's base URI.

Called with a parameter, resolves the URI reference relative to the base URI.

"$context->document_uri"

Returns a URI representing the document itself. (Usually the same as the base URI.)

"$context->make_bnode( [$element] )"

Mint a blank node identifier or a URI.

If an element is passed, this may be used to construct a URI in some way.

"$context->profiles"

A list of profile URIs declared by the document.

"$context->has_profile(@profiles)"

Returns true iff any of the profiles in the array are declared by the document.

"$context->add_profile(@profiles)"

Declare these additional profiles.

"$context->representative_hcard"

Returns the hCard for the person that is "represented by" the page (in the XFN sense), or undef if no suitable hCard could be found

"$context->representative_person_id( [$as_trine] )"

Equivalent to calling "$context->representative_hcard->id($as_trine, 'holder')", however magically works even if $context->representative_hcard returns undef.

"$context->contact_hcard"

Returns the hCard for the contact person for the page, or undef if none can be found.

hCards are considered potential contact hCards if they are contained within an HTML <address> tag, or their root element is an <address> tag. If there are several such hCards, then the one in the shallowest <address> tag is used; if there are several <address> tags equally shallow, the first is used.

"$context->contact_person_id( [$as_trine] )"

Equivalent to calling "$context->contact_hcard->id($as_trine, 'holder')", however magically works even if $context->contact_hcard returns undef.