001/*
002 * ============================================================================
003 * Copyright © 2002-2023 by Thomas Thrien.
004 * All Rights Reserved.
005 * ============================================================================
006 * Licensed to the public under the agreements of the GNU Lesser General Public
007 * License, version 3.0 (the "License"). You may obtain a copy of the License at
008 *
009 *      http://www.gnu.org/licenses/lgpl.html
010 *
011 * Unless required by applicable law or agreed to in writing, software
012 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
013 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
014 * License for the specific language governing permissions and limitations
015 * under the License.
016 */
017
018package org.tquadrat.foundation.svg;
019
020import static org.apiguardian.api.API.Status.STABLE;
021
022import org.apiguardian.api.API;
023import org.tquadrat.foundation.annotation.ClassVersion;
024import org.tquadrat.foundation.svg.internal.SVGStyleImpl;
025
026/**
027 *  The definition for the SVG {@code <style>} element.
028 *
029 *  @extauthor Thomas Thrien - thomas.thrien@tquadrat.org
030 *  @version $Id: SVGStyle.java 1074 2023-10-02 12:05:06Z tquadrat $
031 *  @since 0.0.5
032 *
033 *  @UMLGraph.link
034 */
035@ClassVersion( sourceVersion = "$Id: SVGStyle.java 1074 2023-10-02 12:05:06Z tquadrat $" )
036@API( status = STABLE, since = "0.0.5" )
037public sealed interface SVGStyle extends SVGElement
038    permits SVGElementAdapter, SVGStyleImpl
039{
040        /*---------*\
041    ====** Methods **==========================================================
042        \*---------*/
043    /**
044     *  Adds a CSS style definition to this style.
045     *
046     *  @param  styles  The style definitions to add.
047     */
048    public void addStyle( final CharSequence... styles );
049
050    /**
051     *  Returns the style sheet.
052     *
053     *  @return The style definitions.
054     */
055    public String getStyleSheet();
056
057    /**
058     *  Merges the given SVG {@code <style>} element into this one.<br>
059     *  <br>Only the CSS style definitions are taken from the other element,
060     *  no attributes or comments.
061     *
062     *  @param  other   The other {@code <style>} element.
063     */
064    public void merge( final SVGStyle other );
065
066    /**
067     *  {@inheritDoc}
068     */
069    @Override
070    public String toString( final int indentationLevel, final boolean prettyPrint );
071}
072//  class SVGStyle
073
074/*
075 *  End of File
076 */