All Downloads are FREE. Search and download functionalities are using the official Maven repository.

com.lowagie.text.html.Markup Maven / Gradle / Ivy

There is a newer version: 1.2.2.1-jre17
Show newest version
/*
 * $Id: Markup.java 3654 2009-01-21 16:11:00Z blowagie $
 *
 * Copyright 2001, 2002 by Bruno Lowagie.
 *
 * The contents of this file are subject to the Mozilla Public License Version 1.1
 * (the "License"); you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at http://www.mozilla.org/MPL/
 *
 * Software distributed under the License is distributed on an "AS IS" basis,
 * WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
 * for the specific language governing rights and limitations under the License.
 *
 * The Original Code is 'iText, a free JAVA-PDF library'.
 *
 * The Initial Developer of the Original Code is Bruno Lowagie. Portions created by
 * the Initial Developer are Copyright (C) 1999, 2000, 2001, 2002 by Bruno Lowagie.
 * All Rights Reserved.
 * Co-Developer of the code is Paulo Soares. Portions created by the Co-Developer
 * are Copyright (C) 2000, 2001, 2002 by Paulo Soares. All Rights Reserved.
 *
 * Contributor(s): all the names of the contributors are added in the source code
 * where applicable.
 *
 * Alternatively, the contents of this file may be used under the terms of the
 * LGPL license (the "GNU LIBRARY GENERAL PUBLIC LICENSE"), in which case the
 * provisions of LGPL are applicable instead of those above.  If you wish to
 * allow use of your version of this file only under the terms of the LGPL
 * License and not to allow others to use your version of this file under
 * the MPL, indicate your decision by deleting the provisions above and
 * replace them with the notice and other provisions required by the LGPL.
 * If you do not delete the provisions above, a recipient may use your version
 * of this file under either the MPL or the GNU LIBRARY GENERAL PUBLIC LICENSE.
 *
 * This library is free software; you can redistribute it and/or modify it
 * under the terms of the MPL as stated above or under the terms of the GNU
 * Library General Public License as published by the Free Software Foundation;
 * either version 2 of the License, or any later version.
 *
 * This library is distributed in the hope that it will be useful, but WITHOUT
 * ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
 * FOR A PARTICULAR PURPOSE. See the GNU Library general Public License for more
 * details.
 *
 * Contributions by:
 * Lubos Strapko
 * 
 * If you didn't download this code from the following link, you should check if
 * you aren't using an obsolete version:
 * https://github.com/LibrePDF/OpenPDF
 */

package com.lowagie.text.html;

import javax.annotation.Nonnull;
import javax.annotation.Nullable;
import java.awt.Color;
import java.util.Locale;
import java.util.Properties;
import java.util.StringTokenizer;

/**
 * A class that contains all the possible tagnames and their attributes.
 */

public class Markup {

    // iText specific

    /** the key for any tag */
    public static final String ITEXT_TAG = "tag";

    // HTML tags

    /** the markup for the body part of a file */
    public static final String HTML_TAG_BODY = "body";

    /** The DIV tag. */
    public static final String HTML_TAG_DIV = "div";

    /** This is a possible HTML-tag. */
    public static final String HTML_TAG_LINK = "link";

    /** The SPAN tag. */
    public static final String HTML_TAG_SPAN = "span";

    // HTML attributes

    /** the height attribute. */
    public static final String HTML_ATTR_HEIGHT = "height";

    /** the hyperlink reference attribute. */
    public static final String HTML_ATTR_HREF = "href";

    /** This is a possible HTML attribute for the LINK tag. */
    public static final String HTML_ATTR_REL = "rel";

    /** This is used for inline css style information */
    public static final String HTML_ATTR_STYLE = "style";

    /** This is a possible HTML attribute for the LINK tag. */
    public static final String HTML_ATTR_TYPE = "type";

    /** This is a possible HTML attribute. */
    public static final String HTML_ATTR_STYLESHEET = "stylesheet";

    /** the width attribute. */
    public static final String HTML_ATTR_WIDTH = "width";

    /** attribute for specifying externally defined CSS class */
    public static final String HTML_ATTR_CSS_CLASS = "class";

    /** The ID attribute. */
    public static final String HTML_ATTR_CSS_ID = "id";

    // HTML values

    /** This is a possible value for the language attribute (SCRIPT tag). */
    public static final String HTML_VALUE_JAVASCRIPT = "text/javascript";

    /** This is a possible HTML attribute for the LINK tag. */
    public static final String HTML_VALUE_CSS = "text/css";

    // CSS keys

    /** the CSS tag for background color */
    public static final String CSS_KEY_BGCOLOR = "background-color";

    /** the CSS tag for text color */
    public static final String CSS_KEY_COLOR = "color";

    /** CSS key that indicate the way something has to be displayed */
    public static final String CSS_KEY_DISPLAY = "display";

    /** the CSS tag for the font family */
    public static final String CSS_KEY_FONTFAMILY = "font-family";

    /** the CSS tag for the font size */
    public static final String CSS_KEY_FONTSIZE = "font-size";

    /** the CSS tag for the font style */
    public static final String CSS_KEY_FONTSTYLE = "font-style";

    /** the CSS tag for the font weight */
    public static final String CSS_KEY_FONTWEIGHT = "font-weight";

    /** the CSS tag for text decorations */
    public static final String CSS_KEY_LINEHEIGHT = "line-height";

    /** the CSS tag for the margin of an object */
    public static final String CSS_KEY_MARGIN = "margin";

    /** the CSS tag for the margin of an object */
    public static final String CSS_KEY_MARGINLEFT = "margin-left";

    /** the CSS tag for the margin of an object */
    public static final String CSS_KEY_MARGINRIGHT = "margin-right";

    /** the CSS tag for the margin of an object */
    public static final String CSS_KEY_MARGINTOP = "margin-top";

    /** the CSS tag for the margin of an object */
    public static final String CSS_KEY_MARGINBOTTOM = "margin-bottom";

    /** the CSS tag for the margin of an object */
    public static final String CSS_KEY_PADDING = "padding";

    /** the CSS tag for the margin of an object */
    public static final String CSS_KEY_PADDINGLEFT = "padding-left";

    /** the CSS tag for the margin of an object */
    public static final String CSS_KEY_PADDINGRIGHT = "padding-right";

    /** the CSS tag for the margin of an object */
    public static final String CSS_KEY_PADDINGTOP = "padding-top";

    /** the CSS tag for the margin of an object */
    public static final String CSS_KEY_PADDINGBOTTOM = "padding-bottom";

    /** the CSS tag for the margin of an object */
    public static final String CSS_KEY_BORDERCOLOR = "border-color";

    /** the CSS tag for the margin of an object */
    public static final String CSS_KEY_BORDERWIDTH = "border-width";

    /** the CSS tag for the margin of an object */
    public static final String CSS_KEY_BORDERWIDTHLEFT = "border-left-width";

    /** the CSS tag for the margin of an object */
    public static final String CSS_KEY_BORDERWIDTHRIGHT = "border-right-width";

    /** the CSS tag for the margin of an object */
    public static final String CSS_KEY_BORDERWIDTHTOP = "border-top-width";

    /** the CSS tag for the margin of an object */
    public static final String CSS_KEY_BORDERWIDTHBOTTOM = "border-bottom-width";

    /** the CSS tag for adding a page break when the document is printed */
    public static final String CSS_KEY_PAGE_BREAK_AFTER = "page-break-after";

    /** the CSS tag for adding a page break when the document is printed */
    public static final String CSS_KEY_PAGE_BREAK_BEFORE = "page-break-before";

    /** the CSS tag for the horizontal alignment of an object */
    public static final String CSS_KEY_TEXTALIGN = "text-align";

    /** the CSS tag for text decorations */
    public static final String CSS_KEY_TEXTDECORATION = "text-decoration";

    /** the CSS tag for text decorations */
    public static final String CSS_KEY_VERTICALALIGN = "vertical-align";

    /** the CSS tag for the visibility of objects */
    public static final String CSS_KEY_VISIBILITY = "visibility";

    // CSS values

    /**
     * value for the CSS tag for adding a page break when the document is
     * printed
     */
    public static final String CSS_VALUE_ALWAYS = "always";

    /** A possible value for the DISPLAY key */
    public static final String CSS_VALUE_BLOCK = "block";

    /** a CSS value for text font weight */
    public static final String CSS_VALUE_BOLD = "bold";

    /** the value if you want to hide objects. */
    public static final String CSS_VALUE_HIDDEN = "hidden";

    /** A possible value for the DISPLAY key */
    public static final String CSS_VALUE_INLINE = "inline";

    /** a CSS value for text font style */
    public static final String CSS_VALUE_ITALIC = "italic";

    /** a CSS value for text decoration */
    public static final String CSS_VALUE_LINETHROUGH = "line-through";

    /** A possible value for the DISPLAY key */
    public static final String CSS_VALUE_LISTITEM = "list-item";

    /** a CSS value */
    public static final String CSS_VALUE_NONE = "none";

    /** a CSS value */
    public static final String CSS_VALUE_NORMAL = "normal";

    /** a CSS value for text font style */
    public static final String CSS_VALUE_OBLIQUE = "oblique";

    /** A possible value for the DISPLAY key */
    public static final String CSS_VALUE_TABLE = "table";

    /** A possible value for the DISPLAY key */
    public static final String CSS_VALUE_TABLEROW = "table-row";

    /** A possible value for the DISPLAY key */
    public static final String CSS_VALUE_TABLECELL = "table-cell";

    /** the CSS value for a horizontal alignment of an object */
    public static final String CSS_VALUE_TEXTALIGNLEFT = "left";

    /** the CSS value for a horizontal alignment of an object */
    public static final String CSS_VALUE_TEXTALIGNRIGHT = "right";

    /** the CSS value for a horizontal alignment of an object */
    public static final String CSS_VALUE_TEXTALIGNCENTER = "center";

    /** the CSS value for a horizontal alignment of an object */
    public static final String CSS_VALUE_TEXTALIGNJUSTIFY = "justify";

    /** a CSS value for text decoration */
    public static final String CSS_VALUE_UNDERLINE = "underline";

    /** a default value for font-size 
     * @since 2.1.3
     */
    public static final float DEFAULT_FONT_SIZE = 12f;

    /**
     * Parses a length.
     * 
     * @param string
     *            a length in the form of an optional + or -, followed by a
     *            number and a unit.
     * @return a float
     */

    public static float parseLength(String string) {
        // TODO: Evaluate the effect of this.
        // It may change the default behavour of the methd if this is changed.
        // return parseLength(string, Markup.DEFAULT_FONT_SIZE);
        int pos = 0;
        int length = string.length();
        boolean ok = true;
        while (ok && pos < length) {
            switch (string.charAt(pos)) {
            case '+':
            case '-':
            case '0':
            case '1':
            case '2':
            case '3':
            case '4':
            case '5':
            case '6':
            case '7':
            case '8':
            case '9':
            case '.':
                pos++;
                break;
            default:
                ok = false;
            }
        }
        if (pos == 0)
            return 0f;
        if (pos == length)
            return Float.parseFloat(string + "f");
        float f = Float.parseFloat(string.substring(0, pos) + "f");
        string = string.substring(pos);
        // inches
        if (string.startsWith("in")) {
            return f * 72f;
        }
        // centimeters
        if (string.startsWith("cm")) {
            return (f / 2.54f) * 72f;
        }
        // millimeters
        if (string.startsWith("mm")) {
            return (f / 25.4f) * 72f;
        }
        // picas
        if (string.startsWith("pc")) {
            return f * 12f;
        }
        // default: we assume the length was measured in points
        return f;
    }

    /**
     * New method contributed by: Lubos Strapko
     *
     * @param string a length in the form of an optional + or - followed by a number and a unit
     * @param actualFontSize font-size
     * @return a float number
     * @since 2.1.3
     */
    public static float parseLength(@Nullable String string, float actualFontSize) {
        if (string == null)
            return 0f;
        int pos = 0;
        int length = string.length();
        boolean ok = true;
        while (ok && pos < length) {
            switch (string.charAt(pos)) {
            case '+':
            case '-':
            case '0':
            case '1':
            case '2':
            case '3':
            case '4':
            case '5':
            case '6':
            case '7':
            case '8':
            case '9':
            case '.':
                pos++;
                break;
            default:
                ok = false;
            }
        }
        if (pos == 0)
            return 0f;
        if (pos == length)
            return Float.parseFloat(string + "f");
        float f = Float.parseFloat(string.substring(0, pos) + "f");
        string = string.substring(pos);
        // inches
        if (string.startsWith("in")) {
            return f * 72f;
        }
        // centimeters
        if (string.startsWith("cm")) {
            return (f / 2.54f) * 72f;
        }
        // millimeters
        if (string.startsWith("mm")) {
            return (f / 25.4f) * 72f;
        }
        // picas
        if (string.startsWith("pc")) {
            return f * 12f;
        }
        // 1em is equal to the current font size
        if (string.startsWith("em")) {
            return f * actualFontSize;
        }
        // one ex is the x-height of a font (x-height is usually about half the
        // font-size)
        if (string.startsWith("ex")) {
            return f * actualFontSize / 2;
        }
        // default: we assume the length was measured in points
        return f;
    }

    /**
     * Converts a Color into a HTML representation of this Color.
     *
     * @param color the Color that has to be converted.
     * @return the HTML representation of this Color
     */
    @Nullable
    public static Color decodeColor(@Nullable String color) {
        if (color == null) {
            return null;
        }
        String colorName = color.toLowerCase(Locale.ROOT).trim();
        try {
            return WebColors.getRGBColor(colorName);
        }
        catch(IllegalArgumentException iae) {
            return null;
        }
    }

    /**
     * This method parses a String with attributes and returns a Properties
     * object.
     * 
     * @param string
     *            a String of this form: 'key1="value1"; key2="value2";...
     *            keyN="valueN" '
     * @return a Properties object
     */
    @Nonnull
    public static Properties parseAttributes(@Nullable String string) {
        Properties result = new Properties();
        if (string == null) {
            return result;
        }
        StringTokenizer keyValuePairs = new StringTokenizer(string, ";");
        StringTokenizer keyValuePair;
        String key;
        String value;
        while (keyValuePairs.hasMoreTokens()) {
            keyValuePair = new StringTokenizer(keyValuePairs.nextToken(), ":");
            if (keyValuePair.hasMoreTokens())
                key = keyValuePair.nextToken().trim();
            else
                continue;
            if (keyValuePair.hasMoreTokens())
                value = keyValuePair.nextToken().trim();
            else
                continue;
            if (value.startsWith("\""))
                value = value.substring(1);
            if (value.endsWith("\""))
                value = value.substring(0, value.length() - 1);
            result.setProperty(key.toLowerCase(Locale.ROOT), value);
        }
        return result;
    }

    /**
     * Removes the comments sections of a String.
     * 
     * @param string
     *            the original String
     * @param startComment
     *            the String that marks the start of a Comment section
     * @param endComment
     *            the String that marks the end of a Comment section.
     * @return the String stripped of its comment section
     */
    public static String removeComment(String string, String startComment,
            String endComment) {
        StringBuilder result = new StringBuilder();
        int pos = 0;
        int end = endComment.length();
        int start = string.indexOf(startComment, pos);
        while (start > -1) {
            result.append(string, pos, start);
            pos = string.indexOf(endComment, start) + end;
            start = string.indexOf(startComment, pos);
        }
        result.append(string.substring(pos));
        return result.toString();
    }

}




© 2015 - 2024 Weber Informatics LLC | Privacy Policy