mPDF Manual – HTML control tags

indexentry

(mPDF >= 1.0)

indexentry – Insert an Index entry for the document

Description

<indexentry  $content [ $xref ] />

Insert an Index entry for the document Index, referencing the current writing position in the document. If $xref is set, it will appear as a cross-referencing entry in the index as for IndexEntrySee().

Attributes

$content

This attribute sets the text as it will appear in the Index entry. Text should be UTF-8 encoded.

$content cannot contain any of the characters: < > & ‘ or “ and must use the appropriate HTML entities e.g. <indexentry content=”&lt; 40” />

It is recommended that you use htmlspecialchars(‘Content’, ENT_QUOTES) for this.

REQUIRED

$xref

This attribute sets the text used as a cross-reference. Text should be UTF-8 encoded.

$xref cannot contain any of the characters: < > & ‘ or “ and must use the appropriate HTML entities e.g. <indexentry xref=”&lt; 40” />

It is recommended that you use e.g. htmlspecialchars($xref, ENT_QUOTES) for this.

Text entries passed in the form “Subject:Subcategory” will appear in the Index as “Subject, Subcategory”

OPTIONAL

Changelog

VersionDescription
3.0 $xref attribute added.

Examples

Example #1

<?php

$mpdf = new mPDF();

$mpdf->WriteHTML('
Beginning bit of document...
');

$mpdf->WriteHTML('
Your text which refers to a buffalo,<indexentry content="Buffalo" /> which you would like to see in the Index
');

$mpdf->AddPage();

$mpdf->WriteHTML('<h2>Index</h2>',2);

$mpdf->CreateIndex(2, '', '', 3, 1, '', 5, 'serif','sans-serif');

$mpdf=Output();

?>

Example #2

<?php

$mpdf->WriteHTML('
<indexentry content="Dromedary" xref="Camel:types" />The dromedary is atype of camel
');

// This will produce an entry in the Index under 'Dromedary' appearing as:

Dromedary - see Camel, types

Notes

Recommended placement of Index Entries is just after the first word following the opening tag of the block element:

<h2>First<indexentry... /> word of a heading or block</h2>

or alternatively just after the opening tag of the block element:

<h2><indexentry... />Heading or block</h2>

or just after a word to be marked:

... this is a word<indexentry... /> in the middle of text to be marked ...

See Also