This paragraph keeps the margin but drops color and font-size.
`; const pdfDef = htmlToPdfMake(html, { ignoreStyles: ['color', 'font-size'] }); ``` In this example, the generated PDF definition retains the **margin** but strips **color** and **font-size**, causing the text to render with PDFMake defaults. ### Implementation in the Source Code According to the `aymkdn/html-to-pdfmake` source code, the filtering mechanism operates in two stages within [`index.js`](https://github.com/aymkdn/html-to-pdfmake/blob/main/index.js). First, the constructor validates and stores your ignore list (lines 50–51): ```js this.ignoreStyles = (options && Array.isArray(options.ignoreStyles) ? options.ignoreStyles : []); ``` Second, during style parsing in the `parseStyle` method (lines 1003–1009), the code checks each CSS property against this array before processing: ```js if (this.ignoreStyles.indexOf(key) === -1) { // …switch handling for supported properties… } ``` If the property name exists in `ignoreStyles`, the condition evaluates to false and the property is omitted from the final PDFMake definition. ## Common Scenarios for Ignoring CSS Styles Different use cases require filtering specific categories of CSS properties to achieve consistent PDF output. ### Enforcing Monochrome Output To remove all color information including text and background colors: ```js ignoreStyles: ['color', 'background-color', 'fillColor'] ``` This prevents any color declarations from reaching the PDF definition, resulting in black text and transparent backgrounds. ### Standardizing Typography To prevent font-weight and style variations that might require unavailable custom fonts: ```js ignoreStyles: ['font-weight', 'font-style'] ``` This ensures text appears with the default PDFMake font weight and style, avoiding bold or italic fonts that may not be embedded in your PDF. ### Auto-Sizing Layouts To let PDFMake calculate dimensions instead of using HTML-specified pixel values: ```js ignoreStyles: ['width', 'height', 'max-width', 'max-height'] ``` This allows PDFMake’s intrinsic layout engine to determine element sizing based on content and page constraints. ## Advanced Code Examples ### Ignoring a Single Property When you need to strip only one specific declaration, such as text color: ```js const def = htmlToPdfMake('Red text', { ignoreStyles: ['color'] }); // PDFMake output: { text: 'Red text' } - no color field present ``` ### Filtering Multiple Declarations To remove several unrelated properties simultaneously: ```js const def = htmlToPdfMake(`Hello
', { defaultStyles: { p: { color: 'green' } }, ignoreStyles: ['color'] }); // The paragraph renders in PDFMake default (black) because color is filtered out ``` Even though `defaultStyles` specifies green, the `color` property is intercepted and removed during parsing, so the text renders with the PDF engine default. ## Summary - Supply an `ignoreStyles` array containing CSS property names (e.g., `['color', 'width']`) to the `htmlToPdfMake()` function options. - The constructor validates this array in [`index.js`](https://github.com/aymkdn/html-to-pdfmake/blob/main/index.js) (lines 50–51) and the parser applies the filter during style processing (lines 1003–1009). - Ignored properties are skipped entirely, allowing PDFMake defaults or remaining styles to take precedence. - This feature works with inline styles and, when combined with `defaultStyles`, can override default color and font specifications. ## Frequently Asked Questions ### Can I use wildcards or regular expressions in the `ignoreStyles` array? No, the implementation uses strict string comparison via `indexOf()`. Each CSS property name must be listed explicitly as a full string match. For example, use `'font-size'` rather than `'font-*'` or `/font-.*/`. ### Does `ignoreStyles` remove CSS classes or only inline style properties? The `ignoreStyles` option filters individual CSS property names, not class selectors. It applies to all style declarations the parser encounters, whether from inline `style` attributes or computed from classes, but it operates at the property level after CSS parsing occurs in [`index.js`](https://github.com/aymkdn/html-to-pdfmake/blob/main/index.js). ### What happens if I ignore layout properties like `width` or `height`? When you include dimensional properties in `ignoreStyles`, PDFMake uses its intrinsic sizing algorithms instead of the HTML-specified values. This is useful for allowing automatic column widths or page-fitting calculations rather than fixed pixel dimensions. ### Will `ignoreStyles` override the `defaultStyles` option? Yes. If you define a style in `defaultStyles` (such as `color: 'green'`) but also include that property name in `ignoreStyles`, the property is filtered out during the parsing stage (line 1003–1009 in [`index.js`](https://github.com/aymkdn/html-to-pdfmake/blob/main/index.js)) and never reaches the final PDF definition, effectively nullifying the default.