#include <ax_platform_node_mac.h>

Inheritance diagram for ui::AXPlatformNodeMac:

Public Member Functions
	AXPlatformNodeMac ()

gfx::NativeViewAccessible	GetNativeViewAccessible () override

void	NotifyAccessibilityEvent (ax::mojom::Event event_type) override

void	AnnounceText (const std::u16string &text) override

void	Destroy () override

bool	IsPlatformCheckable () const override

Public Member Functions inherited from ui::AXPlatformNodeBase
	AXPlatformNodeBase ()

	~AXPlatformNodeBase () override

virtual void	Init (AXPlatformNodeDelegate *delegate)

const AXNodeData &	GetData () const

gfx::NativeViewAccessible	GetFocus ()

gfx::NativeViewAccessible	GetParent () const

int	GetChildCount () const

gfx::NativeViewAccessible	ChildAtIndex (int index) const

std::string	GetName () const

std::u16string	GetNameAsString16 () const

virtual std::optional< int >	GetIndexInParent ()

std::stack< gfx::NativeViewAccessible >	GetAncestors ()

std::optional< int >	CompareTo (AXPlatformNodeBase &other)

AXPlatformNodeDelegate *	GetDelegate () const override

bool	IsDescendantOf (AXPlatformNode *ancestor) const override

AXPlatformNodeBase *	GetPreviousSibling () const

AXPlatformNodeBase *	GetNextSibling () const

AXPlatformNodeBase *	GetFirstChild () const

AXPlatformNodeBase *	GetLastChild () const

bool	IsDescendant (AXPlatformNodeBase *descendant)

AXPlatformNodeChildIterator	AXPlatformNodeChildrenBegin () const

AXPlatformNodeChildIterator	AXPlatformNodeChildrenEnd () const

bool	HasBoolAttribute (ax::mojom::BoolAttribute attr) const

bool	GetBoolAttribute (ax::mojom::BoolAttribute attr) const

bool	GetBoolAttribute (ax::mojom::BoolAttribute attr, bool *value) const

bool	HasFloatAttribute (ax::mojom::FloatAttribute attr) const

float	GetFloatAttribute (ax::mojom::FloatAttribute attr) const

bool	GetFloatAttribute (ax::mojom::FloatAttribute attr, float *value) const

bool	HasIntAttribute (ax::mojom::IntAttribute attribute) const

int	GetIntAttribute (ax::mojom::IntAttribute attribute) const

bool	GetIntAttribute (ax::mojom::IntAttribute attribute, int *value) const

bool	HasStringAttribute (ax::mojom::StringAttribute attribute) const

const std::string &	GetStringAttribute (ax::mojom::StringAttribute attribute) const

bool	GetStringAttribute (ax::mojom::StringAttribute attribute, std::string *value) const

bool	GetString16Attribute (ax::mojom::StringAttribute attribute, std::u16string *value) const

std::u16string	GetString16Attribute (ax::mojom::StringAttribute attribute) const

bool	HasInheritedStringAttribute (ax::mojom::StringAttribute attribute) const

const std::string &	GetInheritedStringAttribute (ax::mojom::StringAttribute attribute) const

std::u16string	GetInheritedString16Attribute (ax::mojom::StringAttribute attribute) const

bool	GetInheritedStringAttribute (ax::mojom::StringAttribute attribute, std::string *value) const

bool	GetInheritedString16Attribute (ax::mojom::StringAttribute attribute, std::u16string *value) const

bool	HasIntListAttribute (ax::mojom::IntListAttribute attribute) const

const std::vector< int32_t > &	GetIntListAttribute (ax::mojom::IntListAttribute attribute) const

bool	GetIntListAttribute (ax::mojom::IntListAttribute attribute, std::vector< int32_t > *value) const

AXPlatformNodeBase *	GetSelectionContainer () const

AXPlatformNodeBase *	GetTable () const

AXPlatformNodeBase *	GetTableCaption () const

AXPlatformNodeBase *	GetTableCell (int index) const

AXPlatformNodeBase *	GetTableCell (int row, int column) const

std::optional< int >	GetTableCellIndex () const

std::optional< int >	GetTableColumn () const

std::optional< int >	GetTableColumnCount () const

std::optional< int >	GetTableAriaColumnCount () const

std::optional< int >	GetTableColumnSpan () const

std::optional< int >	GetTableRow () const

std::optional< int >	GetTableRowCount () const

std::optional< int >	GetTableAriaRowCount () const

std::optional< int >	GetTableRowSpan () const

std::optional< float >	GetFontSizeInPoints () const

bool	HasCaret (const AXTree::Selection *unignored_selection=nullptr)

bool	IsChildOfLeaf () const

bool	IsLeaf () const

bool	IsInvisibleOrIgnored () const

bool	IsScrollable () const

bool	IsHorizontallyScrollable () const

bool	IsVerticallyScrollable () const

bool	IsTextField () const

bool	IsPlainTextField () const

bool	IsRichTextField () const

bool	IsText () const

bool	HasFocus ()

std::u16string	GetHypertext () const

std::u16string	GetInnerText () const

virtual std::u16string	GetValue () const

bool	ScrollToNode (ScrollType scroll_type)

AXPlatformNodeBase *	NearestLeafToPoint (gfx::Point point) const

int	NearestTextIndexToPoint (gfx::Point point)

ui::TextAttributeList	ComputeTextAttributes () const

int	GetSelectionCount () const

AXPlatformNodeBase *	GetSelectedItem (int selected_index) const

int	GetSelectedItems (int max_items, std::vector< AXPlatformNodeBase * > *out_selected_items=nullptr) const

Public Member Functions inherited from ui::AXPlatformNode
void	SetIsPrimaryWebContentsForWindow (bool is_primary)

bool	IsPrimaryWebContentsForWindow () const

int32_t	GetUniqueId () const

std::string	ToString ()

std::string	SubtreeToString ()

virtual	~AXPlatformNode ()

Protected Member Functions
void	AddAttributeToList (const char name, const char value, PlatformAttributeList *attributes) override

Protected Member Functions inherited from ui::AXPlatformNodeBase
bool	IsDocument () const

bool	IsSelectionItemSupported () const

std::u16string	GetRangeValueText () const

std::u16string	GetRoleDescription () const

std::u16string	GetRoleDescriptionFromImageAnnotationStatusOrFromAttribute () const

virtual void	Dispose ()

bool	SetHypertextSelection (int start_offset, int end_offset)

void	ComputeAttributes (PlatformAttributeList *attributes)

void	AddAttributeToList (const ax::mojom::StringAttribute attribute, const char name, PlatformAttributeList attributes)

void	AddAttributeToList (const ax::mojom::BoolAttribute attribute, const char name, PlatformAttributeList attributes)

void	AddAttributeToList (const ax::mojom::IntAttribute attribute, const char name, PlatformAttributeList attributes)

virtual void	AddAttributeToList (const char name, const std::string &value, PlatformAttributeList attributes)

virtual void	SanitizeTextAttributeValue (const std::string &input, std::string *output) const

void	UpdateComputedHypertext () const

int	GetSelectionAnchor (const AXTree::Selection *selection)

int	GetSelectionFocus (const AXTree::Selection *selection)

void	GetSelectionOffsets (int selection_start, int selection_end)

void	GetSelectionOffsets (const AXTree::Selection selection, int selection_start, int *selection_end)

void	GetSelectionOffsetsFromTree (const AXTree::Selection selection, int selection_start, int *selection_end)

AXPlatformNodeBase *	GetHyperlinkFromHypertextOffset (int offset)

int32_t	GetHyperlinkIndexFromChild (AXPlatformNodeBase *child)

int32_t	GetHypertextOffsetFromHyperlinkIndex (int32_t hyperlink_index)

int32_t	GetHypertextOffsetFromChild (AXPlatformNodeBase *child)

int32_t	GetHypertextOffsetFromDescendant (AXPlatformNodeBase *descendant)

int	GetHypertextOffsetFromEndpoint (AXPlatformNodeBase *endpoint_object, int endpoint_offset)

bool	IsSameHypertextCharacter (const AXHypertext &old_hypertext, size_t old_char_index, size_t new_char_index)

std::optional< int >	GetPosInSet () const

std::optional< int >	GetSetSize () const

std::string	GetInvalidValue () const

int	GetMaxSelectableItems () const

Protected Member Functions inherited from ui::AXPlatformNode
	AXPlatformNode ()

Additional Inherited Members
Public Types inherited from ui::AXPlatformNodeBase
enum	ScrollType { TopLeft , BottomRight , TopEdge , BottomEdge , LeftEdge , RightEdge , Anywhere }

using	AXPlatformNodeChildIterator = ui::AXNode::ChildIteratorBase< AXPlatformNodeBase, &AXPlatformNodeBase::GetNextSibling, &AXPlatformNodeBase::GetPreviousSibling, &AXPlatformNodeBase::GetFirstChild, &AXPlatformNodeBase::GetLastChild >

Public Types inherited from ui::AXPlatformNode
typedef AXPlatformNode *	NativeWindowHandlerCallback(gfx::NativeWindow)

Static Public Member Functions inherited from ui::AXPlatformNodeBase
static AXPlatformNode *	GetFromUniqueId (int32_t unique_id)

static size_t	GetInstanceCountForTesting ()

static void	SetOnNotifyEventCallbackForTesting (ax::mojom::Event event_type, std::function< void()> callback)

Static Public Member Functions inherited from ui::AXPlatformNode
static AXPlatformNode *	Create (AXPlatformNodeDelegate *delegate)

static AXPlatformNode *	FromNativeViewAccessible (gfx::NativeViewAccessible accessible)

static AXPlatformNode *	FromNativeWindow (gfx::NativeWindow native_window)

static void	RegisterNativeWindowHandler (std::function< NativeWindowHandlerCallback > handler)

static void	AddAXModeObserver (AXModeObserver *observer)

static void	RemoveAXModeObserver (AXModeObserver *observer)

static AXMode	GetAccessibilityMode ()

static void	NotifyAddAXModeFlags (AXMode mode_flags)

static gfx::NativeViewAccessible	GetPopupFocusOverride ()

static void	SetPopupFocusOverride (gfx::NativeViewAccessible focus_override)

Public Attributes inherited from ui::AXPlatformNodeBase
AXPlatformNodeDelegate *	delegate_ = nullptr

Static Public Attributes inherited from ui::AXPlatformNodeBase
static const char16_t	kEmbeddedCharacter = L'\xfffc'

Protected Types inherited from ui::AXPlatformNodeBase
using	PlatformAttributeList = std::vector< std::u16string >

Static Protected Member Functions inherited from ui::AXPlatformNodeBase
static AXPlatformNodeBase *	FromNativeViewAccessible (gfx::NativeViewAccessible accessible)

static void	SanitizeStringAttribute (const std::string &input, std::string *output)

Protected Attributes inherited from ui::AXPlatformNodeBase
AXHypertext	hypertext_

Detailed Description

Definition at line 20 of file ax_platform_node_mac.h.

Constructor & Destructor Documentation

◆ AXPlatformNodeMac()

ui::AXPlatformNodeMac::AXPlatformNodeMac ( )

Definition at line 1062 of file ax_platform_node_mac.mm.

1062{}

Member Function Documentation

◆ AddAttributeToList()

void ui::AXPlatformNodeMac::AddAttributeToList	(	const char *	name,
		const char *	value,
		PlatformAttributeList *	attributes
	)

overrideprotectedvirtual

Reimplemented from ui::AXPlatformNodeBase.

Definition at line 1144 of file ax_platform_node_mac.mm.

                                                                              {
  BASE_UNREACHABLE();
}

References BASE_UNREACHABLE.

◆ AnnounceText()

void ui::AXPlatformNodeMac::AnnounceText ( const std::u16string & text )

override

Definition at line 1126 of file ax_platform_node_mac.mm.

                                                             {
  PostAnnouncementNotification(@(base::UTF16ToUTF8(text).data()), [native_node_ AXWindowInternal],
                               false);
}

References data, text, and base::UTF16ToUTF8().

◆ Destroy()

void ui::AXPlatformNodeMac::Destroy ( )

overridevirtual

Reimplemented from ui::AXPlatformNodeBase.

Definition at line 1066 of file ax_platform_node_mac.mm.

                                {
  if (native_node_)
    [native_node_ detach];
  AXPlatformNodeBase::Destroy();
}

References ui::AXPlatformNodeBase::Destroy(), and AXPlatformNodeCocoa::detach.

◆ GetNativeViewAccessible()

gfx::NativeViewAccessible ui::AXPlatformNodeMac::GetNativeViewAccessible ( )

overridevirtual

Reimplemented from ui::AXPlatformNodeBase.

Definition at line 1083 of file ax_platform_node_mac.mm.

                                                                   {
  if (!native_node_)
    native_node_ = [[AXPlatformNodeCocoa alloc] initWithNode:this];
  return native_node_;
}

Referenced by NotifyAccessibilityEvent().

◆ IsPlatformCheckable()

bool ui::AXPlatformNodeMac::IsPlatformCheckable ( ) const

overridevirtual

Reimplemented from ui::AXPlatformNodeBase.

Definition at line 1073 of file ax_platform_node_mac.mm.

                                                  {
  if (GetData().role == ax::mojom::Role::kTab) {
    // On Mac, tabs are exposed as radio buttons, and are treated as checkable.
    // Also, the internal State::kSelected is be mapped to checked via AXValue.
    return true;
  }
 
  return AXPlatformNodeBase::IsPlatformCheckable();
}

References ui::AXPlatformNodeBase::GetData(), ui::AXPlatformNodeBase::IsPlatformCheckable(), and ax::mojom::kTab.

◆ NotifyAccessibilityEvent()

void ui::AXPlatformNodeMac::NotifyAccessibilityEvent ( ax::mojom::Event event_type )

overridevirtual

Reimplemented from ui::AXPlatformNodeBase.

Definition at line 1089 of file ax_platform_node_mac.mm.

                                                                        {
  AXPlatformNodeBase::NotifyAccessibilityEvent(event_type);
  GetNativeViewAccessible();
  // Handle special cases.
 
  // Alerts and live regions go through the announcement API instead of the
  // regular NSAccessibility notification system.
  if (event_type == ax::mojom::Event::kAlert ||
      event_type == ax::mojom::Event::kLiveRegionChanged) {
    if (auto announcement = [native_node_ announcementForEvent:event_type]) {
      [native_node_ scheduleLiveRegionAnnouncement:std::move(announcement)];
    }
    return;
  }
  if (event_type == ax::mojom::Event::kSelection) {
    ax::mojom::Role role = GetData().role;
    if (ui::IsMenuItem(role)) {
      // On Mac, map menu item selection to a focus event.
      NotifyMacEvent(native_node_, ax::mojom::Event::kFocus);
      return;
    } else if (ui::IsListItem(role)) {
      if (AXPlatformNodeBase* container = GetSelectionContainer()) {
        const ui::AXNodeData& data = container->GetData();
        if (data.role == ax::mojom::Role::kListBox &&
            !data.HasState(ax::mojom::State::kMultiselectable) &&
            GetDelegate()->GetFocus() == GetNativeViewAccessible()) {
          NotifyMacEvent(native_node_, ax::mojom::Event::kFocus);
          return;
        }
      }
    }
  }
  // Otherwise, use mappings between ax::mojom::Event and NSAccessibility
  // notifications from the EventMap above.
  NotifyMacEvent(native_node_, event_type);
}

References data, event_type, ui::AXPlatformNodeBase::GetData(), ui::AXPlatformNodeBase::GetDelegate(), ui::AXPlatformNodeBase::GetFocus(), GetNativeViewAccessible(), ui::AXPlatformNodeBase::GetSelectionContainer(), ui::IsListItem(), ui::IsMenuItem(), ax::mojom::kAlert, ax::mojom::kFocus, ax::mojom::kListBox, ax::mojom::kLiveRegionChanged, ax::mojom::kMultiselectable, ax::mojom::kSelection, ui::AXPlatformNodeBase::NotifyAccessibilityEvent(), and ui::AXNodeData::role.

The documentation for this class was generated from the following files:

third_party/accessibility/ax/platform/ax_platform_node_mac.h
third_party/accessibility/ax/platform/ax_platform_node_mac.mm

Public Member Functions

Protected Member Functions

Additional Inherited Members

Detailed Description

Constructor & Destructor Documentation

◆ AXPlatformNodeMac()

Member Function Documentation

◆ AddAttributeToList()

◆ AnnounceText()

◆ Destroy()

◆ GetNativeViewAccessible()

◆ IsPlatformCheckable()

◆ NotifyAccessibilityEvent()