/*
* 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 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 "../../Include/RmlUi/Core/ElementDocument.h"
#include "../../Include/RmlUi/Core/Context.h"
#include "../../Include/RmlUi/Core/ElementText.h"
#include "../../Include/RmlUi/Core/Factory.h"
#include "../../Include/RmlUi/Core/Profiling.h"
#include "../../Include/RmlUi/Core/StreamMemory.h"
#include "../../Include/RmlUi/Core/StyleSheet.h"
#include "../../Include/RmlUi/Core/StyleSheetContainer.h"
#include "DocumentHeader.h"
#include "ElementStyle.h"
#include "EventDispatcher.h"
#include "Layout/LayoutEngine.h"
#include "StreamFile.h"
#include "StyleSheetFactory.h"
#include "Template.h"
#include "TemplateCache.h"
#include "XMLParseTools.h"
namespace Rml {
ElementDocument::ElementDocument(const String& tag) : Element(tag)
{
context = nullptr;
modal = false;
layout_dirty = true;
position_dirty = false;
ForceLocalStackingContext();
SetOwnerDocument(this);
SetProperty(PropertyId::Position, Property(Style::Position::Absolute));
}
ElementDocument::~ElementDocument()
{
}
void ElementDocument::ProcessHeader(const DocumentHeader* document_header)
{
RMLUI_ZoneScoped;
// Store the source address that we came from
source_url = document_header->source;
// Construct a new header and copy the template details across
DocumentHeader header;
header.MergePaths(header.template_resources, document_header->template_resources, document_header->source);
// Merge in any templates, note a merge may cause more templates to merge
for (size_t i = 0; i < header.template_resources.size(); i++)
{
Template* merge_template = TemplateCache::LoadTemplate(URL(header.template_resources[i]).GetURL());
if (merge_template)
header.MergeHeader(*merge_template->GetHeader());
else
Log::Message(Log::LT_WARNING, "Template %s not found", header.template_resources[i].c_str());
}
// Merge the document's header last, as it is the most overriding.
header.MergeHeader(*document_header);
// Set the title to the document title.
title = document_header->title;
// If a style-sheet (or sheets) has been specified for this element, then we load them and set the combined sheet
// on the element; all of its children will inherit it by default.
SharedPtr new_style_sheet;
// Combine any inline sheets.
for (const DocumentHeader::Resource& rcss : header.rcss)
{
if (rcss.is_inline)
{
auto inline_sheet = MakeShared();
auto stream = MakeUnique((const byte*)rcss.content.c_str(), rcss.content.size());
stream->SetSourceURL(rcss.path);
if (inline_sheet->LoadStyleSheetContainer(stream.get(), rcss.line))
{
if (new_style_sheet)
new_style_sheet->MergeStyleSheetContainer(*inline_sheet);
else
new_style_sheet = std::move(inline_sheet);
}
stream.reset();
}
else
{
const StyleSheetContainer* sub_sheet = StyleSheetFactory::GetStyleSheetContainer(rcss.path);
if (sub_sheet)
{
if (new_style_sheet)
new_style_sheet->MergeStyleSheetContainer(*sub_sheet);
else
new_style_sheet = sub_sheet->CombineStyleSheetContainer(StyleSheetContainer());
}
else
Log::Message(Log::LT_ERROR, "Failed to load style sheet %s.", rcss.path.c_str());
}
}
// If a style sheet is available, set it on the document.
if (new_style_sheet)
SetStyleSheetContainer(std::move(new_style_sheet));
// Load scripts.
for (const DocumentHeader::Resource& script : header.scripts)
{
if (script.is_inline)
{
LoadInlineScript(script.content, script.path, script.line);
}
else
{
LoadExternalScript(script.path);
}
}
// Hide this document.
SetProperty(PropertyId::Visibility, Property(Style::Visibility::Hidden));
const float dp_ratio = (context ? context->GetDensityIndependentPixelRatio() : 1.0f);
const Vector2f vp_dimensions = (context ? Vector2f(context->GetDimensions()) : Vector2f(1.0f));
// Update properties so that e.g. visibility status can be queried properly immediately.
UpdateProperties(dp_ratio, vp_dimensions);
}
// Returns the document's context.
Context* ElementDocument::GetContext()
{
return context;
}
// Sets the document's title.
void ElementDocument::SetTitle(const String& _title)
{
title = _title;
}
const String& ElementDocument::GetTitle() const
{
return title;
}
const String& ElementDocument::GetSourceURL() const
{
return source_url;
}
// Returns the document's style sheet.
const StyleSheet* ElementDocument::GetStyleSheet() const
{
if (style_sheet_container)
return style_sheet_container->GetCompiledStyleSheet();
return nullptr;
}
// Returns the document's style sheet container.
const StyleSheetContainer* ElementDocument::GetStyleSheetContainer() const
{
return style_sheet_container.get();
}
// Sets the style sheet this document, and all of its children, uses.
void ElementDocument::SetStyleSheetContainer(SharedPtr _style_sheet_container)
{
RMLUI_ZoneScoped;
if (style_sheet_container == _style_sheet_container)
return;
style_sheet_container = std::move(_style_sheet_container);
DirtyMediaQueries();
}
// Reload the document's style sheet from source files.
void ElementDocument::ReloadStyleSheet()
{
if (!context)
return;
auto stream = MakeUnique();
if (!stream->Open(source_url))
{
Log::Message(Log::LT_WARNING, "Failed to open file to reload style sheet in document: %s", source_url.c_str());
return;
}
Factory::ClearStyleSheetCache();
Factory::ClearTemplateCache();
ElementPtr temp_doc = Factory::InstanceDocumentStream(nullptr, stream.get(), context->GetDocumentsBaseTag());
if (!temp_doc) {
Log::Message(Log::LT_WARNING, "Failed to reload style sheet, could not instance document: %s", source_url.c_str());
return;
}
SetStyleSheetContainer(static_cast(temp_doc.get())->style_sheet_container);
}
void ElementDocument::DirtyMediaQueries()
{
if (context && style_sheet_container)
{
const bool changed_style_sheet = style_sheet_container->UpdateCompiledStyleSheet(context);
if (changed_style_sheet)
{
DirtyDefinition(Element::DirtyNodes::Self);
OnStyleSheetChangeRecursive();
}
}
}
// Brings the document to the front of the document stack.
void ElementDocument::PullToFront()
{
if (context != nullptr)
context->PullDocumentToFront(this);
}
// Sends the document to the back of the document stack.
void ElementDocument::PushToBack()
{
if (context != nullptr)
context->PushDocumentToBack(this);
}
void ElementDocument::Show(ModalFlag modal_flag, FocusFlag focus_flag)
{
switch (modal_flag)
{
case ModalFlag::None: modal = false; break;
case ModalFlag::Modal: modal = true; break;
case ModalFlag::Keep: break;
}
bool focus = false;
bool autofocus = false;
bool focus_previous = false;
switch (focus_flag)
{
case FocusFlag::None:
break;
case FocusFlag::Document:
focus = true;
break;
case FocusFlag::Keep:
focus = true;
focus_previous = true;
break;
case FocusFlag::Auto:
focus = true;
autofocus = true;
break;
}
// Set to visible and switch focus if necessary
SetProperty(PropertyId::Visibility, Property(Style::Visibility::Visible));
// We should update the document now, otherwise the focusing methods below do not think we are visible
// If this turns out to be slow, the more performant approach is just to compute the new visibility property
UpdateDocument();
if (focus)
{
Element* focus_element = this;
if (autofocus)
{
Element* first_element = nullptr;
Element* element = FindNextTabElement(this, true);
while (element && element != first_element)
{
if (!first_element)
first_element = element;
if (element->HasAttribute("autofocus"))
{
focus_element = element;
break;
}
element = FindNextTabElement(element, true);
}
}
else if (focus_previous)
{
focus_element = GetFocusLeafNode();
}
// Focus the window or element
bool focused = focus_element->Focus();
if (focused && focus_element != this)
focus_element->ScrollIntoView(false);
}
DispatchEvent(EventId::Show, Dictionary());
}
void ElementDocument::Hide()
{
SetProperty(PropertyId::Visibility, Property(Style::Visibility::Hidden));
// We should update the document now, so that the (un)focusing will get the correct visibility
UpdateDocument();
DispatchEvent(EventId::Hide, Dictionary());
if (context)
{
context->UnfocusDocument(this);
}
}
// Close this document
void ElementDocument::Close()
{
if (context != nullptr)
context->UnloadDocument(this);
}
ElementPtr ElementDocument::CreateElement(const String& name)
{
return Factory::InstanceElement(nullptr, name, name, XMLAttributes());
}
// Create a text element.
ElementPtr ElementDocument::CreateTextNode(const String& text)
{
// Create the element.
ElementPtr element = CreateElement("#text");
if (!element)
{
Log::Message(Log::LT_ERROR, "Failed to create text element, instancer returned nullptr.");
return nullptr;
}
// Cast up
ElementText* element_text = rmlui_dynamic_cast< ElementText* >(element.get());
if (!element_text)
{
Log::Message(Log::LT_ERROR, "Failed to create text element, instancer didn't return a derivative of ElementText.");
return nullptr;
}
// Set the text
element_text->SetText(text);
return element;
}
// Is the current document modal
bool ElementDocument::IsModal() const
{
return modal && IsVisible();
}
// Default load inline script implementation
void ElementDocument::LoadInlineScript(const String& RMLUI_UNUSED_PARAMETER(content), const String& RMLUI_UNUSED_PARAMETER(source_path), int RMLUI_UNUSED_PARAMETER(line))
{
RMLUI_UNUSED(content);
RMLUI_UNUSED(source_path);
RMLUI_UNUSED(line);
}
// Default load external script implementation
void ElementDocument::LoadExternalScript(const String& RMLUI_UNUSED_PARAMETER(source_path))
{
RMLUI_UNUSED(source_path);
}
// Updates the document, including its layout
void ElementDocument::UpdateDocument()
{
const float dp_ratio = (context ? context->GetDensityIndependentPixelRatio() : 1.0f);
const Vector2f vp_dimensions = (context ? Vector2f(context->GetDimensions()) : Vector2f(1.0f));
Update(dp_ratio, vp_dimensions);
UpdateLayout();
UpdatePosition();
}
// Updates the layout if necessary.
void ElementDocument::UpdateLayout()
{
// Note: Carefully consider when to call this function for performance reasons.
// Ideally, only called once per update loop.
if(layout_dirty)
{
RMLUI_ZoneScoped;
RMLUI_ZoneText(source_url.c_str(), source_url.size());
Vector2f containing_block(0, 0);
if (GetParentNode() != nullptr)
containing_block = GetParentNode()->GetBox().GetSize();
LayoutEngine::FormatElement(this, containing_block);
// Ignore dirtied layout during document formatting. Layouting must not require re-iteration.
// In particular, scrollbars being enabled may set the dirty flag, but this case is already handled within the layout engine.
layout_dirty = false;
}
}
// Updates the position of the document based on the style properties.
void ElementDocument::UpdatePosition()
{
if (position_dirty)
{
RMLUI_ZoneScoped;
position_dirty = false;
Element* root = GetParentNode();
// We only position ourselves if we are a child of our context's root element. That is, we don't want to proceed
// if we are unparented or an iframe document.
if (!root || !context || (root != context->GetRootElement()))
return;
// Work out our containing block; relative offsets are calculated against it.
const Vector2f containing_block = root->GetBox().GetSize();
auto& computed = GetComputedValues();
const Box& box = GetBox();
Vector2f position;
if (computed.left().type != Style::Left::Auto)
position.x = ResolveValue(computed.left(), containing_block.x);
else if (computed.right().type != Style::Right::Auto)
position.x = containing_block.x - (box.GetSize(Box::MARGIN).x + ResolveValue(computed.right(), containing_block.x));
if (computed.top().type != Style::Top::Auto)
position.y = ResolveValue(computed.top(), containing_block.y);
else if (computed.bottom().type != Style::Bottom::Auto)
position.y = containing_block.y - (box.GetSize(Box::MARGIN).y + ResolveValue(computed.bottom(), containing_block.y));
// Add the margin edge to the position, since inset properties (top/right/bottom/left) set the margin edge
// position, while offsets use the border edge.
position.x += box.GetEdge(Box::MARGIN, Box::LEFT);
position.y += box.GetEdge(Box::MARGIN, Box::TOP);
SetOffset(position, nullptr);
}
}
void ElementDocument::DirtyPosition()
{
position_dirty = true;
}
void ElementDocument::DirtyLayout()
{
layout_dirty = true;
}
bool ElementDocument::IsLayoutDirty()
{
return layout_dirty;
}
void ElementDocument::DirtyVwAndVhProperties()
{
GetStyle()->DirtyPropertiesWithUnitsRecursive(Property::VW | Property::VH);
}
// Repositions the document if necessary.
void ElementDocument::OnPropertyChange(const PropertyIdSet& changed_properties)
{
Element::OnPropertyChange(changed_properties);
// If the document's font-size has been changed, we need to dirty all rem properties.
if (changed_properties.Contains(PropertyId::FontSize))
GetStyle()->DirtyPropertiesWithUnitsRecursive(Property::REM);
if (changed_properties.Contains(PropertyId::Top) ||
changed_properties.Contains(PropertyId::Right) ||
changed_properties.Contains(PropertyId::Bottom) ||
changed_properties.Contains(PropertyId::Left))
DirtyPosition();
}
// Processes the 'onpropertychange' event, checking for a change in position or size.
void ElementDocument::ProcessDefaultAction(Event& event)
{
Element::ProcessDefaultAction(event);
// Process generic keyboard events for this window in bubble phase
if (event == EventId::Keydown)
{
int key_identifier = event.GetParameter("key_identifier", Input::KI_UNKNOWN);
// Process TAB
if (key_identifier == Input::KI_TAB)
{
if (Element* element = FindNextTabElement(event.GetTargetElement(), !event.GetParameter("shift_key", false)))
{
if(element->Focus())
{
element->ScrollIntoView(false);
event.StopPropagation();
}
}
}
// Process ENTER being pressed on a focusable object (emulate click)
else if (key_identifier == Input::KI_RETURN ||
key_identifier == Input::KI_NUMPADENTER)
{
Element* focus_node = GetFocusLeafNode();
if (focus_node && focus_node->GetComputedValues().tab_index() == Style::TabIndex::Auto)
{
focus_node->Click();
event.StopPropagation();
}
}
}
}
void ElementDocument::OnResize()
{
DirtyPosition();
}
enum class CanFocus { Yes, No, NoAndNoChildren };
static CanFocus CanFocusElement(Element* element)
{
if (!element->IsVisible())
return CanFocus::NoAndNoChildren;
const ComputedValues& computed = element->GetComputedValues();
if (computed.focus() == Style::Focus::None)
return CanFocus::NoAndNoChildren;
if (computed.tab_index() == Style::TabIndex::Auto)
return CanFocus::Yes;
return CanFocus::No;
}
// Find the next element to focus, starting at the current element
//
// This algorithm is quite sneaky, I originally thought a depth first search would
// work, but it appears not. What is required is to cut the tree in half along the nodes
// from current_element up the root and then either traverse the tree in a clockwise or
// anticlock wise direction depending if you're searching forward or backward respectively
Element* ElementDocument::FindNextTabElement(Element* current_element, bool forward)
{
// If we're searching forward, check the immediate children of this node first off.
if (forward)
{
for (int i = 0; i < current_element->GetNumChildren(); i++)
if (Element* result = SearchFocusSubtree(current_element->GetChild(i), forward))
return result;
}
// Now walk up the tree, testing either the bottom or top
// of the tree, depending on whether we're going forward
// or backward respectively.
bool search_enabled = false;
Element* document = current_element->GetOwnerDocument();
Element* child = current_element;
Element* parent = current_element->GetParentNode();
while (child != document)
{
const int num_children = parent->GetNumChildren();
for (int i = 0; i < num_children; i++)
{
// Calculate index into children
const int child_index = forward ? i : (num_children - i - 1);
Element* search_child = parent->GetChild(child_index);
// Do a search if its enabled
if (search_enabled)
if(Element* result = SearchFocusSubtree(search_child, forward))
return result;
// Enable searching when we reach the child.
if (search_child == child)
search_enabled = true;
}
// Advance up the tree
child = parent;
parent = parent->GetParentNode();
search_enabled = false;
}
// We could not find anything to focus along this direction.
// If we can focus the document, then focus that now.
if (current_element != document && CanFocusElement(document) == CanFocus::Yes)
return document;
// Otherwise, search the entire document tree. This way we will wrap around.
const int num_children = document->GetNumChildren();
for (int i = 0; i < num_children; i++)
{
const int child_index = forward ? i : (num_children - i - 1);
if (Element* result = SearchFocusSubtree(document->GetChild(child_index), forward))
return result;
}
return nullptr;
}
Element* ElementDocument::SearchFocusSubtree(Element* element, bool forward)
{
CanFocus can_focus = CanFocusElement(element);
if (can_focus == CanFocus::Yes)
return element;
else if (can_focus == CanFocus::NoAndNoChildren)
return nullptr;
// Check all children
for (int i = 0; i < element->GetNumChildren(); i++)
{
int child_index = i;
if (!forward)
child_index = element->GetNumChildren() - i - 1;
if (Element * result = SearchFocusSubtree(element->GetChild(child_index), forward))
return result;
}
return nullptr;
}
} // namespace Rml