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: 2.0.3
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 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

    /** the CSS tag for background style */
    public static final String CSS_KEY_BG = "background";

    /**
     * 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) {
        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(String string, float actualFontSize) {
        if (string == null) {
            return 0f;
        }
        FontSize fs = FontSize.parse(string);// it can be one of the CCS font size names (e.g. 'x-large')
        if (fs != null) {
            if (fs.isRelative()) {
                return fs.getScale() * actualFontSize;
            } else {
                return fs.getScale() * 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;
        }
        // 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;
        }
        // percentage of current font size
        if (string.endsWith("%")) {
            return (f / 100) * actualFontSize;
        }
        // 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
     */
    public static Color decodeColor(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
     */
    public static Properties parseAttributes(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