2006-11-24 14:37:00 +00:00
|
|
|
/* -*- Mode: Objective-C++; tab-width: 2; indent-tabs-mode: nil; c-basic-offset: 2 -*- */
|
|
|
|
/* ***** BEGIN LICENSE BLOCK *****
|
|
|
|
* Version: MPL 1.1/GPL 2.0/LGPL 2.1
|
|
|
|
*
|
|
|
|
* The contents of this file are subject to the Mozilla Public License Version
|
|
|
|
* 1.1 (the "License"); you may not use this file except in compliance with
|
|
|
|
* the License. You may obtain a copy of the License at
|
|
|
|
* http://www.mozilla.org/MPL/
|
|
|
|
*
|
|
|
|
* Software distributed under the License is distributed on an "AS IS" basis,
|
|
|
|
* WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License
|
|
|
|
* for the specific language governing rights and limitations under the
|
|
|
|
* License.
|
|
|
|
*
|
|
|
|
* The Original Code is mozilla.org code.
|
|
|
|
*
|
|
|
|
* The Initial Developer of the Original Code is
|
|
|
|
* Mozilla Foundation.
|
|
|
|
* Portions created by the Initial Developer are Copyright (C) 2006
|
|
|
|
* the Initial Developer. All Rights Reserved.
|
|
|
|
*
|
|
|
|
* Contributor(s):
|
|
|
|
* Original Author: Håkan Waara <hwaara@gmail.com>
|
|
|
|
*
|
|
|
|
* Alternatively, the contents of this file may be used under the terms of
|
|
|
|
* either of the GNU General Public License Version 2 or later (the "GPL"),
|
|
|
|
* or the GNU Lesser General Public License Version 2.1 or later (the "LGPL"),
|
|
|
|
* in which case the provisions of the GPL or the LGPL are applicable instead
|
|
|
|
* of those above. If you wish to allow use of your version of this file only
|
|
|
|
* under the terms of either the GPL or the LGPL, and not to allow others to
|
|
|
|
* use your version of this file under the terms of the MPL, indicate your
|
|
|
|
* decision by deleting the provisions above and replace them with the notice
|
|
|
|
* and other provisions required by the GPL or the LGPL. If you do not delete
|
|
|
|
* the provisions above, a recipient may use your version of this file under
|
|
|
|
* the terms of any one of the MPL, the GPL or the LGPL.
|
|
|
|
*
|
|
|
|
* ***** END LICENSE BLOCK ***** */
|
|
|
|
|
2006-11-15 11:08:14 +00:00
|
|
|
#import "mozActionElements.h"
|
2012-01-27 06:14:09 +00:00
|
|
|
|
|
|
|
#import "MacUtils.h"
|
|
|
|
|
2006-11-15 11:08:14 +00:00
|
|
|
#import "nsIAccessible.h"
|
2012-01-27 06:14:09 +00:00
|
|
|
#import "nsXULTabAccessible.h"
|
2006-11-15 11:08:14 +00:00
|
|
|
|
2008-02-22 20:13:17 +00:00
|
|
|
#include "nsObjCExceptions.h"
|
|
|
|
|
2011-07-27 12:43:01 +00:00
|
|
|
using namespace mozilla::a11y;
|
|
|
|
|
2006-11-24 14:37:00 +00:00
|
|
|
enum CheckboxValue {
|
|
|
|
// these constants correspond to the values in the OS
|
|
|
|
kUnchecked = 0,
|
|
|
|
kChecked = 1,
|
|
|
|
kMixed = 2
|
|
|
|
};
|
|
|
|
|
2006-11-15 11:08:14 +00:00
|
|
|
@implementation mozButtonAccessible
|
|
|
|
|
|
|
|
- (NSArray*)accessibilityAttributeNames
|
|
|
|
{
|
2008-02-22 20:13:17 +00:00
|
|
|
NS_OBJC_BEGIN_TRY_ABORT_BLOCK_NIL;
|
|
|
|
|
2006-11-15 11:08:14 +00:00
|
|
|
static NSArray *attributes = nil;
|
|
|
|
if (!attributes) {
|
|
|
|
attributes = [[NSArray alloc] initWithObjects:NSAccessibilityParentAttribute, // required
|
|
|
|
NSAccessibilityRoleAttribute, // required
|
2012-01-27 06:14:09 +00:00
|
|
|
NSAccessibilityRoleDescriptionAttribute,
|
2006-11-15 11:08:14 +00:00
|
|
|
NSAccessibilityPositionAttribute, // required
|
|
|
|
NSAccessibilitySizeAttribute, // required
|
|
|
|
NSAccessibilityWindowAttribute, // required
|
|
|
|
NSAccessibilityPositionAttribute, // required
|
2011-12-09 07:25:25 +00:00
|
|
|
NSAccessibilityTopLevelUIElementAttribute, // required
|
2006-11-15 11:08:14 +00:00
|
|
|
NSAccessibilityHelpAttribute,
|
|
|
|
NSAccessibilityEnabledAttribute, // required
|
|
|
|
NSAccessibilityFocusedAttribute, // required
|
|
|
|
NSAccessibilityTitleAttribute, // required
|
2011-12-09 07:25:25 +00:00
|
|
|
NSAccessibilityDescriptionAttribute,
|
2012-01-27 15:50:04 +00:00
|
|
|
#if DEBUG
|
|
|
|
@"AXMozDescription",
|
|
|
|
#endif
|
2006-11-15 11:08:14 +00:00
|
|
|
nil];
|
|
|
|
}
|
|
|
|
return attributes;
|
2008-02-22 20:13:17 +00:00
|
|
|
|
|
|
|
NS_OBJC_END_TRY_ABORT_BLOCK_NIL;
|
2006-11-15 11:08:14 +00:00
|
|
|
}
|
|
|
|
|
2006-12-06 13:35:56 +00:00
|
|
|
- (id)accessibilityAttributeValue:(NSString *)attribute
|
|
|
|
{
|
2008-02-22 20:13:17 +00:00
|
|
|
NS_OBJC_BEGIN_TRY_ABORT_BLOCK_NIL;
|
|
|
|
|
2006-12-06 13:35:56 +00:00
|
|
|
if ([attribute isEqualToString:NSAccessibilityChildrenAttribute])
|
|
|
|
return nil;
|
2012-01-27 06:14:09 +00:00
|
|
|
if ([attribute isEqualToString:NSAccessibilityRoleDescriptionAttribute]) {
|
|
|
|
if ([self isTab])
|
|
|
|
return utils::LocalizedString(NS_LITERAL_STRING("tab"));
|
|
|
|
|
|
|
|
return NSAccessibilityRoleDescription([self role], nil);
|
|
|
|
}
|
|
|
|
|
2006-12-06 13:35:56 +00:00
|
|
|
return [super accessibilityAttributeValue:attribute];
|
2008-02-22 20:13:17 +00:00
|
|
|
|
|
|
|
NS_OBJC_END_TRY_ABORT_BLOCK_NIL;
|
2006-12-06 13:35:56 +00:00
|
|
|
}
|
|
|
|
|
2006-11-15 11:08:14 +00:00
|
|
|
- (BOOL)accessibilityIsIgnored
|
|
|
|
{
|
|
|
|
return mIsExpired;
|
|
|
|
}
|
|
|
|
|
|
|
|
- (NSArray*)accessibilityActionNames
|
|
|
|
{
|
2008-02-22 20:13:17 +00:00
|
|
|
NS_OBJC_BEGIN_TRY_ABORT_BLOCK_NIL;
|
|
|
|
|
2006-11-15 11:08:14 +00:00
|
|
|
if ([self isEnabled])
|
|
|
|
return [NSArray arrayWithObject:NSAccessibilityPressAction];
|
|
|
|
|
|
|
|
return nil;
|
2008-02-22 20:13:17 +00:00
|
|
|
|
|
|
|
NS_OBJC_END_TRY_ABORT_BLOCK_NIL;
|
2006-11-15 11:08:14 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
- (NSString*)accessibilityActionDescription:(NSString*)action
|
|
|
|
{
|
2008-02-22 20:13:17 +00:00
|
|
|
NS_OBJC_BEGIN_TRY_ABORT_BLOCK_NIL;
|
|
|
|
|
2012-01-27 06:14:09 +00:00
|
|
|
if ([action isEqualToString:NSAccessibilityPressAction]) {
|
|
|
|
if ([self isTab])
|
|
|
|
return utils::LocalizedString(NS_LITERAL_STRING("switch"));
|
|
|
|
|
2006-11-15 11:08:14 +00:00
|
|
|
return @"press button"; // XXX: localize this later?
|
2012-01-27 06:14:09 +00:00
|
|
|
}
|
|
|
|
|
2006-11-15 11:08:14 +00:00
|
|
|
return nil;
|
2008-02-22 20:13:17 +00:00
|
|
|
|
|
|
|
NS_OBJC_END_TRY_ABORT_BLOCK_NIL;
|
2006-11-15 11:08:14 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
- (void)accessibilityPerformAction:(NSString*)action
|
|
|
|
{
|
2008-02-22 20:13:17 +00:00
|
|
|
NS_OBJC_BEGIN_TRY_ABORT_BLOCK;
|
|
|
|
|
2006-11-15 11:08:14 +00:00
|
|
|
if ([action isEqualToString:NSAccessibilityPressAction])
|
|
|
|
[self click];
|
2008-02-22 20:13:17 +00:00
|
|
|
|
|
|
|
NS_OBJC_END_TRY_ABORT_BLOCK;
|
2006-11-15 11:08:14 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
- (void)click
|
|
|
|
{
|
|
|
|
// both buttons and checkboxes have only one action. we should really stop using arbitrary
|
|
|
|
// arrays with actions, and define constants for these actions.
|
|
|
|
mGeckoAccessible->DoAction(0);
|
|
|
|
}
|
|
|
|
|
2012-01-27 06:14:09 +00:00
|
|
|
- (BOOL)isTab
|
|
|
|
{
|
|
|
|
return (mGeckoAccessible && (mGeckoAccessible->Role() == roles::PAGETAB));
|
|
|
|
}
|
|
|
|
|
2006-11-15 11:08:14 +00:00
|
|
|
@end
|
|
|
|
|
|
|
|
@implementation mozCheckboxAccessible
|
|
|
|
|
|
|
|
- (NSString*)accessibilityActionDescription:(NSString*)action
|
|
|
|
{
|
2008-02-22 20:13:17 +00:00
|
|
|
NS_OBJC_BEGIN_TRY_ABORT_BLOCK_NIL;
|
|
|
|
|
2006-11-15 11:08:14 +00:00
|
|
|
if ([action isEqualToString:NSAccessibilityPressAction]) {
|
2006-11-24 14:37:00 +00:00
|
|
|
if ([self isChecked] != kUnchecked)
|
2006-11-15 11:08:14 +00:00
|
|
|
return @"uncheck checkbox"; // XXX: localize this later?
|
|
|
|
|
|
|
|
return @"check checkbox"; // XXX: localize this later?
|
|
|
|
}
|
|
|
|
|
|
|
|
return nil;
|
2008-02-22 20:13:17 +00:00
|
|
|
|
|
|
|
NS_OBJC_END_TRY_ABORT_BLOCK_NIL;
|
2006-11-15 11:08:14 +00:00
|
|
|
}
|
|
|
|
|
2006-11-24 14:37:00 +00:00
|
|
|
- (int)isChecked
|
2006-11-15 11:08:14 +00:00
|
|
|
{
|
2011-04-09 23:38:06 +00:00
|
|
|
PRUint64 state = mGeckoAccessible->NativeState();
|
2007-04-04 10:36:38 +00:00
|
|
|
|
2006-11-24 14:37:00 +00:00
|
|
|
// check if we're checked or in a mixed state
|
2011-04-09 23:38:06 +00:00
|
|
|
if (state & states::CHECKED) {
|
|
|
|
return (state & states::MIXED) ? kMixed : kChecked;
|
2006-11-24 14:37:00 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
return kUnchecked;
|
2006-11-15 11:08:14 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
- (id)value
|
|
|
|
{
|
2008-02-22 20:13:17 +00:00
|
|
|
NS_OBJC_BEGIN_TRY_ABORT_BLOCK_NIL;
|
|
|
|
|
2006-11-24 14:37:00 +00:00
|
|
|
return [NSNumber numberWithInt:[self isChecked]];
|
2008-02-22 20:13:17 +00:00
|
|
|
|
|
|
|
NS_OBJC_END_TRY_ABORT_BLOCK_NIL;
|
2006-11-15 11:08:14 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
@end
|
2006-12-06 13:35:56 +00:00
|
|
|
|
|
|
|
@implementation mozPopupButtonAccessible
|
|
|
|
|
|
|
|
- (NSArray *)accessibilityAttributeNames
|
|
|
|
{
|
2008-02-22 20:13:17 +00:00
|
|
|
NS_OBJC_BEGIN_TRY_ABORT_BLOCK_NIL;
|
|
|
|
|
2006-12-06 13:35:56 +00:00
|
|
|
static NSArray *attributes = nil;
|
|
|
|
|
|
|
|
if (!attributes) {
|
|
|
|
attributes = [[NSArray alloc] initWithObjects:NSAccessibilityParentAttribute, // required
|
|
|
|
NSAccessibilityPositionAttribute, // required
|
|
|
|
NSAccessibilityRoleAttribute, // required
|
|
|
|
NSAccessibilitySizeAttribute, // required
|
|
|
|
NSAccessibilityWindowAttribute, // required
|
2011-12-09 07:25:25 +00:00
|
|
|
NSAccessibilityTopLevelUIElementAttribute, // required
|
2006-12-06 13:35:56 +00:00
|
|
|
NSAccessibilityHelpAttribute,
|
|
|
|
NSAccessibilityEnabledAttribute, // required
|
|
|
|
NSAccessibilityFocusedAttribute, // required
|
|
|
|
NSAccessibilityTitleAttribute, // required for popupmenus, and for menubuttons with a title
|
|
|
|
NSAccessibilityChildrenAttribute, // required
|
2011-12-09 07:25:25 +00:00
|
|
|
NSAccessibilityDescriptionAttribute, // required if it has no title attr
|
2012-01-27 15:50:04 +00:00
|
|
|
#if DEBUG
|
|
|
|
@"AXMozDescription",
|
|
|
|
#endif
|
2006-12-06 13:35:56 +00:00
|
|
|
nil];
|
|
|
|
}
|
|
|
|
return attributes;
|
2008-02-22 20:13:17 +00:00
|
|
|
|
|
|
|
NS_OBJC_END_TRY_ABORT_BLOCK_NIL;
|
2006-12-06 13:35:56 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
- (id)accessibilityAttributeValue:(NSString *)attribute
|
|
|
|
{
|
2008-02-22 20:13:17 +00:00
|
|
|
NS_OBJC_BEGIN_TRY_ABORT_BLOCK_NIL;
|
|
|
|
|
2006-12-06 13:35:56 +00:00
|
|
|
if ([attribute isEqualToString:NSAccessibilityChildrenAttribute]) {
|
|
|
|
return [super children];
|
|
|
|
}
|
|
|
|
return [super accessibilityAttributeValue:attribute];
|
2008-02-22 20:13:17 +00:00
|
|
|
|
|
|
|
NS_OBJC_END_TRY_ABORT_BLOCK_NIL;
|
2006-12-06 13:35:56 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
- (NSArray *)accessibilityActionNames
|
|
|
|
{
|
2008-02-22 20:13:17 +00:00
|
|
|
NS_OBJC_BEGIN_TRY_ABORT_BLOCK_NIL;
|
|
|
|
|
2006-12-06 13:35:56 +00:00
|
|
|
if ([self isEnabled]) {
|
2007-03-27 14:07:09 +00:00
|
|
|
return [NSArray arrayWithObjects:NSAccessibilityPressAction,
|
|
|
|
NSAccessibilityShowMenuAction,
|
2006-12-06 13:35:56 +00:00
|
|
|
nil];
|
|
|
|
}
|
|
|
|
return nil;
|
2008-02-22 20:13:17 +00:00
|
|
|
|
|
|
|
NS_OBJC_END_TRY_ABORT_BLOCK_NIL;
|
2006-12-06 13:35:56 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
- (NSString *)accessibilityActionDescription:(NSString *)action
|
|
|
|
{
|
2008-02-22 20:13:17 +00:00
|
|
|
NS_OBJC_BEGIN_TRY_ABORT_BLOCK_NIL;
|
|
|
|
|
2006-12-06 13:35:56 +00:00
|
|
|
if ([action isEqualToString:NSAccessibilityShowMenuAction])
|
|
|
|
return @"show menu";
|
|
|
|
return [super accessibilityActionDescription:action];
|
2008-02-22 20:13:17 +00:00
|
|
|
|
|
|
|
NS_OBJC_END_TRY_ABORT_BLOCK_NIL;
|
2006-12-06 13:35:56 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
- (void)accessibilityPerformAction:(NSString *)action
|
|
|
|
{
|
2008-02-22 20:13:17 +00:00
|
|
|
NS_OBJC_BEGIN_TRY_ABORT_BLOCK;
|
|
|
|
|
2006-12-06 13:35:56 +00:00
|
|
|
// both the ShowMenu and Click action do the same thing.
|
|
|
|
if ([self isEnabled]) {
|
|
|
|
// TODO: this should bring up the menu, but currently doesn't.
|
|
|
|
// once msaa and atk have merged better, they will implement
|
|
|
|
// the action needed to show the menu.
|
|
|
|
[super click];
|
|
|
|
}
|
2008-02-22 20:13:17 +00:00
|
|
|
|
|
|
|
NS_OBJC_END_TRY_ABORT_BLOCK;
|
2006-12-06 13:35:56 +00:00
|
|
|
}
|
|
|
|
|
|
|
|
@end
|
2012-01-27 06:14:09 +00:00
|
|
|
|
|
|
|
@implementation mozTabsAccessible
|
|
|
|
|
|
|
|
- (void)dealloc
|
|
|
|
{
|
|
|
|
[mTabs release];
|
|
|
|
|
|
|
|
[super dealloc];
|
|
|
|
}
|
|
|
|
|
|
|
|
- (NSArray*)accessibilityAttributeNames
|
|
|
|
{
|
|
|
|
// standard attributes that are shared and supported by root accessible (AXMain) elements.
|
|
|
|
static NSMutableArray* attributes = nil;
|
|
|
|
|
|
|
|
if (!attributes) {
|
|
|
|
attributes = [[super accessibilityAttributeNames] mutableCopy];
|
|
|
|
[attributes addObject:NSAccessibilityContentsAttribute];
|
|
|
|
[attributes addObject:NSAccessibilityTabsAttribute];
|
|
|
|
}
|
|
|
|
|
|
|
|
return attributes;
|
|
|
|
}
|
|
|
|
|
|
|
|
- (id)accessibilityAttributeValue:(NSString *)attribute
|
|
|
|
{
|
|
|
|
if ([attribute isEqualToString:NSAccessibilityContentsAttribute])
|
|
|
|
return [super children];
|
|
|
|
if ([attribute isEqualToString:NSAccessibilityTabsAttribute])
|
|
|
|
return [self tabs];
|
|
|
|
|
|
|
|
return [super accessibilityAttributeValue:attribute];
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Returns the selected tab (the mozAccessible)
|
|
|
|
*/
|
|
|
|
- (id)value
|
|
|
|
{
|
|
|
|
if (!mGeckoAccessible)
|
|
|
|
return nil;
|
|
|
|
|
|
|
|
nsAccessible* accessible = mGeckoAccessible->GetSelectedItem(0);
|
|
|
|
if (!accessible)
|
|
|
|
return nil;
|
|
|
|
|
|
|
|
mozAccessible* nativeAcc = nil;
|
|
|
|
nsresult rv = accessible->GetNativeInterface((void**)&nativeAcc);
|
|
|
|
NS_ENSURE_SUCCESS(rv, nil);
|
|
|
|
|
|
|
|
return nativeAcc;
|
|
|
|
}
|
|
|
|
|
|
|
|
/**
|
|
|
|
* Return the mozAccessibles that are the tabs.
|
|
|
|
*/
|
|
|
|
- (id)tabs
|
|
|
|
{
|
|
|
|
if (mTabs)
|
|
|
|
return mTabs;
|
|
|
|
|
|
|
|
NSArray* children = [self children];
|
|
|
|
NSEnumerator* enumerator = [children objectEnumerator];
|
|
|
|
mTabs = [[NSMutableArray alloc] init];
|
|
|
|
|
|
|
|
id obj;
|
|
|
|
while ((obj = [enumerator nextObject]))
|
|
|
|
if ([obj isTab])
|
|
|
|
[mTabs addObject:obj];
|
|
|
|
|
|
|
|
return mTabs;
|
|
|
|
}
|
|
|
|
|
|
|
|
- (void)invalidateChildren
|
|
|
|
{
|
|
|
|
[super invalidateChildren];
|
|
|
|
|
|
|
|
[mTabs release];
|
|
|
|
mTabs = nil;
|
|
|
|
}
|
|
|
|
|
|
|
|
@end
|