/* * (C) 1999-2003 Lars Knoll (knoll@kde.org) * Copyright (C) 2004, 2005, 2006, 2007, 2008, 2009, 2010, 2012 Apple Inc. All * rights reserved. * Copyright (C) 2011 Research In Motion Limited. All rights reserved. * Copyright (C) 2013 Intel Corporation. All rights reserved. * * This library is free software; you can redistribute it and/or * modify it under the terms of the GNU Library General Public * License as published by the Free Software Foundation; either * version 2 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 * Library General Public License for more details. * * You should have received a copy of the GNU Library General Public License * along with this library; see the file COPYING.LIB. If not, write to * the Free Software Foundation, Inc., 51 Franklin Street, Fifth Floor, * Boston, MA 02110-1301, USA. */ #ifndef THIRD_PARTY_BLINK_RENDERER_CORE_CSS_STYLE_PROPERTY_SERIALIZER_H_ #define THIRD_PARTY_BLINK_RENDERER_CORE_CSS_STYLE_PROPERTY_SERIALIZER_H_ #include #include "third_party/blink/renderer/core/core_export.h" #include "third_party/blink/renderer/core/css/css_property_value_set.h" #include "third_party/blink/renderer/core/css/css_value_list.h" #include "third_party/blink/renderer/platform/wtf/forward.h" namespace blink { class CSSPropertyName; class CSSPropertyValueSet; class StylePropertyShorthand; enum class CSSGapDecorationPropertyDirection : int; class CORE_EXPORT StylePropertySerializer { STACK_ALLOCATED(); public: explicit StylePropertySerializer(const CSSPropertyValueSet&); String AsText() const; String SerializeShorthand(CSSPropertyID) const; private: String GetCommonValue(const StylePropertyShorthand&) const; String BorderPropertyValue(const StylePropertyShorthand&, const StylePropertyShorthand&, const StylePropertyShorthand&) const; String BorderImagePropertyValue() const; String BorderRadiusValue() const; String CornerShapeValue() const; String CornersValue() const; String SingleCornerShorthandValue(const StylePropertyShorthand&) const; String CornerPairShorthandValue(const StylePropertyShorthand&) const; String GetLayeredShorthandValue(const StylePropertyShorthand&) const; String Get2Values(const StylePropertyShorthand&) const; String Get4Values(const StylePropertyShorthand&) const; String PageBreakPropertyValue(const StylePropertyShorthand&) const; String GetShorthandValue(const StylePropertyShorthand&, String separator = " ") const; String GetShorthandValueForBorder(const StylePropertyShorthand&) const; String GetShorthandValueForRule(const StylePropertyShorthand&, const StylePropertyShorthand&) const; String GetShorthandValueForBidirectionalGapRuleInset( const StylePropertyShorthand&) const; String GetShorthandValueForBidirectionalGapRuleInsetCapJunction( const StylePropertyShorthand&) const; String GetShorthandValueForBidirectionalGapRuleInsetStartEnd( const StylePropertyShorthand&) const; String GetShorthandValueForBidirectionalGapRules( const StylePropertyShorthand&) const; String GetShorthandValueForGapDecorationsRule( const StylePropertyShorthand&, CSSGapDecorationPropertyDirection direction) const; String GetShorthandValueForGapDecorationsRuleInset( const StylePropertyShorthand&, CSSGapDecorationPropertyDirection direction) const; String GetShorthandValueForGapDecorationsRuleInsetCapJunction( const StylePropertyShorthand&, CSSGapDecorationPropertyDirection direction, bool is_cap) const; String GetShorthandValueForGapDecorationsRuleInsetStartEnd( const StylePropertyShorthand&) const; String GetShorthandValueForColumns(const StylePropertyShorthand&) const; // foo || bar || ... || baz // https://drafts.csswg.org/css-values-4/#component-combinators String GetShorthandValueForDoubleBarCombinator( const StylePropertyShorthand&) const; String GetShorthandValueForGrid(const StylePropertyShorthand&) const; String GetShorthandValueForGridArea(const StylePropertyShorthand&) const; String GetShorthandValueForGridLine(const StylePropertyShorthand&) const; String GetShorthandValueForGridTemplate(const StylePropertyShorthand&) const; String GetShorthandValueForGridLanes(const StylePropertyShorthand&) const; String ContainerValue() const; String TimelineValue(const StylePropertyShorthand&) const; String ScrollTimelineValue() const; String ViewTimelineValue() const; String AnimationRangeShorthandValue() const; String TimelineTriggerActivationRangeShorthandValue() const; String TimelineTriggerExitRangeShorthandValue() const; String FontValue() const; String FontSynthesisValue() const; String FontVariantValue() const; bool AppendFontLonghandValueIfNotNormal(const CSSProperty&, StringBuilder& result) const; String OffsetValue() const; String TextBoxValue() const; String TextDecorationValue() const; String TextSpacingValue() const; String TextWrapValue() const; String ContainIntrinsicSizeValue() const; String WhiteSpaceValue() const; String LineClampValue(bool is_webkit_line_clamp) const; String PositionTryValue(const StylePropertyShorthand&) const; String GetPropertyText(const CSSPropertyName&, const String& value, bool is_important, bool is_not_first_decl) const; bool IsPropertyShorthandAvailable(const StylePropertyShorthand&) const; bool ShorthandHasOnlyInitialOrInheritedValue( const StylePropertyShorthand&) const; void AppendBackgroundPropertyAsText(StringBuilder& result, unsigned& num_decls) const; // This function does checks common to all shorthands, and returns: // - The serialization if the shorthand serializes as a css-wide keyword. // - An empty string if either some longhands are not set, the important // flag is not set consistently, or css-wide keywords are used. In these // cases serialization will always fail. // - A null string otherwise. String CommonShorthandChecks(const StylePropertyShorthand&) const; // Only StylePropertySerializer uses the following two classes. class PropertyValueForSerializer { STACK_ALLOCATED(); public: explicit PropertyValueForSerializer(const CSSPropertyValue& property) : value_(property.Value()), name_(property.Name()), is_important_(property.IsImportant()) {} PropertyValueForSerializer(const CSSPropertyName& name, const CSSValue& value, bool is_important) : value_(value), name_(name), is_important_(is_important) {} const CSSPropertyName& Name() const { return name_; } const CSSValue& Value() const { return value_; } bool IsImportant() const { return is_important_; } private: const CSSValue& value_; CSSPropertyName name_; bool is_important_; }; String GetCustomPropertyText(const PropertyValueForSerializer&, bool is_not_first_decl) const; class CSSPropertyValueSetForSerializer final { DISALLOW_NEW(); public: explicit CSSPropertyValueSetForSerializer(const CSSPropertyValueSet&); unsigned PropertyCount() const; PropertyValueForSerializer PropertyAt(unsigned index) const; bool ShouldProcessPropertyAt(unsigned index) const; int FindPropertyIndex(const CSSProperty&) const; const CSSValue* GetPropertyCSSValue(const CSSProperty&) const; bool IsDescriptorContext() const; void Trace(Visitor*) const; private: // Number of CSS longhand property IDs in the expansion range. static constexpr unsigned kAllLonghandCount = kIntLastCSSProperty - kIntFirstCSSProperty + 1; bool HasExpandedAllProperty() const { return HasAllProperty() && need_to_expand_all_; } bool HasAllProperty() const { return all_index_ != -1; } bool IsIndexInPropertySet(unsigned index) const { if (!HasExpandedAllProperty()) { return index < property_set_->PropertyCount(); } // When expanding "all", the index range is split into two parts: // // [0, kAllLonghandCount) → all-expansion longhands (emitted first) // [kAllLonghandCount, kAllLonghandCount + property_set_->PropertyCount()) // → actual property-set entries (custom props // + explicit overrides, emitted at the end) // // For this property set: // // div { // --foo: bar; // all: initial; // background-color: green; // } // // Indices: // 0 .. (kAllLonghandCount-1): expanded longhands (color, display, ...) // kAllLonghandCount + 0: --foo // kAllLonghandCount + 1: all // kAllLonghandCount + 2: background-color // return index >= kAllLonghandCount; } CSSPropertyID IndexToPropertyID(unsigned index) const { DCHECK(!IsIndexInPropertySet(index)); return static_cast(index + kIntFirstCSSProperty); } Member property_set_; int all_index_; // Bitset of named longhands in the property set whose value explicitly // differs from that of "all" and is not overridden by !important. // // Used when "all" is not expanded to determine which longhands need to be // emitted during serialization. std::bitset longhand_property_used_; // Bitset of all named longhands that appear after the "all" declaration // in the property set, regardless of whether their computed value matches // that of "all". // // When expanding "all", this ensures that related longhands (e.g. those // originating from a border shorthand, including border-width-*) are // emitted together at the end of the serialized cssText so that // shorthands can be reconstructed correctly. std::bitset longhand_after_all_; bool need_to_expand_all_; }; const CSSPropertyValueSetForSerializer property_set_; }; } // namespace blink #endif // THIRD_PARTY_BLINK_RENDERER_CORE_CSS_STYLE_PROPERTY_SERIALIZER_H_