Supported CSS

margin-collapse

Line height as a factor of font-height. Usual values around 1.2 or 1.3

Also accepts px, pc, pt, cm, mm, in, em and % (mPDF ≥ 4.0)

background is parsed as per the CSS specification.

background-image in the form url(image.png) or url('image.png') or GRADIENT (mPDF ≥ 5.1).

background-position is supported as per CSS2.1

background-repeat: repeat | repeat-x | repeat-y | no-repeat

background-attachment is parsed but has no effect.

See note below. (cf. Backgrounds & borders)

(All except background-color added mPDF 3.0)

background-image-resolution

normal | [ from-image <dpi> ]  (mPDF ≥ 5.1)

Custom tag, but as for image-resolution in CSS3

background-gradient

background-image-opacity

Value between 0 and 1.0

Sets the opacity/transparency of the background image.

background-image-resize

0 - No resizing (default)

1 - Shrink-to-fit w (keep aspect ratio)

2 - Shrink-to-fit h (keep aspect ratio)

3 - Shrink-to-fit w and/or h (keep aspect ratio)

4 - Resize-to-fit w (keep aspect ratio)

5 - Resize-to-fit h (keep aspect ratio)

6 - Resize-to-fit w and h

Size style and colour e.g.

LENGTH solid|dotted|dashed|double COLOR

COLOR

(mPDF ≥ 4.0)

LENGTH 

(mPDF ≥ 4.0)

solid | dotted | dashed | double

(mPDF ≥ 4.0)

(double was added mPDF 4.2)

LENGTH

See draft CSS3 specification for use.

NB Use of $autoPadding which can automatically increase padding in block elements with border-radius set as required

LENGTH

mPDF does not support nested block elements which overlap (horizontally or vertically) i.e. the inner block must be contained by the outer block’s physical dimensions. width and height are overridden if this is not the case.

LENGTH 

mPDF does not support nested block elements which overlap (horizontally or vertically) i.e. the inner block must be contained by the outer block’s physical dimensions. width and height are overridden if this is not the case.

(Prior to mPDF v5.1: only supported if whole block is all on one page; will extend a block but not shorten it; will not force a pagebreak even if height should move onto next page.)

NB % is interpreted as % of printable page height (inside margins)

visible | hidden | printonly | screenonly  (mPDF ≥ 5.4)

margin-collapse

Line height as a factor of font-height. Usual values around 1.2 or 1.3

Also accepts px, pc, pt, cm, mm, in, em and % (mPDF ≥ 4.0)

‘normal’ also accepted (set by default to 1.3 in mPDF)

inline-line-height | block-line-height | max-height | grid-height

As per draft CSS3 spec. (mPDF ≥ 6.0)

Default = inline-line-height

consider-shifts | disregard-shifts

As per draft CSS3 spec. (mPDF ≥ 6.0)

Default = consider-shifts

background is parsed as per the CSS specification.

background-image in the form url(image.png) or url('image.png') or GRADIENT (mPDF ≥ 5.1).

background-position is supported as per CSS2.1

background-repeat: repeat | repeat-x | repeat-y | no-repeat

background-attachment is parsed but has no effect.

See note below. (cf. Backgrounds & borders)

(All except background-color added mPDF 3.0)

padding-box | border-box (default=border-box)

extended to include “content-box” from mPDF 5.7

padding-box | content-box | border-box  (default padding-box)

As per CSS3. mPDF ≥ 5.7

[ <length> | <percentage> | auto ]{1,2} | cover | contain  (default = auto)

As per CSS3. mPDF ≥ 5.7

background-image-resolution

normal | [ from-image <dpi> ]  (mPDF ≥ 5.1)

Custom tag, but as for image-resolution in CSS3

background-gradient

background-image-opacity

Value between 0 and 1.0

Sets the opacity/transparency of the background image.

background-image-resize

0 - No resizing (default)

1 - Shrink-to-fit w (keep aspect ratio)

2 - Shrink-to-fit h (keep aspect ratio)

3 - Shrink-to-fit w and/or h (keep aspect ratio)

4 - Resize-to-fit w (keep aspect ratio)

5 - Resize-to-fit h (keep aspect ratio)

6 - Resize-to-fit w and h

As per CSS3 specification. ‘inset’ is not supported.

(mPDF ≥ 5.4)

slice | clone  (default = slice)

Defines the handling of padding and borders at page breaks, when clonebycss set

Sets a layer in the PDF document.

Note: this is not the same as a “layer” in CSS terms. See Layers.

text-indent

Indents first line of text in the paragraph/block.

LENGTH

(Indent is disabled in tables.)

Negative value will give a ‘hanging indent’.

fixed | absolute

absolute - uses physical page as containing element;

fixed - uses printable page (inside margins) as containing element.

(mPDF ≥ 4.0)

NB Only supported for top-level elements i.e. where the parent element is <body>. Fixed-position or floating elements nested inside other fixed-position or floating elements are not supported.

visible | hidden | auto

Applies to block elements with position fixed or absolute. auto - causes text to autofit within the block size (constrained if necessary to page edges).

(mPDF ≥ 4.0)

none | manual | auto (default = manual)

As per CSS. (mPDF  ≥ 5.7)

rotate

90 | -90

Applies only to block elements with position fixed or absolute. (mPDF ≥ 5.0)

Sizing and layout of the block element using top, left, bottom, right, width and height are applied BEFORE the element is rotated. The top and left co-ordinates are respected for positioning, except when bottom or right are specified without respective top or left when the bottom/right co-ordinates are used.

LENGTH

Applies to block elements with position fixed or absolute.

(mPDF ≥ 4.0)

left | right

Partially supported as for CSS2 property.

NB Fixed-position or floating elements nested inside other fixed-position or floating elements are not supported.

1 | A | a | I | i | disc | circle | square | decimal | lower-roman | upper-roman | lower-latin | upper-latin | lower-alpha | upper-alpha | none

arabic-indic | bengali | cambodian | cjk-decimal | devanagari | gujarati | gurmukhi | hebrew |kannada | khmer | lao | malayalam | oriya | persian | telugu | thai | urdu | tamil

“1” - decimal

“A” = upper-latin

“a” = lower-latin

“I” = upper-roman

“i” = lower-roman

Custom list-style-type is recognised e.g.: U+263Argb(255,0,0);

• where U+263A is the Unicode HEX value of the character you want for the bullet
• the character MUST be included in the font used for that list item
• rgb() bit is optional

<URI>

mPDF ≥ 6.0

inside | outside  (default = outside)

mPDF ≥ 6.0

NB Lists are handled as block-level elements as from mPDF 6.0 (see above)

[ ‘list-style-type’ ‘list-style-position’ ‘list-style-image’ ]  

mPDF ≥ 6.0

1 | A | a | I | i | disc | circle | square | decimal | lower-roman | upper-roman | lower-latin | upper-latin | lower-alpha | upper-alpha | none

arabic-indic | bengali | cambodian | cjk-decimal | devanagari | gujarati | gurmukhi | hebrew |kannada | khmer | lao | malayalam | oriya | persian | telugu | thai | urdu | tamil

“1” - decimal

“A” = upper-latin

“a” = lower-latin

“I” = upper-roman

“i” = lower-roman

Custom list-style-type is recognised e.g.: U+263Argb(255,0,0);

• where U+263A is the Unicode HEX value of the character you want for the bullet
• the character MUST be included in the font used for that list item
• rgb() bit is optional

<URI>

mPDF ≥ 6.0

inside | outside  (default = outside)

mPDF ≥ 6.0

NB Lists are handled as block-level elements as from mPDF 6.0 (see above)

Size style and colour e.g.

LENGTH solid|dotted|dashed|double COLOR

(mPDF ≥ 5.4)

COLOR

(mPDF ≥ 5.4)

LENGTH 

(mPDF ≥ 5.4)

border-style*, border-top-style, border-right-style, border-bottom-style, border-left-style

solid | dotted | dashed | double

(mPDF ≥ 5.4)

hidden | visible | printonly | screenonly (default = visible)

(mPDF ≥ 5.7)

none | manual | auto (default = manual)

As per CSS. (mPDF  ≥ 5.7)

background is parsed as per the CSS specification.

background-image in the form url(image.png) or url('image.png') or GRADIENT.

background-position is supported as per CSS2.1

background-repeat: repeat | repeat-x | repeat-y | no-repeat

background-attachment is parsed but has no effect.

See note below. (cf. Backgrounds & borders)

(All except background-color added mPDF 5.1)

normal | [ from-image <dpi> ]  (mPDF ≥ 5.1)

background-image-opacity

Value between 0 and 1.0

Sets the opacity/transparency of the background image.

Size style and colour e.g.

LENGTH double | solid | dashed | dotted | ridge | outset | groove | inset | hidden | none COLOR 

NB Table & cell borders accept: double | solid | dashed | dotted | ridge | outset | groove | inset (other block elements only support solid | dotted | dashed | double)

COLOR

(mPDF ≥ 4.0)

LENGTH 

(mPDF ≥ 4.0)

double | solid | dashed | dotted | ridge | outset | groove | inset | hidden | none

(mPDF ≥ 4.0)

LENGTH

(mPDF ≤ 1.3 incorrectly set cell-padding for all cells in table.)

Sets table padding (only relevant when border-collapse:separate)

Single or double values:

2px sets horizontal and vertical;

2px 3px sets horizontal=2 and vertical=3

(Same as cellSpacing attribute) Default=2px

left | right | always

(mPDF ≥ 5.4)

rotate

autosize

topntail

thead-underline

inline-line-height | block-line-height | max-height | grid-height

As per draft CSS3 spec. (mPDF ≥ 6.0)

Default = inline-line-height

consider-shifts | disregard-shifts

As per draft CSS3 spec. (mPDF ≥ 6.0)

Default = consider-shifts

overflow

auto | hidden | visible | wrap

Controls table layout if minimum width is too wide for page.

background is parsed as per the CSS specification.

background-image in the form url(image.png) or url(‘image.png’) or GRADIENT.

background-position is supported as per CSS2.1

background-repeat: repeat | repeat-x | repeat-y | no-repeat

background-attachment is parsed but has no effect.

See note below. (cf. Backgrounds & borders)

(All except background-color added mPDF 5.1)

background-image-opacity

Value between 0 and 1.0

Sets the opacity/transparency of the background image.

Size style and colour e.g.

LENGTH double | solid | dashed | dotted | ridge | outset | groove | inset | hidden | none COLOR 

NB Table & cell borders accept: double | solid | dashed | dotted | ridge | outset | groove | inset | hidden | none (other block elements only support solid | dotted | dashed | double)

(mPDF ≥ 5.1)

COLOR

(mPDF ≥ 5.1)

LENGTH 

(mPDF ≥ 5.1)

double | solid | dashed | dotted | ridge | outset | groove | inset | hidden | none

(mPDF ≥ 5.1)

text-rotate

odd | even | an+b

As per CSS3 specification

avoid | allow

Allows grouping of table rows and avoiding page breaks between two pages inside a group. since 8.2.4

background is parsed as per the CSS specification.

background-image in the form url(image.png) or url('image.png') or GRADIENT (mPDF ≥ 5.1).

background-position is supported as per CSS2.1

background-repeat: repeat | repeat-x | repeat-y | no-repeat

background-attachment is parsed but has no effect.

See note below.

(All except background-color added mPDF 3.2)

background-gradient

(Deprecated) GRADIENT_OLD

(Added mPDF 3.2)

background-image-opacity

Value between 0 and 1.0

Sets the opacity/transparency of the background image.

background-image-resize

0 - No resizing (default)

1 - Shrink-to-fit w (keep aspect ratio)

2 - Shrink-to-fit h (keep aspect ratio)

3 - Shrink-to-fit w and/or h (keep aspect ratio)

4 - Resize-to-fit w (keep aspect ratio)

5 - Resize-to-fit h (keep aspect ratio)

6 - Resize-to-fit w and h

Size style and colour e.g.

LENGTH double | solid | dashed | dotted | ridge | outset | groove | inset | hidden | none COLOR 

NB Table & cell borders accept: double | solid | dashed | dotted | ridge | outset | groove | inset | hidden | none (other block elements only support solid | dotted | dashed | double)

COLOR

(mPDF ≥ 4.0)

LENGTH 

(mPDF ≥ 4.0)

double | solid | dashed | dotted | ridge | outset | groove | inset | hidden | none

(mPDF ≥ 4.0)

left | right | center

From mPDF 5.7, also supports a decimal-mark alignment followed by a default e.g.

text-align: '.' center;

Non-ASCII characters should be defined using Unicode values:

text-align: '\66B' center;

text-rotate

inline-line-height | block-line-height | max-height | grid-height

As per draft CSS3 spec. (mPDF ≥ 6.0)

Default = inline-line-height

consider-shifts | disregard-shifts

As per draft CSS3 spec. (mPDF ≥ 6.0)

Default = consider-shifts

none | manual | auto (default = manual)

As per CSS. (mPDF  ≥ 5.7)

odd | even | an+b

As per CSS3 specification

top | middle | bottom | baseline | text-bottom | text-top

(Full support only from mPDF 4.2)

Must be full declaration of size style and colour e.g.

0.1pt solid | dotted | dashed #cccccc

Will also accept #cccccc 0.1pt solid (which is generated by IE WYSIWYG editor)

and (from mPDF 1.4) solid 3mm #000000

medium | thin | thick accepted for size

Value between 0 and 1.0

CSS3 recommended property (but already supported by Firefox)

Sets the opacity/transparency of the image.

normal | [ from-image <dpi> ] (as per draft CSS3)  mPDF ≥ 5.1

auto | crisp-edges | optimizequality | smooth  (as per draft CSS3)

(mPDF ≥ 6.0)

Controls whether interpolation is on or off in PDF document. Once set for an image, subsequent use of the same image will use the initial setting for this property.

auto (default) - uses the value set by config variable: $interpolateImages

crisp-edges - interpolation disabled

optimizequality - interpolation enabled

smooth - interpolation enabled

gradient-mask

visible | hidden | printonly | screenonly  (mPDF ≥ 5.4)

All CSS3 transform functions are supported except matrix() i.e.

translate(), translateX(), translateY()

skew(), skewX(), skewY()

scale(), scaleX(), scaleY()

rotate()

cf. http://www.w3.org/TR/css3-transforms/#typedef-transform-function

top | middle | bottom | baseline | text-bottom | text-top

(Full support only from mPDF 4.2)

outdent

<length>{1,2} | auto | portrait | landscape

Note: ‘em’ ‘ex’ and % are not allowed

Length values are width and height e.g. size: 8.5in 11in; or one value for a square.

Sets the size of the ‘page-box’, which is usually used with a constant size sheet through the document, as in the CSS2 @paged media spec.

<length>{2} | A4 | A4-L etc.

Note: ‘em’ ‘ex’ and % are not allowed

Length values are width and height e.g. size: 8.5in 11in; Any of the standard sheet sizes can be used (as for mPDF() ) with the suffix -L for landscape

A named Header or Footer. HTML headers/footers must precede the name with $html_

NB This was the original form, and still takes preference over header and footer which can be set using the pseudo-selectors e.g. :right

The name _default can be used to allow the current non-HTML header to remain unchanged (mPDF ≥ 5.1)

LENGTH (% refers to page-box width for left/right, of height for top/bottom)

Note that left and right margins cannot be changed when using a page selector.

@page :first is not recognised unless @page has been set with some CSS properties

margin-header, margin-footer

crop | cross | none

From mPDF 5.1 crop and cross can be used together.

A named Header or Footer. HTML headers/footers must precede the name with $html_ (from mPDF 4.2)

background is parsed as per the CSS specification.

background-image in the form url(image.png) or url('image.png') supported.

background-position is supported as per CSS2.1

background-repeat: repeat | repeat-x | repeat-y | no-repeat

background-attachment is parsed but has no effect.

See note below. (cf. Backgrounds & borders)

background-image-opacity

Value between 0 and 1.0

Sets the opacity/transparency of the background image.

background-image-resize

0 - No resizing (default)

1 - Shrink-to-fit w (keep aspect ratio)

2 - Shrink-to-fit h (keep aspect ratio)

3 - Shrink-to-fit w and/or h (keep aspect ratio)

4 - Resize-to-fit w (keep aspect ratio)

5 - Resize-to-fit h (keep aspect ratio)

6 - Resize-to-fit w and h

background-gradient

resetpagenum

INTEGER Reset page numbering. Use with :first

pagenumstyle

suppress

on | off | 1 | 0 

See <pagebreak> for details

normal | none | [ <common-lig-values> <discretionary-lig-values> <historical-lig-values> <contextual-alt-values>

historical-forms

[ small-caps | all-small-caps | petite-caps | all-petite-caps | unicase | titling-caps ]

<numeric-figure-values> <numeric-spacing-values> <numeric-fraction-values>

ordinal

slashed-zero ]

(mPDF ≥ 6.0)

normal | sub | super

(mPDF ≥ 6.0)

normal | small-caps | all-small-caps | petite-caps | all-petite-caps | unicase | titling-caps

(mPDF ≥ 6.0)

normal | none | [

<common-lig-values> <discretionary-lig-values> <historical-lig-values> <contextual-alt-values> ]

(mPDF ≥ 6.0)

<common-lig-values> = [ common-ligatures | no-common-ligatures ]

<discretionary-lig-values> = [ discretionary-ligatures | no-discretionary-ligatures ]

<historical-lig-values> = [ historical-ligatures | no-historical-ligatures ]

<contextual-alt-values> = [ contextual | no-contextual ]

normal | [ <numeric-figure-values>

<numeric-spacing-values>

<numeric-fraction-values>

ordinal

slashed-zero ]

(mPDF ≥ 6.0)

Only [normal | historical-forms] supported (i.e. most are NOT supported)

(mPDF ≥ 6.0)

3-letter case-sensitive OpenType language system tag

(mPDF ≥ 6.0)

Comma separated list of <feature-tag-value> with the following syntax:

<feature-tag-value> = <string> [ <integer> | on | off ]?

(mPDF ≥ 6.0)

auto | normal | none (mPDF ≥ 5.1)

auto and normal both have the effect of turning kerning on, as long as

$mpdf->useKerning = true;

underline | line-through | normal (line-through = strike-through)  (mPDF ≥ 5.4)

overline  (mPDF ≥ 5.7.3)

thickness [ blur ] color; OR none (default)

Blur is not supported.

As per CSS3

(mPDF ≥ 5.7) Supported in tables ≥ 6.0

text-outline-width, outline-width

Width of the outline. LENGTH

(text-outline-width as from mPDF ≥ 5.7)

Supported in tables ≥ 6.0

text-outline-color, outline-color

COLOR  = colour of the inner part of the text e.g. #rrggbb. ‘INVERT’ is also accepted.

(text-outline-color as from mPDF ≥ 5.7) Supported in tables ≥ 6.0

normal | embed | isolate | bidi-override | isolate-override | plaintext

(mPDF ≥ 6.0)

When used on block-level elements:

• the value is not inherited to child blocks
• using embed or isolate has no effect on block level-boxes
• isolate-override is equivalent to bidi-override on block-level boxes