/*
* This source file is part of RmlUi, the HTML/CSS Interface Middleware
*
* For the latest information, see http://github.com/mikke89/RmlUi
*
* Copyright (c) 2008-2010 CodePoint Ltd, Shift Technology Ltd
* Copyright (c) 2019-2023 The RmlUi Team, and contributors
*
* Permission is hereby granted, free of charge, to any person obtaining a copy
* of this software and associated documentation files (the "Software"), to deal
* in the Software without restriction, including without limitation the rights
* to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
* copies of the Software, and to permit persons to whom the Software is
* furnished to do so, subject to the following conditions:
*
* The above copyright notice and this permission notice shall be included in
* all copies or substantial portions of the Software.
*
* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
* IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
* FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
* AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
* LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
* OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
* THE SOFTWARE.
*
*/
#include "PropertyParserDecorator.h"
#include "../../Include/RmlUi/Core/Decorator.h"
#include "../../Include/RmlUi/Core/Factory.h"
#include "../../Include/RmlUi/Core/Profiling.h"
#include "../../Include/RmlUi/Core/PropertySpecification.h"
#include "../../Include/RmlUi/Core/StyleSheetTypes.h"
namespace Rml {
const SmallUnorderedMap PropertyParserDecorator::area_keywords = {
{"border-box", BoxArea::Border},
{"padding-box", BoxArea::Padding},
{"content-box", BoxArea::Content},
};
PropertyParserDecorator::PropertyParserDecorator() {}
PropertyParserDecorator::~PropertyParserDecorator() {}
bool PropertyParserDecorator::ParseValue(Property& property, const String& decorator_string_value, const ParameterMap& /*parameters*/) const
{
// Decorators are declared as
// decorator: [, ...];
// Where is either a @decorator name:
// decorator: invader-theme-background ?, ...;
// or is an anonymous decorator with inline properties
// decorator: tiled-box( ) ?, ...;
// where is one of
// border-box, padding-box, content-box
if (decorator_string_value.empty() || decorator_string_value == "none")
{
property.value = Variant(DecoratorsPtr());
property.unit = Unit::DECORATOR;
return true;
}
RMLUI_ZoneScoped;
// Make sure we don't split inside the parenthesis since they may appear in decorator shorthands.
StringList decorator_string_list;
StringUtilities::ExpandString(decorator_string_list, decorator_string_value, ',', '(', ')');
DecoratorDeclarationList decorators;
decorators.value = decorator_string_value;
decorators.list.reserve(decorator_string_list.size());
// Get or instance each decorator in the comma-separated string list
for (const String& decorator_string : decorator_string_list)
{
const size_t shorthand_open = decorator_string.find('(');
const size_t shorthand_close = decorator_string.rfind(')');
const bool invalid_parenthesis = (shorthand_open == String::npos || shorthand_close == String::npos || shorthand_open >= shorthand_close);
// Look-up keywords for customized paint area.
BoxArea paint_area = BoxArea::Auto;
{
const size_t keywords_begin = (invalid_parenthesis ? decorator_string.find(' ') : shorthand_close + 1);
StringList keywords;
if (keywords_begin < decorator_string.size())
StringUtilities::ExpandString(keywords, decorator_string.substr(keywords_begin), ' ');
for (const String& keyword : keywords)
{
if (keyword.empty())
continue;
auto it = area_keywords.find(StringUtilities::ToLower(keyword));
if (it == area_keywords.end())
return false; // Bail out if we have an invalid keyword.
paint_area = it->second;
}
}
if (invalid_parenthesis)
{
// We found no parenthesis, that means the value must be a name of a @decorator rule.
decorators.list.emplace_back(DecoratorDeclaration{decorator_string, nullptr, {}, paint_area});
}
else
{
// Since we have parentheses it must be an anonymous decorator with inline properties
const String type = StringUtilities::StripWhitespace(decorator_string.substr(0, shorthand_open));
// Check for valid decorator type
DecoratorInstancer* instancer = Factory::GetDecoratorInstancer(type);
if (!instancer)
{
Log::Message(Log::LT_WARNING, "Decorator type '%s' not found.", type.c_str());
return false;
}
const String shorthand = decorator_string.substr(shorthand_open + 1, shorthand_close - shorthand_open - 1);
const PropertySpecification& specification = instancer->GetPropertySpecification();
// Parse the shorthand properties given by the 'decorator' shorthand property
PropertyDictionary properties;
if (!specification.ParsePropertyDeclaration(properties, "decorator", shorthand))
{
// Empty values are allowed in decorators, if the value is not empty we must have encountered a parser error.
if (!StringUtilities::StripWhitespace(shorthand).empty())
return false;
}
// Set unspecified values to their defaults
specification.SetPropertyDefaults(properties);
decorators.list.emplace_back(DecoratorDeclaration{type, instancer, std::move(properties), paint_area});
}
}
if (decorators.list.empty())
return false;
property.value = Variant(MakeShared(std::move(decorators)));
property.unit = Unit::DECORATOR;
return true;
}
String PropertyParserDecorator::ConvertAreaToString(BoxArea area)
{
for (const auto& it : area_keywords)
{
if (it.second == area)
return it.first;
}
return String();
}
} // namespace Rml