API - XOOPS 2.5.11 Beta 2
By monxoops.fr
HTMLPurifier_ChildDef_Table Class Reference
Inheritance diagram for HTMLPurifier_ChildDef_Table:
Collaboration diagram for HTMLPurifier_ChildDef_Table:

Public Member Functions

 __construct ()
 
 validateChildren ($children, $config, $context)
 
- Public Member Functions inherited from HTMLPurifier_ChildDef
 getAllowedElements ($config)
 
 validateChildren ($children, $config, $context)
 

Data Fields

 $allow_empty = false
 
 $type = 'table'
 
 $elements
 
- Data Fields inherited from HTMLPurifier_ChildDef
 $type
 
 $allow_empty
 
 $elements = array()
 

Detailed Description

Definition for tables. The general idea is to extract out all of the essential bits, and then reconstruct it later.

This is a bit confusing, because the DTDs and the W3C validators seem to disagree on the appropriate definition. The DTD claims:

 (CAPTION?, (COL*|COLGROUP*), THEAD?, TFOOT?, TBODY+)

But actually, the HTML4 spec then has this to say:

 The TBODY start tag is always required except when the table
 contains only one table body and no table head or foot sections.
 The TBODY end tag may always be safely omitted.

So the DTD is kind of wrong. The validator is, unfortunately, kind of on crack.

The definition changed again in XHTML1.1; and in my opinion, this formulation makes the most sense.

 caption?, ( col* | colgroup* ), (( thead?, tfoot?, tbody+ ) | ( tr+ ))

Essentially, we have two modes: thead/tfoot/tbody mode, and tr mode. If we encounter a thead, tfoot or tbody, we are placed in the former mode, and we must wrap any stray tr segments with a tbody. But if we don't run into any of them, just have tr tags is OK.

Constructor & Destructor Documentation

◆ __construct()

__construct ( )

Member Function Documentation

◆ validateChildren()

validateChildren (   $children,
  $config,
  $context 
)
Parameters
array$children
HTMLPurifier_Config$config
HTMLPurifier_Context$context
Returns
array

Reimplemented from HTMLPurifier_ChildDef.

Field Documentation

◆ $allow_empty

$allow_empty = false

@type bool

◆ $elements

$elements
Initial value:
= array(
'tr' => true,
'tbody' => true,
'thead' => true,
'tfoot' => true,
'caption' => true,
'colgroup' => true,
'col' => true
)

@type array

◆ $type

$type = 'table'

@type string


The documentation for this class was generated from the following file: