2 * Copyright (c) 2021 Samsung Electronics Co., Ltd.
4 * Licensed under the Apache License, Version 2.0 (the "License");
5 * you may not use this file except in compliance with the License.
6 * You may obtain a copy of the License at
8 * http://www.apache.org/licenses/LICENSE-2.0
10 * Unless required by applicable law or agreed to in writing, software
11 * distributed under the License is distributed on an "AS IS" BASIS,
12 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
13 * See the License for the specific language governing permissions and
14 * limitations under the License.
19 #include "accessibility-manager-impl.h"
22 #include <dali/devel-api/adaptor-framework/accessibility-impl.h>
23 #include <dali/devel-api/adaptor-framework/accessibility.h>
26 #include <dali-toolkit/devel-api/controls/control-devel.h>
27 #include <dali-toolkit/public-api/controls/control-impl.h>
28 #include <dali-toolkit/public-api/controls/control.h>
36 AccessibilityManager::AccessibilityManager()
38 mFocusOrder.push_back({}); // zero has a special meaning
41 AccessibilityManager::~AccessibilityManager()
45 void AccessibilityManager::SetAccessibilityAttribute(Actor actor, Toolkit::AccessibilityManager::AccessibilityAttribute type, const std::string& text)
49 case Toolkit::AccessibilityManager::ACCESSIBILITY_LABEL:
50 actor.SetProperty(Toolkit::DevelControl::Property::ACCESSIBILITY_NAME, text);
53 case Toolkit::AccessibilityManager::ACCESSIBILITY_HINT:
54 actor.SetProperty(Toolkit::DevelControl::Property::ACCESSIBILITY_DESCRIPTION, text);
57 case Toolkit::AccessibilityManager::ACCESSIBILITY_TRAIT:
58 case Toolkit::AccessibilityManager::ACCESSIBILITY_VALUE:
64 std::string AccessibilityManager::GetAccessibilityAttribute(Actor actor, Toolkit::AccessibilityManager::AccessibilityAttribute type) const
68 case Toolkit::AccessibilityManager::ACCESSIBILITY_LABEL:
69 return actor.GetProperty<std::string>(Toolkit::DevelControl::Property::ACCESSIBILITY_NAME);
71 case Toolkit::AccessibilityManager::ACCESSIBILITY_HINT:
72 return actor.GetProperty<std::string>(Toolkit::DevelControl::Property::ACCESSIBILITY_DESCRIPTION);
74 case Toolkit::AccessibilityManager::ACCESSIBILITY_TRAIT:
75 case Toolkit::AccessibilityManager::ACCESSIBILITY_VALUE:
81 void AccessibilityManager::SetFocusOrder(Actor actor, const unsigned int order)
86 if(order >= mFocusOrder.size())
87 mFocusOrder.resize(order + 1);
89 auto it = mFocusOrder.begin() + order;
90 mFocusOrder.insert(it, actor);
94 Actor prev = mFocusOrder[order - 1];
95 DevelControl::AppendAccessibilityRelation(prev, actor, Accessibility::RelationType::FLOWS_TO);
96 DevelControl::AppendAccessibilityRelation(actor, prev, Accessibility::RelationType::FLOWS_FROM);
99 if(order + 1 < mFocusOrder.size())
101 Actor next = mFocusOrder[order + 1];
102 DevelControl::AppendAccessibilityRelation(actor, next, Accessibility::RelationType::FLOWS_TO);
103 DevelControl::AppendAccessibilityRelation(next, actor, Accessibility::RelationType::FLOWS_FROM);
107 unsigned int AccessibilityManager::GetFocusOrder(Actor actor) const
109 for(auto it = mFocusOrder.begin(); it != mFocusOrder.end(); ++it)
112 return it - mFocusOrder.begin();
118 unsigned int AccessibilityManager::GenerateNewFocusOrder() const
120 return static_cast<unsigned>(mFocusOrder.size());
123 Actor AccessibilityManager::GetActorByFocusOrder(const unsigned int order)
127 if(order > 0 && order < mFocusOrder.size())
128 actor = mFocusOrder[order];
133 bool AccessibilityManager::SetCurrentFocusActor(Actor actor)
135 return Toolkit::DevelControl::GrabAccessibilityHighlight(actor);
138 Actor AccessibilityManager::GetCurrentFocusActor()
140 return Dali::Accessibility::Accessible::GetCurrentlyHighlightedActor();
143 Actor AccessibilityManager::GetCurrentFocusGroup()
145 return GetFocusGroup(GetCurrentFocusActor());
148 unsigned int AccessibilityManager::GetCurrentFocusOrder()
150 auto actor = GetCurrentFocusActor();
154 order = GetFocusOrder(actor);
159 bool AccessibilityManager::MoveFocusForward()
161 unsigned current = GetCurrentFocusOrder();
163 if(current + 1 < mFocusOrder.size())
164 return SetCurrentFocusActor(mFocusOrder[current + 1]);
169 bool AccessibilityManager::MoveFocusBackward()
171 unsigned current = GetCurrentFocusOrder();
173 if(current > 1) // zero has a special meaning
174 return SetCurrentFocusActor(mFocusOrder[current - 1]);
179 void AccessibilityManager::ClearFocus()
181 auto actor = GetCurrentFocusActor();
182 Toolkit::DevelControl::ClearAccessibilityHighlight(actor);
185 void AccessibilityManager::Reset()
189 for(std::size_t i = 2; i < mFocusOrder.size(); ++i)
191 Actor prev = mFocusOrder[i - 1];
192 Actor next = mFocusOrder[i];
194 DevelControl::RemoveAccessibilityRelation(prev, next, Accessibility::RelationType::FLOWS_TO);
195 DevelControl::RemoveAccessibilityRelation(next, prev, Accessibility::RelationType::FLOWS_FROM);
199 mFocusOrder.push_back({});
202 void AccessibilityManager::SetFocusGroup(Actor actor, bool isFocusGroup)
206 bool AccessibilityManager::IsFocusGroup(Actor actor) const
211 Actor AccessibilityManager::GetFocusGroup(Actor actor)
216 Vector2 AccessibilityManager::GetReadPosition() const
221 void AccessibilityManager::SetGroupMode(bool enabled)
225 bool AccessibilityManager::GetGroupMode() const
230 void AccessibilityManager::SetWrapMode(bool wrapped)
234 bool AccessibilityManager::GetWrapMode() const
239 void AccessibilityManager::SetFocusIndicatorActor(Actor indicator)
241 Dali::Accessibility::Accessible::SetHighlightActor(indicator);
244 Actor AccessibilityManager::GetFocusIndicatorActor()
246 return Dali::Accessibility::Accessible::GetHighlightActor();
249 Toolkit::AccessibilityManager::FocusChangedSignalType& AccessibilityManager::FocusChangedSignal()
251 return mFocusChangedSignal;
254 Toolkit::AccessibilityManager::FocusOvershotSignalType& AccessibilityManager::FocusOvershotSignal()
256 return mFocusOvershotSignal;
259 Toolkit::AccessibilityManager::FocusedActorActivatedSignalType& AccessibilityManager::FocusedActorActivatedSignal()
261 return mFocusedActorActivatedSignal;
264 } // namespace Internal
266 } // namespace Toolkit