Add support to li value property of ordered list ol

DEVSIX-2455

Author: pkjuak

layout/src/main/java/com/itextpdf/layout/element/ListItem.java

@@ -44,8 +44,8 @@ This file is part of the iText (R) project.
 package com.itextpdf.layout.element;
 
 import com.itextpdf.kernel.pdf.tagging.StandardRoles;
-import com.itextpdf.kernel.pdf.tagutils.DefaultAccessibilityProperties;
 import com.itextpdf.kernel.pdf.tagutils.AccessibilityProperties;
+import com.itextpdf.kernel.pdf.tagutils.DefaultAccessibilityProperties;
 import com.itextpdf.layout.property.ListNumberingType;
 import com.itextpdf.layout.property.ListSymbolPosition;
 import com.itextpdf.layout.property.Property;
@@ -75,6 +75,17 @@ public ListItem(String text) {
         add(new Paragraph(text).setMarginTop(0).setMarginBottom(0));
     }
 
+    /**
+     * Customizes the index of the item in the list.
+     *
+     * @param ordinalValue the custom value property of an ordered list's list item.
+     * @return this listItem.
+     */
+    public ListItem setListSymbolOrdinalValue(int ordinalValue) {
+        setProperty(Property.LIST_SYMBOL_ORDINAL_VALUE, ordinalValue);
+        return this;
+    }
+
     /**
      * Creates a list item with an image.
      *
@@ -97,6 +108,7 @@ public <T1> T1 getDefaultProperty(int property) {
 
     /**
      * Sets the list item symbol to be used.
+     *
      * @param symbol the textual symbol to be used for the item.
      * @return this list item.
      */
@@ -106,6 +118,7 @@ public ListItem setListSymbol(String symbol) {
 
     /**
      * Sets the list item symbol to be used.
+     *
      * @param text the {@link Text} object to be used for the item.
      * @return this list item.
      */
@@ -116,6 +129,7 @@ public ListItem setListSymbol(Text text) {
 
     /**
      * Sets the list item symbol to be used.
+     *
      * @param image the {@link Image} object to be used for the item.
      * @return this list.
      */
@@ -126,6 +140,7 @@ public ListItem setListSymbol(Image image) {
 
     /**
      * Sets the list item numbering type to be used.
+     *
      * @param listNumberingType the {@link ListNumberingType} that will generate appropriate prefixes for the {@link ListItem}.
      * @return this list item.
      */

layout/src/main/java/com/itextpdf/layout/property/Property.java

@@ -89,8 +89,10 @@ private Property() {
     public static final int FIRST_LINE_INDENT = 18;
     public static final int FLOAT = 99;
     public static final int FLUSH_ON_DRAW = 19;
+
     /**
      * Font family as String or PdfFont shall be set.
+     *
      * @see com.itextpdf.io.font.constants.StandardFontFamilies
      */
     public static final int FONT = 20;
@@ -139,6 +141,7 @@ private Property() {
     public static final int LIST_SYMBOL = 37;
     public static final int LIST_SYMBOL_ALIGNMENT = 38;
     public static final int LIST_SYMBOL_INDENT = 39;
+    public static final int LIST_SYMBOL_ORDINAL_VALUE = 120;
     public static final int LIST_SYMBOL_PRE_TEXT = 41;
     public static final int LIST_SYMBOL_POSITION = 83;
     public static final int LIST_SYMBOL_POST_TEXT = 42;

layout/src/main/java/com/itextpdf/layout/renderer/ListRenderer.java

@@ -45,8 +45,8 @@ This file is part of the iText (R) project.
 
 
 import com.itextpdf.io.LogMessageConstant;
-import com.itextpdf.io.util.MessageFormatUtil;
 import com.itextpdf.io.font.constants.StandardFonts;
+import com.itextpdf.io.util.MessageFormatUtil;
 import com.itextpdf.io.util.TextUtil;
 import com.itextpdf.kernel.font.PdfFont;
 import com.itextpdf.kernel.font.PdfFontFactory;
@@ -67,13 +67,12 @@ This file is part of the iText (R) project.
 import com.itextpdf.layout.property.ListSymbolPosition;
 import com.itextpdf.layout.property.Property;
 import com.itextpdf.layout.property.UnitValue;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
 import com.itextpdf.layout.tagging.LayoutTaggingHelper;
-
 import java.io.IOException;
 import java.util.ArrayList;
 import java.util.List;
+import org.slf4j.Logger;
+import org.slf4j.LoggerFactory;
 
 public class ListRenderer extends BlockRenderer {
 
@@ -271,7 +270,7 @@ private LayoutResult correctListSplitting(IRenderer splitRenderer, IRenderer ove
         ListRenderer newOverflowRenderer = (ListRenderer) createOverflowRenderer(LayoutResult.PARTIAL);
         newOverflowRenderer.deleteOwnProperty(Property.FORCED_PLACEMENT);
         // ListItemRenderer for not rendered children of firstListItemRenderer
-        newOverflowRenderer.childRenderers.add(((ListItemRenderer)firstListItemRenderer).createOverflowRenderer(LayoutResult.PARTIAL));
+        newOverflowRenderer.childRenderers.add(((ListItemRenderer) firstListItemRenderer).createOverflowRenderer(LayoutResult.PARTIAL));
         newOverflowRenderer.childRenderers.addAll(splitRenderer.getChildRenderers().subList(1, splitRenderer.getChildRenderers().size()));
 
         List<IRenderer> childrenStillRemainingToRender =
@@ -302,9 +301,10 @@ private LayoutResult correctListSplitting(IRenderer splitRenderer, IRenderer ove
     private LayoutResult initializeListSymbols(LayoutContext layoutContext) {
         if (!hasOwnProperty(Property.LIST_SYMBOLS_INITIALIZED)) {
             List<IRenderer> symbolRenderers = new ArrayList<>();
-            int listItemNum = (int) this.<Integer>getProperty(Property.LIST_START, 1);
+            int listItemNum = (int)this.<Integer>getProperty(Property.LIST_START, 1);
             for (int i = 0; i < childRenderers.size(); i++) {
                 childRenderers.get(i).setParent(this);
+                listItemNum = (childRenderers.get(i).<Integer>getProperty(Property.LIST_SYMBOL_ORDINAL_VALUE) != null) ? (int) childRenderers.get(i).<Integer>getProperty(Property.LIST_SYMBOL_ORDINAL_VALUE) : listItemNum;
                 IRenderer currentSymbolRenderer = makeListSymbolRenderer(listItemNum, childRenderers.get(i));
                 LayoutResult listSymbolLayoutResult = null;
                 if (currentSymbolRenderer != null) {