diff options
Diffstat (limited to 'layout/style/nsStyleUtil.h')
| -rw-r--r-- | layout/style/nsStyleUtil.h | 207 |
1 files changed, 207 insertions, 0 deletions
diff --git a/layout/style/nsStyleUtil.h b/layout/style/nsStyleUtil.h new file mode 100644 index 000000000..e5b7a055f --- /dev/null +++ b/layout/style/nsStyleUtil.h @@ -0,0 +1,207 @@ +/* -*- Mode: C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */ +/* This Source Code Form is subject to the terms of the Mozilla Public + * License, v. 2.0. If a copy of the MPL was not distributed with this + * file, You can obtain one at http://mozilla.org/MPL/2.0/. */ +#ifndef nsStyleUtil_h___ +#define nsStyleUtil_h___ + +#include "nsCoord.h" +#include "nsCSSPropertyID.h" +#include "nsString.h" +#include "nsTArrayForwardDeclare.h" +#include "gfxFontFamilyList.h" +#include "nsStyleStruct.h" +#include "nsCRT.h" + +class nsCSSValue; +class nsStringComparator; +class nsStyleCoord; +class nsIContent; +class nsIPrincipal; +class nsIURI; +struct gfxFontFeature; +struct gfxAlternateValue; +struct nsCSSValueList; + +// Style utility functions +class nsStyleUtil { +public: + + static bool DashMatchCompare(const nsAString& aAttributeValue, + const nsAString& aSelectorValue, + const nsStringComparator& aComparator); + + static bool ValueIncludes(const nsSubstring& aValueList, + const nsSubstring& aValue, + const nsStringComparator& aComparator); + + // Append a quoted (with 'quoteChar') and escaped version of aString + // to aResult. 'quoteChar' must be ' or ". + static void AppendEscapedCSSString(const nsAString& aString, + nsAString& aResult, + char16_t quoteChar = '"'); + + // Append the identifier given by |aIdent| to |aResult|, with + // appropriate escaping so that it can be reparsed to the same + // identifier. An exception is if aIdent contains U+0000, which + // will be escaped as U+FFFD and then reparsed back to U+FFFD. + static void AppendEscapedCSSIdent(const nsAString& aIdent, + nsAString& aResult); + + static void + AppendEscapedCSSFontFamilyList(const mozilla::FontFamilyList& aFamilyList, + nsAString& aResult); + + // Append a bitmask-valued property's value(s) (space-separated) to aResult. + static void AppendBitmaskCSSValue(nsCSSPropertyID aProperty, + int32_t aMaskedValue, + int32_t aFirstMask, + int32_t aLastMask, + nsAString& aResult); + + static void AppendAngleValue(const nsStyleCoord& aValue, nsAString& aResult); + + static void AppendPaintOrderValue(uint8_t aValue, nsAString& aResult); + + static void AppendFontFeatureSettings(const nsTArray<gfxFontFeature>& aFeatures, + nsAString& aResult); + + static void AppendFontFeatureSettings(const nsCSSValue& src, + nsAString& aResult); + + static void AppendUnicodeRange(const nsCSSValue& aValue, nsAString& aResult); + + static void AppendCSSNumber(float aNumber, nsAString& aResult) + { + aResult.AppendFloat(aNumber); + } + + static void AppendStepsTimingFunction(nsTimingFunction::Type aType, + uint32_t aSteps, + nsAString& aResult); + static void AppendCubicBezierTimingFunction(float aX1, float aY1, + float aX2, float aY2, + nsAString& aResult); + static void AppendCubicBezierKeywordTimingFunction( + nsTimingFunction::Type aType, + nsAString& aResult); + + static void AppendSerializedFontSrc(const nsCSSValue& aValue, + nsAString& aResult); + + // convert bitmask value to keyword name for a functional alternate + static void GetFunctionalAlternatesName(int32_t aFeature, + nsAString& aFeatureName); + + // Append functional font-variant-alternates values to string + static void + SerializeFunctionalAlternates(const nsTArray<gfxAlternateValue>& aAlternates, + nsAString& aResult); + + // List of functional font-variant-alternates values to feature/value pairs + static void + ComputeFunctionalAlternates(const nsCSSValueList* aList, + nsTArray<gfxAlternateValue>& aAlternateValues); + + /* + * Convert an author-provided floating point number to an integer (0 + * ... 255) appropriate for use in the alpha component of a color. + */ + static uint8_t FloatToColorComponent(float aAlpha) + { + NS_ASSERTION(0.0 <= aAlpha && aAlpha <= 1.0, "out of range"); + return NSToIntRound(aAlpha * 255); + } + + /* + * Convert the alpha component of an nscolor (0 ... 255) to the + * floating point number with the least accurate *decimal* + * representation that is converted to that color. + * + * Should be used only by serialization code. + */ + static float ColorComponentToFloat(uint8_t aAlpha); + + /* + * Does this child count as significant for selector matching? + */ + static bool IsSignificantChild(nsIContent* aChild, + bool aTextIsSignificant, + bool aWhitespaceIsSignificant); + /** + * Returns true if our object-fit & object-position properties might cause + * a replaced element's contents to overflow its content-box (requiring + * clipping), or false if we can be sure that this won't happen. + * + * This lets us optimize by skipping clipping when we can tell it's + * unnecessary (particularly with the default values of these properties). + * + * @param aStylePos The nsStylePosition whose object-fit & object-position + * properties should be checked for potential overflow. + * @return false if we can be sure that the object-fit & object-position + * properties on 'aStylePos' cannot cause a replaced element's + * contents to overflow its content-box. Otherwise (if overflow is + * is possible), returns true. + */ + static bool ObjectPropsMightCauseOverflow(const nsStylePosition* aStylePos); + + /* + * Does this principal have a CSP that blocks the application of + * inline styles? Returns false if application of the style should + * be blocked. + * + * @param aContent + * The <style> element that the caller wants to know whether to honor. + * Included to check the nonce attribute if one is provided. Allowed to + * be null, if this is for something other than a <style> element (in + * which case nonces won't be checked). + * @param aPrincipal + * The principal of the of the document (*not* of the style sheet). + * The document's principal is where any Content Security Policy that + * should be used to block or allow inline styles will be located. + * @param aSourceURI + * URI of document containing inline style (for reporting violations) + * @param aLineNumber + * Line number of inline style element in the containing document (for + * reporting violations) + * @param aStyleText + * Contents of the inline style element (for reporting violations) + * @param aRv + * Return error code in case of failure + * @return + * Does CSP allow application of the specified inline style? + */ + static bool CSPAllowsInlineStyle(nsIContent* aContent, + nsIPrincipal* aPrincipal, + nsIURI* aSourceURI, + uint32_t aLineNumber, + const nsSubstring& aStyleText, + nsresult* aRv); + + template<size_t N> + static bool MatchesLanguagePrefix(const char16_t* aLang, size_t aLen, + const char16_t (&aPrefix)[N]) + { + return !nsCRT::strncmp(aLang, aPrefix, N - 1) && + (aLen == N - 1 || aLang[N - 1] == '-'); + } + + template<size_t N> + static bool MatchesLanguagePrefix(const nsIAtom* aLang, + const char16_t (&aPrefix)[N]) + { + MOZ_ASSERT(aLang); + return MatchesLanguagePrefix(aLang->GetUTF16String(), + aLang->GetLength(), aPrefix); + } + + template<size_t N> + static bool MatchesLanguagePrefix(const nsAString& aLang, + const char16_t (&aPrefix)[N]) + { + return MatchesLanguagePrefix(aLang.Data(), aLang.Length(), aPrefix); + } +}; + + +#endif /* nsStyleUtil_h___ */ |