com.hfg.css.CSSDeclaration Maven / Gradle / Ivy

Go to download
Show more of this group Show more artifacts with this name
Show all versions of com_hfg Show documentation
com.hfg xml, html, svg, and bioinformatics utility library
There is a newer version: 20240423
package com.hfg.css;


//------------------------------------------------------------------------------

import com.hfg.util.StringUtil;

import java.util.ArrayList;
import java.util.List;

/**
 A CSS declaration container composed of a CSSProperty and a value.

 @author J. Alex Taylor, hairyfatguy.com
 */
//------------------------------------------------------------------------------
// com.hfg Library
//
// This library is free software; you can redistribute it and/or
// modify it under the terms of the GNU Lesser General Public
// License as published by the Free Software Foundation; either
// version 2.1 of the License, or (at your option) 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
// Lesser General Public License for more details.
//
// You should have received a copy of the GNU Lesser General Public
// License along with this library; if not, write to the Free Software
// Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA  02111-1307  USA
//
// J. Alex Taylor, President, Founder, CEO, COO, CFO, OOPS hairyfatguy.com
// [email protected]
//------------------------------------------------------------------------------

public class CSSDeclaration
{
   private CSSProperty mProperty;
   private String      mValue;
   private boolean     mImportant;

   //--------------------------------------------------------------------------
   public CSSDeclaration(CSSProperty inProperty, int inValue)
   {
      this(inProperty, inValue + "");
   }

   //--------------------------------------------------------------------------
   public CSSDeclaration(CSSProperty inProperty, String inValue)
   {
      if (null == inProperty)
      {
         throw new CSSException("The CSS property for a CSS declaration cannot be null!");
      }

      mProperty = inProperty;
      if (inValue != null)
      {
         mValue = inValue.trim();

         // Remove trailing semi-colon separator if present
         if (mValue.endsWith(";"))
         {
            mValue = mValue.substring(0, mValue.length() - 1).trim();
         }

         if (mValue.endsWith("!important"))
         {
            mImportant = true;
            mValue = mValue.substring(0, mValue.length() - "!important".length()).trim();
         }
      }
   }

   //--------------------------------------------------------------------------
   public static List parse(String inValue)
   {
      List declarations = null;
      if (StringUtil.isSet(inValue))
      {
         declarations = new ArrayList<>(20);

         String[] pieces = inValue.trim().split("\\s*;\\s*");
         for (String piece : pieces)
         {
            try
            {
               int colonIdx = piece.indexOf(":");
               CSSProperty property = CSSProperty.valueOf(piece.substring(0, colonIdx).trim());
               if (property != null)
               {
                  String value = piece.substring(colonIdx + 1).trim();
                  declarations.add(new CSSDeclaration(property, value));
               }
            }
            catch (Exception e)
            {
               throw new CSSException("Error parsing CSS declaration " + StringUtil.singleQuote(piece) + "!", e);
            }
         }
      }

      return declarations;
   }

   //--------------------------------------------------------------------------
   public CSSProperty getProperty()
   {
      return mProperty;
   }

   //--------------------------------------------------------------------------
   public String getValue()
   {
      return mValue;
   }

   //--------------------------------------------------------------------------
   public CSSDeclaration setValue(String inValue)
   {
      mValue = inValue;
      return this;
   }

   //--------------------------------------------------------------------------
   public boolean isImportant()
   {
      return mImportant;
   }

   //--------------------------------------------------------------------------
   public CSSDeclaration setIsImportant(boolean inValue)
   {
      mImportant = inValue;
      return this;
   }

   //--------------------------------------------------------------------------
   @Override
   public String toString()
   {
      return getProperty() + ":" + getValue() + (mImportant ? " !important" : "");
   }
}