.. include:: /Includes.rst.txt
.. _htmlparser-tags:
HTMLparser\_tags
^^^^^^^^^^^^^^^^
.. ### BEGIN~OF~TABLE ###
.. container:: table-row
Property
overrideAttribs
Data type
string
Description
If set, this string is preset as the attributes of the tag.
.. container:: table-row
Property
allowedAttribs
Data type
mixed
Description
Defines the allowed attributes.
Possible values:
**0** (zero): No attributes allowed.
**(comma-separated list of attributes):** Only attributes in this
list are allowed.
**(blank/not set):** All attributes are allowed.
.. container:: table-row
Property
fixAttrib.[attribute].set
Data type
string
Description
Force the attribute value to this value.
.. container:: table-row
Property
fixAttrib.[attribute].unset
Data type
boolean
Description
If set, the attribute is unset.
.. container:: table-row
Property
fixAttrib.[attribute].default
Data type
string
Description
If no attribute exists by this name, this value is set as default
value (if this value is not blank)
.. container:: table-row
Property
fixAttrib.[attribute].always
Data type
boolean
Description
If set, the attribute is always processed. Normally an attribute is
processed only if it exists
.. container:: table-row
Property
fixAttrib.[attribute].trim
fixAttrib.[attribute].intval
fixAttrib.[attribute].upper
fixAttrib.[attribute].lower
Data type
boolean
Description
If any of these keys are set, the value is passed through the
respective PHP-functions.
.. container:: table-row
Property
fixAttrib.[attribute].range
Data type
[low],[high]
Description
Setting integer range.
.. container:: table-row
Property
fixAttrib.[attribute].list
Data type
list of values, trimmed
Description
Attribute value must be in this list. If not, the value is set to the
first element.
.. container:: table-row
Property
fixAttrib.[attribute].removeIfFalse
Data type
boolean/"blank" string
Description
If set, then the attribute is removed if it is "false". If this value
is set to "blank" then the value must be a blank string (that means a
"zero" value will not be removed)
.. container:: table-row
Property
fixAttrib.[attribute].removeIfEquals
Data type
string
Description
If the attribute value matches the value set here, then it is removed.
.. container:: table-row
Property
fixAttrib.[attribute].casesensitiveComp
Data type
boolean
Description
If set, the comparison in .removeIfEquals and .list will be case-
sensitive. At this point, it's insensitive.
.. container:: table-row
Property
fixAttrib.[attribute].prefixLocalAnchors
Data type
integer
Description
If the first char is a "#" character (anchor of fx. tags) this
will prefix either a relative or absolute path.
If the value is "1" you will get the absolute path
(TYPO3\CMS\Core\Utility\GeneralUtility::getIndpEnv('TYPO3\_REQUEST\_URL')).
If the value is "2" you will get the relative path (stripping of
TYPO3\CMS\Core\Utility\GeneralUtility::getIndpEnv('TYPO3\_SITE\_URL')).
**Example:** ::
...fixAttrib.href.prefixLocalAnchors = 1
.. container:: table-row
Property
fixAttrib.[attribute].prefixRelPathWith
Data type
string
Description
If the value of the attribute seems to be a relative URL (no scheme
like "http" and no "/" as first char) then the value of this property
will be prefixed the attribute.
**Example:**
...fixAttrib.src.prefixRelPathWith =
https://example.org/typo3/32/dummy/
.. container:: table-row
Property
fixAttrib.[attribute].userFunc
Data type
function reference
Description
User function for processing of the attribute. The return value
of this function will be used as the new tag value.
**Example:**
...fixAttrib.href.userFunc = tx\_realurl->test\_urlProc
Two parameters are passed to the function:
1. The tag value as a string or an array containing the tag value
and additional configuration (see below).
2. The reference the to HtmlParser instance that calls the method.
By default the first parameter is the value of the processed tag.
This changes when you pass additional configuration options to the
user function:
...fixAttrib.href.userFunc.myCustomParm = myCustomValue
In that case the first parameter passed to the user function will
be an array containing these values:
- attributeValue: The original value of the processed attribute
- myCustomParm: myCustomValue
.. container:: table-row
Property
protect
Data type
boolean
Description
If set, the tag <> is converted to < and >
.. container:: table-row
Property
remap
Data type
string
Description
If set, the tagname is remapped to this tagname
.. container:: table-row
Property
rmTagIfNoAttrib
Data type
boolean
Description
If set, then the tag is removed if no attributes happened to be there.
.. container:: table-row
Property
nesting
Data type
mixed
Description
If set true, then this tag must have starting and ending tags in the
correct order. Any tags not in this order will be discarded. Thus
'' will be converted to ''.
Is the value "global" then true nesting in relation to other tags
marked for "global" nesting control is preserved. This means that if
and are set for global nesting then this string
'' is converted to ''
.. ###### END~OF~TABLE ######
[page:->HTMLparser\_tags; tsref:->HTMLparser\_tags]