XSL/CSS Extensions

Specifies the tag name of Tagged PDF.

Customizes the tag name when outputting Tagged PDF. When you want to make the tag name of the relevant element “paragraph”, e.g., specify as follows:

When new-tagging-mode is set to true, and an empty string is specified explicitly as shown below, that element does not create a tag but belongs to the tag to which the parent area belongs. V7.0

Specifies how to include bookmarks in multi separate volume.

Values have the following meanings.

first

Adds a bookmark to the first separate volume.

all

Adds bookmarks to all the separate volumes.

separate

Adds each bookmark to each separate volume. Bookmarks are added to the volume where axf:outline-level="1" appears. The bookmark that goes across the volume is added to the previous volume. For that reason, the external link to the other volume may be included even though axf:bookmark-include="separate" is specified. Bookmarks grouped by axf:outline-group are attached to the last separate volume.

separate-group V7.0

Same as separate, but also adds grouped bookmarks to each volume.

This property is not available with AH Formatter V7.0 Lite.

Specifies how to include document information in multi separate volume.

Values have the following meanings.

first

Adds document information to the first separate volume.

all

Adds document information to all the separate volumes.

See <axf:document-info>. This property is not available with AH Formatter V7.0 Lite.

Specifies the initial volume number in multi separate volume.

This value is applied for the format property and utilized for the PDF file name to output. In the following example, the file name of the separate volume is document-2.pdf, document-3.pdf, document-4.pdf, and so on.

<axf:output-volume-info
  initial-volume-number="2"
  format="-1"
/>

This property is not available with AH Formatter V7.0 Lite.

Separates the file in multi volume.

Values have the following meanings.

true

Separates the volume newly from this fo:page-sequence.

false

Do not separates the volume newly from this fo:page-sequence.

Specifies axf:output-volume-break="true" to fo:page-sequence where you want to start separating the volume. The document number increases one by one. When separating the volume, axf:output-volume-break="true" is regarded as always being specified to the first fo:page-sequence. If axf:output-volume-break="false" is specified explicitly, it is ignored.

This property is not available with AH Formatter V7.0 Lite.

Specifies the document file name in multi separate volume.

If nothing specified, the automatic file name using the format property is adopted. If this property is specified, the specified name is adopted. This property is effective only with the top fo:page-sequence or with the fo:page-sequence where axf:output-volume-break="true" is specified.

In the following example, suppose that if document.pdf is specified as the file name of the PDF output, the separated file names will be document-2.pdf, chapterX.pdf, document-4.pdf, and so on.

<axf:output-volume-info
  initial-volume-number="2"
  format="-1"
/>

<fo:page-sequence>
  ...
</fo:page-sequence>
<fo:page-sequence axf:output-volume-break="true" axf:output-volume-filename="chapterX.pdf">
  ...
</fo:page-sequence>
<fo:page-sequence axf:output-volume-break="true">
  ...
</fo:page-sequence>

The original PDF file name cannot be omitted even though axf:output-volume-filename is specified to all the fo:page-sequence. This property is not available with AH Formatter V7.0 Lite.

The axf:outline-expand specifies whether to display the lower hierarchy of bookmark items or not.

True specifies to display the lower hierarchy in the expanded state. False specifies to display in the collapsed state. In CSS, (-ah-)bookmark-state is also available.

The axf:outline-group groups bookmark items, and outputs them collectively.

If this property is omitted or specifies empty string, bookmark items are not grouped. If this specifies any string, the string is used as the name of group. The group with the same name is outputted collectively. The non-grouped bookmark is outputted as the group without the group name.

The axf:outline-level indicates the hierarchy level of bookmark items.

The <number> must be a non-negative integer. Initial value is 0 and it means that bookmarks should not be created. The highest level of bookmarks is 1 and it becomes 2 or more according to the hierarchy level of the bookmarks. In CSS, (-ah-)bookmark-level is also available.

The axf:outline-title specifies the string which appears as a title of bookmarks.

If this property is omitted or has an empty string, the text of the object to which the property is added will become the title. In other words, the following two samples create the same bookmark.

In CSS, (-ah-)bookmark-label is also available.

The axf:outline-color specifies the color which appears as a title of bookmarks.

When transparent is specified, the color information is not set to PDF.

This property is effective with PDF1.4 or later. This property is not available with AH Formatter V7.0 Lite.

The axf:outline-font-style specifies the font style which appears as a title of bookmarks.

Values have the following meanings.

normal

Specifies normal style.

italic

Specifies italic.

This property is effective with PDF1.4 or later. This property is not available with AH Formatter V7.0 Lite.

The axf:outline-font-weight specifies the font weight which appears as a title of bookmarks.

Values have the following meanings.

normal

Specifies normal weight.

bold

Specifies bold weight.

This property is effective with PDF1.4 or later. This property is not available with AH Formatter V7.0 Lite.

• These properties have to be created in block areas or inline areas. (fo:block, fo:inline ...) If you specify them in an fo:wrapper, for example, they are not effective.
• When the language is not supported in Acrobat and the font that belongs to the unsupported language is specified for the bookmark, there may be a possibility of the font displaying incorrectly in Adobe Acrobat or Reader.

Specifies the action of External Link. See also Form Actions.

Values have the following meanings.

auto

Dependent on the system setting.

gotor

Opens the link destination by the “GoToR” action as PDF. The URI of the destination is regarded as PDF.

launch

Opens the link destination by the “Launch” action as the file.

uri

Opens the link destination by the “URI” action as URI (World Wide Web).

When the link destination is not a local file, such as http:, the action type is “URI” at any time. When axf:action-type="auto" specified, the external link specified by the local file is transformed into either “Open the file” or “World Wide Web link” by the use-launch-for-local-file property in PDF Output Settings. The external link specified by the non-local file is always transformed into “World Wide Web link”.

Specifies the way a link opens in a link destination.

The destination type has the following options. If nothing specified, it's accounted as axf:destination-type="xyz-top". The case sensitivity is ignored. axf:destination-type can be specified together with ID in the External Link, ID in the Internal Link, Page Number in the External Link, Page Number in the Internal Link, Bookmark with the External Link and Bookmark with the Internal Link.

This property is not available with AH Formatter V7.0 Lite.

Sets the external link in the PDF bookmark.

Values have the following meanings.

<uri-specification>

Specifies the URI of the link destination.

This property is not available with AH Formatter V7.0 Lite.

Sets the internal link in the PDF bookmark.

Values have the following meanings.

<idref>

Specifies the ID of the link destination.

<number-with-fragment>

Specifies the page number of the link destination. This string is simple numeric characters or the following string that combines numeric characters and a fragment with “#”. See Making Link for the fragment.

123#zoom=50

The page number also can be specified in the fragment.

#page=123&zoom=50

When the page number is not specified, it is usually regarded as the 1st page. However, when the top position is specified, it is regarded as the head of the page of a block where axf:outline-internal-destination is contained. For example, it is specified as follows.

#view=fit #view=fith #zoom=,,0

This property is not available with AH Formatter V7.0 Lite.

A link destination is created when axf:destination-type is set and the ID of the destination is specified in the “id” property.

<fo:block id="Chapter6" axf:destination-type="xyz-top">

The ID is specified in external-destination if the link destination is referred to from an external link in a different PDF. Only the nameddest parameter is valid in the URI.

<fo:basic-link external-destination="http://mydocs/doc.pdf#nameddest=Chapter6"
               axf:action-type="gotor">

A link destination is created when axf:destination-type is set and the ID of the destination is specified in the “id” property.

<fo:block id="Chapter6" axf:destination-type="xyz-top">

The ID is specified in internal-destination when creating an internal link.

<fo:basic-link internal-destination="Chapter6">

The page number can be accounted by the page parameter in the URI. If both page and nameddest are specified, nameddest takes priority. When specifying the page number, the destination information cannot be set to the link destination. Therefore the type of the destination is given by reading the parameter in the URI. The unreadable parameter is discarded.

<fo:basic-link external-destination="http://mydocs/doc.pdf#page=72&amp;view=fitH,100"
               axf:action-type="gotor">

When neither page nor nameddest are included in the parameter of the URI, it's accounted as page=1. The page number is accounted as physical in PDF.

Adds extension in order to specify the page number to the value of internal-destination.

<fo:basic-link internal-destination="72">

The type of the destination can be specified by adding the parameter of the external link URI.

<fo:basic-link internal-destination="72#view=fitH,100">

The page number is accounted as physical in PDF. If only the page number is specified, the type of the destination is accounted as view=fit.

Specify the axf:outline-external-destination property as follows in order to specify the external link to the bookmark.

<fo:block axf:outline-level="1"
          axf:outline-title="Chapter 6"
          axf:outline-external-destination="http://mydocs/doc.pdf#nameddest=Chapter6"
          axf:action-type="gotor"
          show-destination="new">

At that time, this bookmark becomes independent of the block such as fo:block, etc., which the bookmark belongs to.

Specify the axf:outline-internal-destination property as follows in order to specify the internal link to the bookmark.

<fo:block axf:outline-level="1"
          axf:outline-title="Chapter 6"
          axf:outline-internal-destination="Chapter6">

At that time, this bookmark becomes independent of the block such as fo:block, etc., which the bookmark belongs to.

• Specify either internal-destination or external-destination.
• There may be a case that an internal link is accounted as an external link when separating the multi volume. At that time, the action type of the link is accounted as axf:action-type="gotor".
• When an unintended link is created, please confirm the setting of your PDF viewer application first. For example, in Adobe Reader or Adobe Acrobat, the feature of “Create links from URLs” may create a link automatically.

Specifies the type of the annotation.

Any of the following types of the annotation can be specified.

• Empty string

  No annotations.

• "Text"

  Text annotation.

• "FreeText"

  Free text annotation.

• "Stamp"

  Rubber stamp annotation.

• "FileAttachment"

  File attachment annotation.

Character strings are case insensitive.

fo:basic-link and HTML <a> always generate a “Link” annotation.

This property is not available with AH Formatter V7.0 Lite.

Specifies the author of the annotation.

This property is not available with AH Formatter V7.0 Lite.

Specifies the title of the annotation.

This property is effective with PDF1.5 or later. This property is not available with AH Formatter V7.0 Lite.

Specifies the content of the annotation.

Specifies the character string to be displayed for an fo:basic-link or HTML <a> or when axf:annotation-type specifies one of the following annotation types:

• "Text"
• "FreeText"
• "Stamp"
• "FileAttachment"

See Alternate descriptions are provided.

This property is not available with AH Formatter V7.0 Lite.

Specifies the color used for the background of the annotation.

This property is not available with AH Formatter V7.0 Lite.

Specifies the flag of the annotation.

Specifies the following character sequences by enumerating using the white space. They are case insensitive.

• Invisible
• Hidden
• Print
• NoZoom
• NoRotate
• NoView
• ReadOnly
• Locked
• ToggleNoView
• LockedContents

See also “PDF Reference, ISO 32000-1” to learn more.

This property is not available with AH Formatter V7.0 Lite.

Specifies the initial state of the annotation.

Specifies whether it is displayed in the open state when the type of the annotation (axf:annotation-type) is as follows.

• "Text"

Values have the following meanings.

true

Displays the annotation in the open state.

false

Displays the annotation in the closed state.

This property is not available with AH Formatter V7.0 Lite.

Specifies the name of the icon used for displaying the annotation.

Although arbitrary name can be specified for the icon used for the display of annotations, whether it can be displayed or not depends on the viewer application of a document. The annotation type (axf:annotation-type) shows the standard name which can be specified.

• "Text"

  Standard names are as follows:

  • "Comment"
  • "Help"
  • "Insert"
  • "Key"
  • "NewParagraph"
  • "Note"
  • "Paragraph"

  Empty string is regarded as “None”.

• "Stamp"

  Standard names are as follows:

  • "Approved"
  • "AsIs"
  • "Confidential"
  • "Departmental"
  • "Draft"
  • "Experimental"
  • "Expired"
  • "Final"
  • "ForComment"
  • "ForPublicRelease"
  • "NotApproved"
  • "NotForPublicRelease"
  • "Sold"
  • "TopSecret"

  Empty string is regarded as “Draft”.

• "FileAttachment"

  Standard names are as follows:

  • "Graph"
  • "Paperclip"
  • "PushPin"
  • "Tag"

  Empty string is regarded as “PushPin”.

This property is not available with AH Formatter V7.0 Lite.

Specifies the horizontal position of the annotation.

The position specified is the distance from the left edge of the region and is used for the position of pop-up or icons and the position of rubber stamp annotations.

This property is not available with AH Formatter V7.0 Lite.

Specifies the vertical position of the annotation.

The position specified is the distance from the top edge of the region and is used for the position of pop-up or icons and the position of rubber stamp annotations.

This property is not available with AH Formatter V7.0 Lite.

Specifies the width of the annotation.

This property is used for the width of pop-up and the width of rubber stamp annotations.

This property is not available with AH Formatter V7.0 Lite.

Specifies the height of the annotation.

This property is used for the height of pop-up and the height of rubber stamp annotations.

This property is not available with AH Formatter V7.0 Lite.

Specifies the font family of the free text annotation.

This property is not available with AH Formatter V7.0 Lite.

Specifies the font size of the free text annotation.

This property is not available with AH Formatter V7.0 Lite.

Specifies the font weight of the free text annotation.

This property is not available with AH Formatter V7.0 Lite.

Specifies whether to make the font of the free text annotation italic.

This property is not available with AH Formatter V7.0 Lite.

Specifies the color of the free text annotation.

This property is not available with AH Formatter V7.0 Lite.

Specifies the alignment of the free text annotation.

This property is not available with AH Formatter V7.0 Lite.

Specifies the border style of the free text annotation.

The following can be specified for <border-style>. If anything else is specified, it is considered as solid.

• solid
• dotted
• dashed
• dot-dash
• dot-dot-dash

This property is not available with AH Formatter V7.0 Lite.

Specifies the border width of the free text annotation.

This property is not available with AH Formatter V7.0 Lite.

Specifies the border color of the free text annotation.

This property is not available with AH Formatter V7.0 Lite.

Specifies the file with which file attachment annotation is related.

This property is not available with AH Formatter V7.0 Lite.

Common Usage:

Encloses the unit of the form action.

Areas:

Generates and returns a block-area.

Contents:

(#PCDATA | %inline; | %block;)*

Specifies the way to send the information when submitting a form field.

Values have the following meanings.

get

Sends out a form as GET request.

post

Sends out a form as POST request.

Specifies whether to send out the coordinates of the mouse when submitting a form field.

Values have the following meanings.

false

Does not send out the coordinates.

true

Sends out the coordinates.

Common Usage:

Generates a form field.

Areas:

Generates and returns a single normal inline-area.

Contents:

(axf:form-field-option | axf:form-field-event)*

The main constraints of form fields generated by HTML forms are as follows: See the contents of html.css to know more about supported features. Features not explicitly stated in html.css are invalid even if they are not listed in the constraint.

• Not all attributes that can be specified for <input>, <button>, <textarea>, <select> are supported.
• Not all “type” that can be specified for <input> are supported.
• If search, tel, url, email, month, week, datetime-local are specified as the type of <input>, it is treated as -ah-field-type:text.
• By <input type="button">, <button type="button">, the button will be displayed, but it will not function as a field. In addition, only the text is valid for the contents displayed on the <button>.

Specifies the field type.

Values have the following meanings.

text

Specifies the Text field.

button

Specifies the Push Button field.

checkbox

Specifies the Check Box field.

radio

Specifies the Radio Button field.

listbox

Specifies the List Box field.

combobox

Specifies the Combo Box field.

signature

Specifies the Digital Signature field.

Specifies the field name.

If the name is omitted, an appropriate name will be generated.

Adds a page number to the field name.

Adds a page number to the name specified by axf:field-name. It's invalid when axf:field-name is not specified. A character string that can be specified is the one that can be specified by format. A page number is formatted and added. If it's an empty string, nothing is added.

This property is specified when creating a form in <fo:static-content> and you want to make a separate form on each page.

Specifies the descriptive text of the field.

The string that was specified here as a value is shown as a tooltip with Acrobat etc.

Specifies the value used when submitting a form field, etc.

Specifies the flag of the field.

Specifies the following character sequences by enumerating using the white space. They are case insensitive.

• ReadOnly : Makes it a read-only field. Same as axf:field-readonly="true", but the axf:field-flags setting takes precedence.
• Required : Makes it a input-required field. Same as axf:field-required="true", but the axf:field-flags setting takes precedence.
• Multiline : Makes the text field multiple lines. Same as axf:field-multiline="true", but the axf:field-flags setting takes precedence.
• Scroll : Makes the text field scrollable. Same as axf:field-scroll="true", but the axf:field-flags setting takes precedence.
• Password : Makes the text field password-protected. Same as axf:field-password="true", but the axf:field-flags setting takes precedence.
• Checked : Makes the check box and radio button being checked. Same as axf:field-checked="true", but the axf:field-flags setting takes precedence.
• Multiple : Makes multiple items selectable in the list box. Same as axf:field-multiple="true", but the axf:field-flags setting takes precedence.
• Editable : Makes the value editable in the combo box. Same as axf:field-editable="true", but the axf:field-flags setting takes precedence.
• Hidden : Makes it a hidden field. However, the size of the field is secured. Backgrounds and borders are displayed.

This property is not available with AH Formatter V7.0 Lite.

Specifies whether the field is read-only or not.

Values have the following meanings.

true

The field is read-only.

false

The field is not read-only.

Specifies whether the field is enter-required or not.

Values have the following meanings.

true

The field is enter-required.

false

The field is not enter-required.

Specifies the text entered into the text field from the beginning.

Specifies whether the text field is a single-line enterable field or a multi-line enterable field.

Values have the following meanings.

false

The text field is a single-line enterable field.

true

The text field is a multi-line enterable field.

Specifies whether the text field is scrollable or not.

Values have the following meanings.

false

The text field is not scrollable.

true

The text field is scrollable.

Specifies whether the text field requires the password or not.

Values have the following meanings.

false

The text field does not require the password.

true

The text field requires the password. Entered characters are shown as “*”, etc.

Specifies the maximum number of characters which can be entered into the text field.

When 0 or less is specified, the number of characters is not limited.

Specifies the format type of the text field.

Values have the following meanings.

none

Does not specify the format.

number

Specifies the format for numerical values.

percentage

Specifies the format for percentage values.

date

Specifies the format for date values.

time

Specifies the format for time values.

Actual formats can be specified by axf:field-format.

Specifies the format of the text field.

The setting of the format will differ depending on the type of formats specified by axf:field-format-category. When auto is specified, the default is adopted to all values. In other cases, values of axf:field-format-category can be specified as follows:

number

Values can be specified with a maximum of 5 as follows:

axf:field-format="2 0 1 '$ ' true"

These values have the following meanings in sequence.

1. The number of digits after the decimal point. (default: 2)

   When the inputted value has many digit numbers after the decimal point, it is displayed by rounding off.

2. How to display numbers with different separators. One of the following values can be specified. (default: 0)

   0.	1,234.56
   1.	1234.56
   2.	1.234,56
   3.	1234,56
   4.	1'234.56

3. How to display negative numbers. (default: 0)

   0.	No processing.
   1.	Display in red.
   2.	Display with parentheses.
   3.	Display in red with parentheses.

4. Currency symbol. Any character strings can be specified. (default: empty)

   When putting a currency symbol before numbers, it's better to put a white space after the currency symbol like “$ ”. When putting it after numbers, put a white space before the currency symbol.

5. Position of a currency symbol. If true is specified, it is displayed before numbers, if false is specified, it is displayed after numbers. (default: true)

percentage

Values can be specified with a maximum of 2 as follows:

axf:field-format="2 0"

Values have the same meaning as number.

date

Specifies the format by the numerical value or character strings. One of the following numerical values can be specified. (default: 0)

0.	m/d
1.	m/d/yy
2.	mm/dd/yy
3.	mm/yy
4.	d-mmm
5.	d-mmm-yy
6.	dd-mmm-yy
7.	yy-mm-dd
8.	mmm-yy
9.	mmmm-yy
10.	mmm d, yyyy
11.	mmmm d, yyyy
12.	m/d/yy h:MM tt
13.	m/d/yy HH:MM

The following 2 settings have the same meaning.

axf:field-format="2"
axf:field-format="'mm/dd/yy'"

Although an arbitrary format can be specified in the character string, the operation when specifying the mistaken format will not be guaranteed. See the specifications of JavaScript, etc. to learn the meaning of the character in the format.

time

Specifies the format by the numerical value or character strings. One of the following numerical values can be specified. (default: 0)

0.	HH:MM
1.	h:MM tt
2.	HH:MM:ss
3.	h:MM:ss tt

The following 2 settings have the same meaning.

axf:field-format="0"
axf:field-format="'HH:MM'"

Although an arbitrary format can be specified in the character string, the operation when specifying the mistaken format will not be guaranteed. See the specifications of JavaScript, etc. to learn the meaning of the character in the format.

Specifies the alignment of the text field.

This property is not available with AH Formatter V7.0 Lite.

Specifies the font size of the character string displayed in the form fields.

Values have the following meanings.

font-size

Sets the value specified by the font-size property.

auto

Sets the font size to auto without specifying the size.

<length>

Sets the font size explicitly.

This property is not available with AH Formatter V7.0 Lite.

Specifies the positioning between the caption and icon displayed in the push button field.

Values have the following meanings.

caption

Only a caption is displayed on the button. An icon is not displayed.

icon

Only an icon is displayed on the button. A caption is not displayed.

caption-below-icon

A caption is displayed under the icon.

caption-above-icon

A caption is displayed on top of the icon.

icon-caption

A caption is displayed on the right side of the icon.

caption-icon

A caption is displayed on the left side of the icon.

caption-over-icon

A caption is displayed on the icon in piles.

Specifies the caption displayed in the push button field.

Specifies the icon displayed in the push button field.

Specifies the caption displayed when pressing the push button.

Specifies the icon displayed when pressing the push button.

Specifies the caption displayed when rolling over the push button.

Specifies the icon displayed when rolling over the push button.

Specifies the initial state of the check box and the radio button.

Values have the following meanings.

false

The initial state is unchecked.

true

The initial state is checked.

Specifies the style of the check box and the radio button.

Specifies the first selected item in the list box, combo box.

The specified value indicates what number of <axf:form-field-option> it is. The beginning number is 1. When less than 1 is specified or the specified number exceeds the number of elements contained, the value is regarded as 1.

Specifies whether multiple items can be chosen in the list box.

Values have the following meanings.

false

Multiple items cannot be chosen.

true

Multiple items can be chosen.

Specifies whether the value can be edited with the combo box.

Values have the following meanings.

false

The value cannot be edited.

true

The value can be edited.

Specifies whether to lock the document at the time of signing with the digital signature field.

Values have the following meanings.

auto

The PDF viewer will display a user interface such as a dialog asking whether or not to lock the document.

false

Does not lock the document after signing.

true

Locks the document at the time of signing.

Effective with PDF1.7 or later.

Common Usage:

Specifies the component elements of the list box, combo box.

Areas:

No areas generated.

Contents:

#PCDATA

Specifies the first selected item in the list box, combo box.

Values have the following meanings.

false

Does nothing.

true

Specifies the first selected item.

The axf:field-selected="true" setting overrides the axf:field-top-index setting. The behavior when multiple items specified is inconstancy.

Text field can be specified by field-type="text". The contents are empty. Whether it is a single line or not depends on the setting of field-multiline.

<axf:form-field
     field-type="text"
     field-default-text="TEXT"
     field-multiline="false"
     field-scroll="false"
     field-password="true"
     field-maxlen="100"
/>

The contents of field-default-text are not displayed in GUI.

Push Button field can be specified by field-type="button". The contents are empty. The Push button is usually an object used to perform an action.

<axf:form-field
     field-type="button"
     field-button-layout="caption"
     field-button-face="TEXT"
     field-button-icon="URI"
     field-button-face-down="DOWN"
     field-button-icon-down="URI"
     field-button-face-rollover="OVER"
     field-button-icon-rollover="URI"
/>

The contents of field-button-face are not displayed in GUI.

Check Box field can be specified by field-type="checkbox". The contents are empty.

<axf:form-field
     field-type="checkbox"
     field-checked="true"
     field-checked-style="checkmark"
/>

The status of field-checked="true" are not displayed in GUI.

Radio Button field can be specified by field-type="radio". The contents are empty.

<axf:form-field
     field-type="radio"
     field-checked="true"
     field-checked-style="checkmark"
     field-name="Card"
     field-value="MasterCard"
/>

Radio buttons are usually arranged in groups of two or more. The group is identified as a radio button with the same field-name. Users can select only one of the radio buttons. Even if checked="true" is set multiply, only one button in a group is checked.

The status of field-checked="true" is not displayed in GUI.

List Box field can be specified by field-type="listbox". <axf:form-field-option> is required for the contents. It should not be empty. <axf:form-field-option> expresses the contents of the list and these are lined up in the appearance order in the list. Neither the value of field-value nor the content text in <axf:form-field-option> should be empty or white-space characters.

<axf:form-field
     field-type="listbox"
     field-top-index="1"
     field-multiple="true"
>
 <axf:form-field-option field-value="M">MasterCard</axf:form-field-option>
 <axf:form-field-option field-value="V">Visa</axf:form-field-option>
 <axf:form-field-option field-value="A">AMEX</axf:form-field-option>
</axf:form-field>

The contents of the list box are not displayed in GUI.

Combo Box field can be specified by field-type="combobox". <axf:form-field-option> is required for the contents. The contents should not be empty. <axf:form-field-option> is the same as that of the list box.

<axf:form-field
     field-type="combobox"
     field-top-index="1"
     field-editable="true"
>
 <axf:form-field-option field-value="M">MasterCard</axf:form-field-option>
 <axf:form-field-option field-value="V">Visa</axf:form-field-option>
 <axf:form-field-option field-value="A">AMEX</axf:form-field-option>
</axf:form-field>

The contents of the combo box are not displayed in GUI.

Digital Signature field can be specified by field-type="signature". The contents are empty. The appearance cannot be specified beforehand.

<axf:form-field
     field-type="signature"
     width="40pt"
     height="50pt"
/>

When performing the formatting process, the signature area is only secured and the signature field is not generated. The signature field is generated when generating PDF.

Specifies the action of Form Actions.

Values have the following meanings.

auto

Dependent on the system setting. See also axf:action-type for External Link.

goto

Moves to the internal link destination by the “GoTo” action.

gotor

Opens the link external destination by the “GoToR” action as PDF. The URI of the external destination is regarded as PDF.

launch

Opens the link external destination by the “Launch” action as the file.

uri

Opens the link external destination by the “URI” action as URI (World Wide Web).

reset no-LT

Resets a form filed as a form action.

submit no-LT

Submits a form filed as a form action.

javascript

Generates the action by JavaScript. This setting is available only with axf:form-field-event. Ignored when allow-javascript="false" is set in the Option Setting File.

Reset initializes the value of all the fields included in <axf:form> to their initial state. Specify axf:action-type="reset" to the button to reset. The action is generated by releasing the button.

<axf:form>
 <axf:form-field field-type="button" action-type="reset" .../>
 <axf:form-field field-type="text" field-default-text="XXX" .../>
 ...
</axf:form>

Submit sends out the information by using HTTP. The contents of each field are sent out as GET or the POST request of HTTP. That is, the information is submitted using the same HTTP method of HTML. The action is generated by releasing the button.

<axf:form
     external-destination="URI"
     field-submit-method="post"
     field-submit-coordinates="false"
>
 <axf:form-field field-type="button" action-type="submit" .../>
 <axf:form-field field-type="text" field-default-text="YYY" .../>
 ...
</axf:form>

Link cannot be specified to <axf:form> but directly specified to the Button field. The method is the same as that of <fo:basic-link>. The internal link can be specified as follows. Specifies goto to action-type or omits the setting. The action is generated by releasing the button.

<axf:form-field field-type="button" internal-destination="IDREF" 
                                    action-type="goto" .../>

The external link can be specified as follows. You can specify any one of gotor, launch or uri to action-type.

<axf:form-field field-type="button" external-destination="URI"
                                    action-type="gotor" .../>

Common Usage:

Defines the form action which corresponds to the event.

Areas:

No areas generated.

Contents:

<!ELEMENT axf:form-field-event #PCDATA> <!ATTLIST axf:form-field-event name CDATA #REQUIRED> <!ATTLIST axf:form-field-event action-type CDATA #REQUIRED>

It's possible to put the axf:form-field-event extension element as a child element of axf:form-field. The properties are name and action-type and both are required. One of the following event types can be specified to name. Case insensitive.

MouseUp

The action occurs when a mouse button is released on the form field.

MouseDown

The action occurs when a mouse button is pushed on the form field.

MouseEnter

The action occurs when a mouse cursor enters the form field.

MouseExit

The action occurs when a mouse cursor exits the form field.

OnFocus

The action occurs when a form field gets focus.

OnBlur

The action occurs when a form field loses focus.

The action occurred by <axf:form-field action-type> is the action by MouseUp. When both are specified like, <axf:form-field-event name="MouseUp">, axf:form-field-event will take precedence. When the same events are multiply specified to axf:form-field-event, which is adopted is indefinite.

When action-type="javascript" is specified, the JavaScript program will be written in the content text. If an incorrect program is specified, the operation will not be guaranteed. However, when allow-javascript="false" is set in the Option Setting File, it's ignored.

Specifies the language code (RFC3066). It is not possible to omit it.

Specifies the amount of space. Specification is invalid when less than 0.

Values have the following meanings.

figure

Indicates the same amount as U+2007.

punctuation

Indicates the same amount as U+2008.

thin

Indicates the same amount as U+2009.

hair

Indicates the same amount as U+200A.

Specifies the code point to be applied.

language and space are applied to all the specified code points.

Usually, the additional setting by <axf:formatter-config> never influences the formatting process of the following document. However, when the following settings are done by GUI, the additional settings will be reflected on the default settings, then reflected on the formatting of the following document.

• Format Option Setting
• PDF Option Setting
• Other Settings
• Import Option Setting
• Export Option Setting

The addition option setting information by <axf:formatter-config> is not reflected in the AreaTree.

When axf-formatter-config="false" is specified in the Option Setting File, the contents of <axf:formatter-config> will be ignored.

Specifies the distance from the physical end to the trim size of the output medium.

The trim size is specified by the page-width and page-height properties (CSS size property). crop-offset is for specifying how much the space is taken outside the trim size. In order to specify the same values vertically and horizontally, axf:crop-offset can be used. In order to specify individual values, axf:crop-offset-top, axf:crop-offset-bottom, axf:crop-offset-left, and axf:crop-offset-right can be used. When axf:crop-offset and others are specified simultaneously, individual axf:crop-offset-* properties take priority.

These properties are not available with AH Formatter V7.0 Lite.

Specifies whether to display the area that is extended beyond the trim size.

Specifies whether the area that overflows on the margin specified with axf:crop-offset is clipped with the trim size or the extended area is displayed.

These properties are not available with AH Formatter V7.0 Lite.

Specifies the width of the bleed region for cutting off. [CSS3-GCPM] Page marks and bleed area (“bleed” has been removed from GCPM on and after May 13, 2014)

The region of the bleed is taken outside the trim size. In order to specify the same values vertically and horizontally, axf:bleed can be used. In order to specify individual values, axf:bleed-top, axf:bleed-bottom, axf:bleed-left, and axf:bleed-right can be used. When axf:bleed and others are specified simultaneously, individual axf:bleed-* properties take priority.

These properties are not available with AH Formatter V7.0 Lite.

Specifies the Printing marks, such as a crop mark. Specifies the action of external link. [CSS3-GCPM] Page marks and bleed area (“marks” has been removed from GCPM on and after May 13, 2014)

Values have the following meanings.

crop

Outputs corner marks. Outputs corner marks to the position of the trim size and the position of the bleed region if it exists. When corner marks are output to both the position of the trim size and the position of the bleed region, they are combinations of crop marks and bleed marks in Japanese style.

crop-trim

Outputs corner marks only to the position of the trim size (crop marks).

cross

Outputs cross-shaped marks.

cross-circle

Outputs cross-shaped marks with concentric circle.

cross-registration

Outputs registration marks.

<uri-specification>

Original printer marks, color bars, etc. can be outputted by specifying images, such as SVG. two or more URIs can be specified.

This property is not available with AH Formatter V7.0 Lite.

Specifies the line color of printer marks.

When the value is auto, the color is regarded as the registration color.

This property is not available with AH Formatter V7.0 Lite.

Specifies the line length of printer marks.

When the value is auto, the length depends on the system setting. The default length of a printer mark is 10mm, it can be adjusted in the Option Setting File.

This property is not available with AH Formatter V7.0 Lite.

Specifies the line width of printer marks.

When the value is auto, the width depends on the system setting. The default width of a printer mark is 0.24pt, it can be adjusted in the Option Setting File.

This property is not available with AH Formatter V7.0 Lite.

Specifies the margin between the page and the printer marks when bleed is 0.

When the value is auto, the margin depends on the system setting. The default margin is 3mm, it can be adjusted in the Option Setting File.

This property is not available with AH Formatter V7.0 Lite.

Specifies the spine width of the facing page.

When a value greater than 0pt is specified, the printing image is assumed to be constructed as facing pages, the center mark of the spine will be outputted as a spine-width printer mark.

This property is not available with AH Formatter V7.0 Lite.

Selects the printer tray.

Effective only with the Windows version and functions when outputting to a printer. Whether it is effective also depends on a printer. What can be specified by the character string is the tray name which comes out in each printer setting dialog. This is the tray name acquired from a printer driver. The specified name which does not match to the tray name acquired from a printer driver is invalid. The specified integer needs to match to the tray number acquired from a printer driver.

This property is not available with AH Formatter V7.0 Lite.

Specifies to print in duplex mode.

Effective only with the Windows version and functions when outputting to a printer. Whether it is effective also depends on a printer. Specify the value that is specified by the printer driver. Most printers support following integer values.

1. Simplex Printing.
2. Duplex Printing. Flip on Long Edge.
3. Duplex Printing. Flip on Short Edge.

See also SeparatePrinterDuplexJob in the Option Setting File. This property is not available with AH Formatter V7.0 Lite.

Specifies the overprint.

Values have the following meanings.

auto

The setting of the overprint in the Option Setting File is adopted. If you specify overprint="k100" in the Option Setting File, even if nothing is specified in FO, black overprinting will be done on all pages.

<color>

Specifies a color you want to apply the overprint. A color with alpha value cannot be specified.

k100

Applies the overprint to rgb-icc(#CMYK,0,0,0,1).

separation

Applies the overprint to the separation color shown rgb-icc (#Separation). The registration color is not included.

all

Applies the overprint to all colors except for a color with alpha value.

stroke

Applies the overprint for the line stroke.

paint

Applies the overprint for the paint.

full

nonzero

Specifies the operation in case the color ingredient is 0 when applying the overprint. When full is specified, the color ingredient is set to 0, when nonzero is specified, the color ingredient is not changed. (It is considered as no color.) This setting is effective only with CMYK.

none

The overprint is not applied.

If you specify only the color as follows:

it is considered as follows:

In addition, when neither stroke nor paint is specified, it is considered that stroke and paint are specified. Please specify none to remove them from the overprint.

1. <color>
2. k100
3. separation
4. all

The effect of the overprint varies by the actual printing environment, in relation between the background color and the foreground color with overprint specified. The effect of the typical overprint by the color space is shown below. When color-conversion="all-cmyk" is specified in the Option Setting File, RGB serves as CMYK.

See also 4.5.6 Overprint Control in “PDF Reference, ISO 32000-1” for more details.

This property is not available with AH Formatter V7.0 Lite.

The axf:repeat-page-sequence-master specifies the repetition of the page sequence.

When the value is true, if the page output reaches in the end of fo:page-sequence-master and the page which should still be outputted remains, page output repeats from the start of fo:page-sequence-master.

This property is not available with AH Formatter V7.0 Lite.

Outputs pages in reverse order.

Values have the following meanings.

true

Outputs pages in reverse order.

false

Outputs pages in order.

Specifies whether to output pages within fo:page-sequence in reverse order. This setting does not cover all the output destinations. Effective only with PDF output. PDF output in multi separate volume is not available. In case of CSS, this setting can be specified for the <html> element only.

This property is not available with AH Formatter V7.0 Lite.

:last, :only are extended. [CSS3-Page] Page selectors

• :last

  The last page of the pages belonging to the specified @page.

• :only

  A single page that is the first and last, belonging to the specified @page.

axf:suppress-if-first-on-page specifies whether to suppress the block at the beginning of a page or column.

Values have the following meanings.

false

Does nothing.

true

Suppresses a block when it comes at the beginning of a page or column. Since it is actually not deleted but exists without display as a block of size zero, it's effective to refer to ID, etc.

This property is not available with AH Formatter V7.0 Lite.

Specifies the block transformation. [CSS3-Transforms] The ‘transform’ Property

Values have the following meanings.

none

Does not transform the block.

<transform-function>

Performs the specified transformation. The following transformations can be specified.

• matrix(<number>, <number>, <number>, <number>, <number>, <number>)
• translate(<translation-value>[, <translation-value>])
• translateX(<translation-value>)
• translateY(<translation-value>)
• scale(<number>[, <number>])
• scaleX(<number>)
• scaleY(<number>)
• rotate(<angle>)
• skew(<angle>[, <angle>])
• skewX(<angle>)
• skewY(<angle>)

This property is not available with AH Formatter V7.0 Lite.

Specifies the origin of the block transformation. [CSS3-Transforms] The ‘transform-origin’ Property

This property is not available with AH Formatter V7.0 Lite.

Sets or clears the baseline grid.

Values have the following meanings.

normal

Neither sets nor clears the baseline grid.

none

Clears the baseline grid and the content will not align with a baseline grid.

new

Sets a new baseline grid. The new baseline grid is established by using the font and the line-height settings of this element.

root

Sets the baseline grid defined by the root element. The root baseline grid is defined by using the font and the line-height settings of the root element.

Inside the area line that a baseline grid is set, the lines are aligned with baselines on the baseline grid. Half-leading is not added before the first line and after the last line so that the em-box edges are aligned with the before and after edges of the content box.

The baseline grid is not available in the area with display-align other than auto.

An HTML+CSS example with baseline grids:

:root {
  font-size: 10pt;
  line-height: 18pt;
  font-family: "Yu Mincho", serif;
}

@page {
  size: 128mm 188mm;
  margin: auto;
  width: 28rem;
  height: calc(24rlh - (1rlh - 1rem));
}

body {
  -ah-baseline-grid: root;
}

h1 {
  -ah-baseline-grid: new;
  -ah-baseline-block-snap: center;
  font-size: 16pt;
  line-height: 20pt;
  margin-top: 16pt;
  margin-bottom: 16pt;
}

figure {
  -ah-baseline-grid: none;
  -ah-baseline-block-snap: auto;
}

An XSL-FO example with baseline grids:

<fo:root xmlns:fo="http://www.w3.org/1999/XSL/Format"
         xmlns:axf="http://www.antennahouse.com/names/XSL/Extensions"
         font-size="10pt" line-height="18pt" font-family="Yu Mincho, serif">
  ...
  <fo:page-sequence master-reference="master">
    <fo:flow flow-name="xsl-region-body" axf:baseline-grid="root">
      <fo:block axf:baseline-grid="new" axf:baseline-block-snap="center"
          font-size="16pt" line-height="20pt" space-before="16pt" space-after="16pt">
        Heading ...
      </fo:block>
      <fo:block>The quick brown fox jumps ...</fo:block>
      ...
      <fo:block axf:baseline-grid="none" axf:baseline-block-snap="auto">
         Figure ...
      </fo:block>
      ...
    </fo:flow>
  </fo:page-sequence>
</fo:root>

This property is not available with AH Formatter V7.0 Lite.

Specifies how to align blocks on the baseline grid.

Values have the following meanings.

none

The block is not aligned with the baseline grid.

auto

Same as “before” on top of column, same as “after” at bottom of column, otherwise “center”.

before

The before edge of the block is aligned with a text-before-edge baseline on the baseline grid.

after

The after edge of the block is aligned with a text-after-edge baseline on the baseline grid.

center

The block is centered between a text-before-edge and a text-after-edge baselines on the baseline grid.

border-box

The border edge is used to align the block on the baseline grid.

margin-box

The margin edge is used to align the block on the baseline grid.

This property specifies how to align blocks other than normal line boxes, such as headings, figures and tables, on the baseline grid.

See axf:baseline-grid for usage.

This property is not available with AH Formatter V7.0 Lite.

The axf:line-break specifies the method of line breaking. [CSS3-Text] Breaking Rules for Punctuation: the ‘line-break’ property

Values have the following meanings.

auto V7.0

It is assumed that normal is specified.

normal

CJK Nonstarter characters (prolonged sound mark, small hiragana letters, small katakana letters, and iteration marks) defined in JIS X 4051:2004 are not treated as Nonstarter characters. Characters marked with [NS] in the following list are processed.

strict

CJK Nonstarter character is treated. Characters marked with [NS] and [JIS] in the following list are processed.

line V7.0

Line breaking is performed one by one by a simple algorithm.

bpil V7.0

Line breaking is performed according to the line breaking algorithm by Knuth-Plass's Breaking Paragraphs into Lines. At this time, the bpil specification in the Option Setting File is ignored. Depending on the conditions, this algorithm may not be applicable. See Line Breaking in Technical Notes.

If neither normal nor strict is specified, it is assumed that normal is specified. When neither line nor bpil is specified, the algorithm is selected according to the specification of bpil in the Option Setting File. See Line Breaking in Technical Notes for details.

The line breaking other than Nonstarter characters in CJK complies with UAX#14: Line Breaking Properties. At this time, characters specified to the properties of axf:append-non-starter-characters, axf:except-non-starter-characters, axf:append-non-end-of-line-characters and axf:except-non-end-of-line-characters are included.

The CJK Nonstarter character is as follows. [NS] is classified into NS in Line Break Properties. [JIS] is classified into the Nonstarter character in JIS X 4051:2004.

Specifies the append-non-starter-characters in CJK.

The characters included in <string> can be appended to the non-starter-characters. If the specified characters are also specified in axf:except-non-starter-characters as well in the same tag, the effect could be wrong. White space characters are disregarded even though they are specified. Closing parentheses and punctuation marks are automatically treated as except-non-starter characters without adding them. The initial value of non-starter-characters can be set by append-non-starter-characters in the Option Setting File.

Specifies the except-non-starter-characters in CJK.

The characters included in <string> can be eliminated from the non-starter-characters. If the specified characters are also specified to axf:append-non-starter-characters in the same tag as well, the effect is not guaranteed. White space characters are disregarded even though they are specified. The initial value of non-starter-characters can be set by append-non-starter-characters in the Option Setting File.

Specifies the append-non-end-of-characters in CJK.

The characters included in <string> can be appended to the non-end-of-line-characters. If the specified characters are also specified to axf:except-non-end-of-line-characters as well in the same tag, the effect could be wrong. White space characters are disregarded even though they are specified. Opening parentheses etc. are automatically treated as except-non-end-of-line characters without adding them. The initial value of non-end-of-line-characters can be set by append-non-end-of-line-characters in the Option Setting File.

Specifies the except-non-end-of-characters in CJK.

The characters included in <string> can be eliminated from the non-end-of-line-characters. If the specified characters are also specified to axf:append-non-end-of-line-characters in the same tag as well, the effect is not guaranteed. White space characters are disregarded even though they are specified. The initial value of non-end-of-line-characters can be set by append-non-end-of-line-characters in the Option Setting File.

The axf:word-break specifies whether to enable line breaking even inside a word. [CSS3-Text] Breaking Rules for Letters: the ‘word-break’ property

Values have the following meanings.

normal

Follows a normal line breaking rule.

keep-all

Does not break inside words. A word here indicates a character string which consists of the following category (General Category) of Unicode.

• Letter
• Mark
• Number

Whether to break lines on a boundary with characters other than these follows the rule of the standard line break. Moreover, hyphenate="true" is disregarded.

break-all

The line breaking is enabled between all the characters in the word. This is effective only with the following scripts.

• Latn
• Cyrl
• Grek
• Zyyy

axf:word-wrap="normal" is disregarded.

Within the word oriented upright by axf:text-orientation="upright", it is always regarded as axf:word-break="break-all".

Specifies whether to break word forcibly when line break cannot be performed. [CSS3-Text] Overflow Wrapping: the overflow-wrap/word-wrap property

Values have the following meanings.

normal

The line is not broken forcibly. The text will overflow across the region.

break-word

The line is broken forcibly at an appropriate position.

The axf:hyphenation-minimum-character-count specifies the minimum number of characters a word must have before it can be hyphenated.

The axf:hyphenation-minimum-character-count must be an integer number of 1 or more.

axf:hyphenation-zone limits the range where a hyphenation is available.

Values have the following meanings.

none

Nothing is limited in hyphenation.

<length>

If the length from the end of a word to the end of line is less or equal to the specified value, the following word is not hyphenated.
It is invalid when 0 or less value is specified.

Specifies whether to hyphenate the already hyphenated word or not.

Values have the following meanings.

true

Hyphenates a word.

false

Does not hyphenate a word. The line may break only at the hyphen position.

The followings are recognized as hyphens.

This setting is invalid when hyphenate="false" is specified.

Specifies whether to hyphenate words consisting of upper cases. V7.0

Values have the following meanings.

true

Hyphenates a word.

false

Does not hyphenate a word.

A phrase like ANTENNA-HOUSE with hyphens is considered multiple words. There is a possibility of a line break at the hyphen position. Even letters processed as small-caps are considered lower cases if the original letters are lower cases. This setting is invalid when hyphenate="false" is specified.

[CSS3-GCPM] Hyphenate properties (“hyphenate-after” has been removed from GCPM on and after November 29, 2011)

☞ [XSL 1.1] hyphenation-push-character-count, hyphenation-push-character-count

[CSS3-GCPM] Hyphenate properties (“hyphenate-before” has been removed from GCPM on and after November 29, 2011)

☞ [XSL 1.1] hyphenation-remain-character-count, hyphenation-remain-character-count

[CSS3-GCPM] Hyphenate properties (“hyphenate-character” has been removed from GCPM on and after November 29, 2011)

☞ [XSL 1.1] hyphenation-character

[CSS3-GCPM] Hyphenate properties (“hyphenate-lines” has been removed from GCPM on and after November 29, 2011)

☞ [XSL 1.1] hyphenation-ladder-count

[CSS3-Text] Hyphenation Control: the ‘hyphens’ property

☞ [XSL 1.1] hyphenate

Values have the following meanings.

auto

SOFT HYPHEN is deleted except when needed for line breaking. (normal)

preserve

SOFT HYPHEN is not deleted and the target glyph is output.

Specifies whether to treat full width punctuations in Japanese. [CSS3-Text] Fullwidth Punctuation Kerning: the ‘punctuation-trim’ property (“punctuation-trim” has been removed from CSS3-Text on and after January 19, 2012 after the transition of name)

Values have the following meanings.

none

Punctuation characters are not trimmed.

start

Punctuation characters (open parenthesis etc.) at start of line are trimmed.

start-except-first

Same as the start value except for a start line of a paragraph or a line right after the forced line break.

end

When text-align="right" or text-align="justify" (or text-align-last="justify") is specified and full width punctuation marks (closing parenthesis etc.) come to the end of the sentence, the character is treated as half width forcibly.

allow-end

When text-align="right" or text-align="justify" (or text-align-last="justify") is specified and full width punctuation marks (closing parenthesis etc.) come to the end of the sentence, characters are treated as full width if text fits into one line, characters are treated as half width if text does not fit into one line.

end-except-fullstop

Behaves as the same as the end value except for the following two characters.

U+3002	IDEOGRAPHIC FULL STOP	。
U+FF0E	FULLWIDTH FULL STOP	．

adjacent

The space between a full width punctuation and a full width character in Japanese is trimmed.

• Between full width close parenthesis and full width open parenthesis.
• Between full width close parenthesis and full width close parenthesis.
• Between full width close parenthesis and full width middle dots.
• Between full width close parenthesis and full width space.
• Between full width close parenthesis and full width non punctuation characters.
• Between full width open parenthesis and full width open parenthesis.
• Between full width middle dots and full width open parenthesis.
• Between full width space and full width open parenthesis.
• Between full width non punctuation character and full width open parenthesis.

Full width punctuation characters are treated the same as full width close parenthesis. The adjacent value is equivalent to axf:kerning-mode="contextual" with XSL Formatter V4.

all

Trim all parentheses, middle dots, and punctuations of full width and treat them as half width.

<string>

Behave the same as all, but only the character included in the character strings specified here is treated as a half width. Other than parentheses, middle dots, and punctuations of full width are disregarded.

auto

Dependent on the system setting. It is regarded as “none” or “start end adjacent” by punctuation-trim in the Option Setting File.

Full width punctuation open parenthesis processed by axf:punctuation-trim are:

Full width punctuation close parenthesis processed by axf:punctuation-trim are:

Full width punctuations processed by axf:punctuation-trim are:

Full width middle dots processed by axf:punctuation-trim are:

axf:punctuation-trim doesn't affect the proportional font. Also, it is always regarded as none when anything other than auto is specified for glyph-orientation-*.

Specifies the way to trim in text justification. [CSS3-Text] Additional compression: The 'text-justify-trim' property (“text-justify-trim” has been removed from CSS3-Text on and after June 27, 2005)

Values have the following meanings.

none

Do not trim Japanese text.

punctuation

Trim text with parentheses, middle dots, and punctuations of full width in Japanese.

punctuation-except-fullstop

Behaves as the same as the punctuation value except for the following two characters.

U+3002	IDEOGRAPHIC FULL STOP	。
U+FF0E	FULLWIDTH FULL STOP	．

punctuation-except-middledot

Behaves as the same as the punctuation value except for the following middle dots.

U+30FB	KATAKANA MIDDLE DOT	・
U+FF1A	FULLWIDTH COLON	：
U+FF1B	FULLWIDTH SEMICOLON	；

kana

Trim Hiragana and Katakana a bit.

ideograph

Trim spaces between Kanji or Kana.

inter-word

Trim spaces between Western words.

auto

Dependent on the system setting. This is the value specified by punctuation-trim and text-justify-mode in the Option Setting File. However, when axf:avoid-widow-words is enabled, it is considered as “ideograph inter-word” specified.

Trim the spaces between characters as specified so that text fits into a line. When axf:punctuation-trim="all" is specified, there may be no more space to trim.

Specifies how to justify text. [CSS3-Text] Justification Method: the ‘text-justify’ property

Values have the following meanings.

auto

Uses the best text justification method for the script. For instance, in case of Japanese Kanji, Hiragana and Katakana, spaces between letters are expanded. In case of Arabic scripts, Kashida is used while spaces between words are expanded for the other scripts.

inter-word

Justifies text by expanding the space between words.

inter-character

Justifies text by expanding the space between letters.

distribute

Changed to inter-character with CSST-Text 2017-08-22. We also accept distribute for compatibility.

The axf:kerning-mode specifies whether to process the kerning.

Values have the following meanings.

none

The kerning is not processed.

pair

The pair kerning is processed.

auto

Dependent on the system setting.

You can specify whether pair kerning is performed or not by pair-kerning in the Option Setting File. This can also be set in the Format Option Setting dialog in GUI.

axf:kerning-mode does not work when letter-spacing is specified.

The axf:punctuation-spacing specifies the trimming spacing between a full width punctuation and a full width character in Japanese.

The initial value of this space can be set by punctuation-spacing in the Option Setting File.

Values have the following meanings.

<length>

Specifies the amount of the trimming space with an absolute value.

<percentage>

It's a relative setting to the font size when actually applied.

auto

Dependent on the system setting. This is the value specified by punctuation-spacing in the Option Setting File.

This space is used for the following space amount specified by axf:punctuation-trim="adjacent".

• Between full width close parenthesis and full width open parenthesis.
• Between full width close parenthesis and full width non punctuation characters.
• Between full width non punctuation character and full width open parenthesis.

Specifies whether to hang punctuation marks at the start of the line or end of the line. [CSS3-Text] Hanging Punctuation: the ‘hanging-punctuation’ property (“hanging-punctuation” has been removed from CSS3-Text on and after August 22, 2017)

Values have the following meanings.

none

Do not hang punctuation marks at the start of the line or end of the line.

start

Hangs punctuation marks at the start of the line. If the target character for hanging appears at the start of the line, the character is forced to hang.

first

Behaves as the same as the start value only with the start line of a paragraph.

force-end

Hangs punctuation marks at the end of the line. When text-align="right" or text-align="justify" (or text-align-last="justify") is specified and a target character for hanging appears at the end of the line, the character is hanged forcibly. When anything else is specified to text-align, the character is hung naturally.

allow-end

Hangs punctuation marks at the end of the line. When text-align="right" or text-align="justify" (or text-align-last="justify") is specified and a target character for hanging comes to the end of the line, the character is not hung if text fits into one line, but the character is hung if text does not fit into one line. When anything else is specified to text-align, the character is hung naturally.

last

Behaves the same as the force-end value only with the end of the line of a paragraph.

The target punctuation marks is as follows.

• force-end, allow-end
  Japanese or Simplified Chinese

  U+3001	IDEOGRAPHIC COMMA	、
  U+3002	IDEOGRAPHIC FULL STOP	。
  U+FF0C	FULLWIDTH COMMA	，
  U+FF0E	FULLWIDTH FULL STOP	．

  Traditional Chinese

  U+FE50	SMALL COMMA	﹐
  U+FE51	SMALL IDEOGRAPHIC	﹑
  U+FE52	SMALL FULL STOP	﹒
  U+FF64	HALFWIDTH IDEOGRAPHIC COMMA	､

  Other languages

  Same as the last value.

• last
  quotation marks, closing parentheses, period, comma and hyphen
• start, first
  quotation marks, closing parentheses and bullet

The axf:avoid-widow-words specifies spacing behavior between words or characters so that the last line of the paragraph does not have only one word left (one character for CJK).

Values have the following meanings.

false

Does nothing.

true

Adjusts the spacing so that the last line of the paragraph does not have only one word left (one character for CJK). When axf:text-justify-trim="auto" is specified, it is regarded as “ideograph inter-word” is specified.

<length> V7.0

<percentage> V7.0

Leaves the specified width of text on the last line of the paragraph. If both <length> and <percentage> are specified, the smaller one is adopted. When 0 or less is specified, it is considered as false. If it is greater than 0 and axf:text-justify-trim="auto" is specified, it is considered as "ideograph inter-word" specified. This setting is effective only when the Breaking Paragraphs into Lines line breaking algorithm is applied, such as when axf:line-break="bpil" is specified. Otherwise, the specified value of greater than 0 is considered true.

CAUTION:	The specified width is not always secured, for example, in case it is too unbalanced when the specified width is secured.

If the width of columns (length of the line) is short, when true is specified, it is not so effective because there is not enough space to run on. In addition, in case there is no room for a word to be placed at the end of the line, axf:avoid-widow-words has no effect. Please note that there may have no more space to trim by setting axf:punctuation-trim or axf:text-justify-trim. See also avoid-widow-words-CJK-punctuation in the Option Setting File to learn more about the treatment of the punctuation at the end of the line in CJK.

The axf:text-autospace specifies whether to add space surrounding ideographic glyphs or not. [CSS3-Text] Adding space: the ‘text-autospace’ property (“text-autospace” has been removed from CSS3-Text on and after April 4, 2011)

Values have the following meanings.

none

Space is not added.

ideograph-numeric

Space is added between ideograph character and non-ideographic number character. Non-ideographic number character mentioned here indicates the character of Nd classified by Unicode and the non-full-width character.

ideograph-alpha

Space is added between ideograph character and non-ideographic alphabet character. Non-ideographic alphabet character mentioned here indicates the character of Lu, Ll, Lt and Lm classified by Unicode.

ideograph-parenthesis

Space is added between ideograph character and non-ideographic parenthesis character. However space is not added between ideograph character and non-ideographic closing parenthesis or between non-ideographic opening parenthesis and ideograph character.

auto

Dependent on the system setting. It's regarded as “none” or “ideograph-numeric ideograph-alpha” according to the setting.

The initial value of whether space is added or not can be set by text-autospace in the Option Setting File. It can also be set in the Format Option Setting Dialog in the GUI.

The axf:text-autospace-width specifies the width for axf:text-autospace.

The initial value of this space can be set by text-autospace-width in the Option Setting File.

Values have the following meanings.

<length>

Specifies the amount of the space with an absolute value.

<percentage>

It's a relative setting to the font size when actually applied.

auto

Dependent on the system setting. This is the value specified by text-autospace-width in the Option Setting File.

This space is used in axf:text-autospace.

Specifies on which side of the character the space by letter-spacing is distributed.

Values have the following meanings.

both

Half the amount of space is distributed on both side of the character for each.

start

The space is distributed only on the start side of the character.

end

The space is distributed only on the end side of the character.

Changes letter-spacing depending on the number of characters.

Values have the following meanings.

none

Does not specify letter-spacing.

Values can be enumerated corresponding to the number of characters of 2 or more. For example, if specified as follows:

when the number of characters in this FO is 2, then letter-spacing="2em" is applied. When 3 characters, then letter-spacing="1em" is applied. When 4 characters, then letter-spacing="0.5em" is applied. When 5 characters, then letter-spacing="0.25em" is applied. Does nothing with any other number of characters. Only the characters included in the first inline element are counted.

This property is defined mainly for use in chapter titles in CJK text. In the following case,

It is better to use this together with axf:letter-spacing-side as follows.

It is not possible to apply this property to text (such as page numbers, etc.) for which the number of characters is not fixed.

This property is not available with AH Formatter V7.0 Lite.

Specifies how to treat the margin when the page/column breaks.

Values have the following meanings.

auto

Retains the margin on the before side of the block placed at the start of the document or right after the forced page/column break. Except for that, it is the same as discard.

discard

Discards the margin.

keep

Retains the margin on the before side. When the second keep is specified, the margin on the after side is also retained.

Specifies whether the newline right after the start tag is disregarded or not.

Values have the following meanings.

false

The newline right after the start tag is not disregarded.

true

The newline right after the start tag is disregarded.

auto

The newline right after the start tag is disregarded with HTML, not disregarded with XHTML.

This is effective with the element that does not disregard the newline like <pre>.

axf:text-align-string specifies the text alignment when text-align="<string>".

Values have the following meanings.

start

center

end

inside

outside

left

right

Same as text-align or text-align-last.

Although the specification of <string> to fo:table-cell aligns the character position of decimal point, etc., there is no definition for the alignment of the whole character string. At a default, AH Formatter V7.0 displayed it right aligned according to the illustration of 17.5.4 Horizontal alignment in a column. AH Formatter V7.0 extends the alignment and makes it possible to align left or align center

axf:text-align-first specifies the text alignment of the first line.

Values have the following meanings.

relative

Does nothing. axf:text-align-first is invalid.

start

center

end

justify

inside

outside

left

right

Same as text-align or text-align-last.

Specifies the alignment of the child of the first line area and the alignment of the line coming right after the line with U+000A at the end. Priority is given above text-align-last.

See axf:leader-expansion.

Adjusts the space at the end of the last line. V7.0 no-LT

Values have the following meanings.

none

Does nothing.

<length>

<percentage>

If text-align="justify" is specified but text-align-last="justify" are not specified, and the space at the end of the last line is less than or equal to the specified value, the last line is processed as text-align-last="justify" is specified.

This property is not available with AH Formatter V7.0 Lite.