208 lines
8.2 KiB
C++
208 lines
8.2 KiB
C++
/* -*- 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___ */
|