summaryrefslogtreecommitdiffstats
path: root/layout/style/nsStyleUtil.h
diff options
context:
space:
mode:
Diffstat (limited to 'layout/style/nsStyleUtil.h')
-rw-r--r--layout/style/nsStyleUtil.h207
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___ */