Oxygen XML Author plugin 13.2.0

Author Developer Guide | 225Figure 110: Columns with custom widthsConfiguring a Table Cell Span ProviderIn the documentation framework the table element can have cells that span over multiple columns and rows. Asexplained in the Styling the Table Element section which describes the CSS properties needed for defining a table, youneed to indicate Oxygen XML Author plugin a method to determine the cell spanning. If you use the cell elementattributes rowspan and colspan or rows and cols, Oxygen XML Author plugin can determine the cell spanningautomatically. In our example the td element uses the attributes row_span and column_span that are not recognizedby default. You will need to implement a Java extension class for defining the cell spanning.Note: The Javadoc documentation of the Author API used in the example files is available on the Oxygen XMLwebsite. Also it can be downloaded as a zip archive from the website.1. Create the class simple.documentation.framework.TableCellSpanProvider. This class mustimplement the ro.sync.ecss.extensions.api.AuthorTableCellSpanProvider interface.import ro.sync.ecss.extensions.api.AuthorTableCellSpanProvider;import ro.sync.ecss.extensions.api.node.AttrValue;import ro.sync.ecss.extensions.api.node.AuthorElement;public class TableCellSpanProviderimplements AuthorTableCellSpanProvider {2. The init method is taking as argument the ro.sync.ecss.extensions.api.node.AuthorElementthat represents the XML table element. In our case the cell span is specified for each of the cells so you leave thismethod empty. However there are cases like the table CALS model when the cell spanning is specified in the tableelement. In such cases you must collect the span information by analyzing the table element.public void init(AuthorElement table) {}3. The getColSpan method is taking as argument the table cell. The table layout engine will ask thisAuthorTableSpanSupport implementation what is the column span and the row span for each XML elementfrom the table that was marked as cell in the CSS using the property display:table-cell. The implementationis simple and just parses the value of column_span attribute. The method must return null for all the cells that donot change the span specification.public Integer getColSpan(AuthorElement cell) {Integer colSpan = null;AttrValue attrValue = cell.getAttribute("column_span");if(attrValue != null) {// The attribute was found.