addStructuredDocumentTag

WORD CONTENTS

LAYOUT & SETTINGS

TEMPLATES

FORMAT CONVERSION

DOCXPATH

DOCXUTILITIES

DOCXPATHUTILITIES

PDFUTILITIES

DOCXCUSTOMIZER

customizeWordContent

PERFORMANCE

BULK PROCESSING

TRACKING

CRYPTOPHPDOCX

DIGITAL SIGNATURE

ARTIFICIAL INTELLIGENCE

XLSXUTILITIES

PPTXUTILITIES

BLOCKCHAIN

VARIANT

addStructuredDocumentTag

TRIAL / ADVANCED / PREMIUM

Inserts different types of Structured Document Tags into the Word document.

Description

public addStructuredDocumentTag (string $type [, array $options ] )

This method allows to insert structured document tags (sdt) of various kinds into your Word document:

checkboxes
combo boxes
date pickers
dropdown lists
rich text

Parameters

type

Possible values are:

checkbox
comboBox
date
dropdownList
richText

For a detailed description of the available date formats for the date picker structured document tag, please, check the documentation of the addDateAndHour method.

options

Specific options for structured document tags:

Key	Type	Description
alias	string	The label that will be shown in the structured document tag.
calendar	string	Calendar type. Default type is gregorian. Possible values include: gregorian, hijri, hebrew, taiwan, japan, thai, korea, saka, gregorianXlitEnglish, gregorianXlitFrench.
checked	bool	Set checkboxes as checked or unchecked.
checkedState	array	font (string): MS Gothic as default. value (string): 2612 as default for checkedState. 2610 as default for uncheckedState.
dateFormat	string	The default date format is M/d/yyyy. See addDateAndHour for available date formats.
listItems	array	An array of arrays each one of them containing the text to show and value.
local	string	ISO code. The default value is en-US.
lock	string	Locking properties: sdtLocked (cannot be deleted). contentLocked (contents can not be edited directly). unlocked (default value: no locking). sdtContentLocked (contents can not be directyly edited or the structured tag removed).
placeholderText	string	Text to be shown by default.
sym	array	Custom symbol used with checkbox. Use with checkedState and uncheckedState options. font char
tag	string	A programmatic tag.
temporary	bool	If true the structured tag is removed after editing.
uncheckedState	array	font (string): MS Gothic as default. value (string): 2612 as default for checkedState. 2610 as default for uncheckedState.

The possible keys and values are:

Key	Type	Description
pStyle	string	Paragraph style to be used.
backgroundColor	string	Hexadecimal color value: FF0000, 000000...
bidi	bool	Sets to true for right to left languages like Hebrew or Arabic.
bold	bool	If true the text will be shown in bold characters.
border	string	Available values are: none (default) double dashed outset inset threeDEmboss threeDEngrave You can access to the complete list in: Border Styles.
borderBottom	string	Overwrites the general border type for the bottom border of the paragraph.
borderLeft	string	Overwrites the general border type for the left border of the paragraph.
borderTop	string	Overwrites the general border type for the top border of the paragraph.
borderRight	string	Overwrites the general border type for the right border of the paragraph.
borderColor	string	Hexadecimal color value: FF0000, 000000...
borderBottomColor	string	Overwrites the general border color for the bottom border of the paragraph.
borderLeftColor	string	Overwrites the general border color for the left border of the paragraph.
borderTopColor	string	Overwrites the general border color for the top border of the paragraph.
borderRightColor	string	Overwrites the general border color for the right border of the paragraph.
borderSpacing	int	Separation between border and text in points.
borderBottomSpacing	int	Overwrites the general border spacing for the bottom border of the paragraph.
borderLeftSpacing	int	Overwrites the general border spacing for the left border of the paragraph.
borderTopSpacing	int	Overwrites the general border spacing for the top border of the paragraph.
borderRightSpacing	int	Overwrites the general border spacing for the right border of the paragraph.
borderWidth	int	Border width in eigths of a point.
borderBottomWidth	int	Overwrites the general border width for the bottom border of the paragraph.
borderLeftWidth	int	Overwrites the general border width for the left border of the paragraph.
borderTopWidth	int	Overwrites the general border width for the top border of the paragraph.
borderRightWidth	int	Overwrites the general border width for the right border of the paragraph.
caps	bool	If true displays text in capital letters.
color	string	Hexadecimal color value: 'FF0000', '000000'...
contextualSpacing	bool	If true ignores spacing above and below the paragraph whenever the neighbouring paragraphs use the same Word style (false by default).
doubleStrikeThrough	bool	If true displays text in doubleStrikeThrough.
em	string	Emphasis mark type: 'none', 'dot', 'circle', 'comma', 'underDot'.
emboss	bool	Emboss style.
firstLineIndent	int	First line indentation in twentieths of a point (twips).
font	string	Font family: 'Arial', Calibri'...
fontSize	int	Font size in points.
hanging	int	Paragraph hanging in twentieths of a point (twips).
headingLevel	int	The heading level if you want this paragraph to be a heading.
italic	bool	If true displays the text in italics.
indentLeft	int	Left margin in points.
indentRight	int	Right margin in points.
keepLines	bool	Keeps (whenever possible) all the current paragraph lines on the same page.
keepNext	bool	Keeps (whenever possible) in the same page the current paragraph with next paragraph.
lineSpacing	int	120, 240 (standard), 360, 480... (in twentieths of a point).
noProof	bool	Ignore spelling and grammar errors.
outline	bool	Outline style.
parseLineBreaks	bool	If true (default is false) parses the line breaks to include them in the Word document.
parseTabs	bool	If true (default is false) parses the tabs to include them in the Word document as w:tab tags.
position	int	Position value. Positive value for raised and negative value for lowered.
rtl	bool	Sets to true for right to left languages like Hebrew or Arabic.
scaling	int	Scaling value, 100 is the default value.
shadow	bool	Shadow style.
smallCaps	bool	If true displays text in small capital letters.
spacingBottom	int	Bottom padding in twentieths of a point.
spacingTop	int	Top padding in twentieths of a point.
strikeThrough	bool	If true displays text in strikethrough.
suppressLineNumbers	bool	Suppress line numbers.
tabPositions	array	Each entry is an associative array with the following keys and values: 'type' (string) can be clear, left (default), center, right, decimal, bar and num. 'leader' (string) can be none (default), dot, hyphen, underscore, heavy and middleDot. 'position' (int) given in twentieths of a point. If there is a tab and the tabPositions array is not defined the standard tab position (default of 708) will be used.
textAlign	string	Text alignment within paragraph. Possible values are: center, right, both and distribute.
textDirection	string	Text flow direction within a table cell. Possible values are: lrTb, tbRl, btLr, lrTbV, tbRlV and tbLrV.
underline	string	Underlines text. Possible values are: single, words, double, dotted, dash and wave.
underlineColor	string	Underlines text with a color: 'FF0000', '000000'...
vanish	bool	Uses a vanish style.
widowControl	bool	Prevents Word from printing the last line of a paragraph by itself at the top of the page (widow) or the first line of a paragraph at the bottom of a page (orphan).
wordWrap	bool	Allows line breaking at character level (default value is false).

Exceptions

Structured document tag type is not available.

Code samples

Example #1

require_once 'classes/CreateDocx.php';

$docx = new CreateDocx();

// combo box
$list = array(
    array('First Choice', 1),
    array('second choice', 2),
    array('Third choice', 3),
);

$options = array(
    'listItems' => $list,
    'placeholderText' => 'Choose a value or write it down',
    'alias' => 'Combo Box',
    'fontSize' => 12,
    'italic' => true,
    'color' => 'FF0000',
    'bold' => true,
    'underline' => 'single',
    'font' => 'Algerian',
);

$docx->addStructuredDocumentTag('comboBox', $options );

// date
$options = array(
    'placeholderText' => 'Choose a date',
    'alias' => 'Date picker',
    'fontSize' => 14,
    'italic' => true,
    'color' => '777777',
    'bold' => true,
    'font' => 'Calibri',
);

$docx->addStructuredDocumentTag('date', $options);

// dropdown
$list = array(
    array('One', 1),
    array('Two', 2),
    array('Three', 3),
);

$options = array(
    'listItems' => $list,
    'placeholderText' => 'Choose a value',
    'alias' => 'Dropdown menu',
    'fontSize' => 12,
);

$docx->addStructuredDocumentTag('comboBox', $options);

// richText
$options = array(
    'placeholderText' => 'This text is locked',
    'alias' => 'Rich text',
    'lock' => 'contentLocked',
);

$docx->addStructuredDocumentTag('richText', $options);

$docx->createDocx('output');

The resulting Word document looks like:

Release notes

phpdocx 15.0:
- checkedState, uncheckedState and sym options.

phpdocx 13.5:
- supported working as inline WordFragment.

phpdocx 12.0:
- htmlspecialchars applied in placeholderText and alias options.