Accessibility: Added VoiceOver (macOS) and Narrator (Windows) accessibility screen reader support to juce_gui_basics

modules/juce_gui_basics/filebrowser/juce_FileBrowserComponent.cpp

@@ -616,4 +616,10 @@ void FileBrowserComponent::timerCallback()
     }
 }
 
+//==============================================================================
+std::unique_ptr<AccessibilityHandler> FileBrowserComponent::createAccessibilityHandler()
+{
+    return std::make_unique<AccessibilityHandler> (*this, AccessibilityRole::group);
+}
+
 } // namespace juce

modules/juce_gui_basics/filebrowser/juce_FileBrowserComponent.h

@@ -252,6 +252,8 @@ public:
     FilePreviewComponent* getPreviewComponent() const noexcept;
     /** @internal */
     DirectoryContentsDisplayComponent* getDisplayComponent() const noexcept;
+    /** @internal */
+    std::unique_ptr<AccessibilityHandler> createAccessibilityHandler() override;
 
 protected:
     /** Returns a list of names and paths for the default places the user might want to look.

modules/juce_gui_basics/filebrowser/juce_FileListComponent.cpp

@@ -35,6 +35,7 @@ FileListComponent::FileListComponent (DirectoryContentsList& listToShow)
       DirectoryContentsDisplayComponent (listToShow),
       lastDirectory (listToShow.getDirectory())
 {
+    setTitle ("Files");
     setModel (this);
     directoryContentsList.addChangeListener (this);
 }
@@ -68,7 +69,7 @@ void FileListComponent::setSelectedFile (const File& f)
 {
     for (int i = directoryContentsList.getNumFiles(); --i >= 0;)
     {
-        if (directoryContentsList.getFile(i) == f)
+        if (directoryContentsList.getFile (i) == f)
         {
             fileWaitingToBeSelected = File();
 
@@ -189,6 +190,11 @@ public:
         repaint();
     }
 
+    std::unique_ptr<AccessibilityHandler> createAccessibilityHandler() override
+    {
+        return nullptr;
+    }
+
 private:
     //==============================================================================
     FileListComponent& owner;
@@ -231,6 +237,11 @@ int FileListComponent::getNumRows()
     return directoryContentsList.getNumFiles();
 }
 
+String FileListComponent::getNameForRow (int rowNumber)
+{
+    return directoryContentsList.getFile (rowNumber).getFileName();
+}
+
 void FileListComponent::paintListBoxItem (int, Graphics&, int, int, bool)
 {
 }

modules/juce_gui_basics/filebrowser/juce_FileListComponent.h

@@ -82,6 +82,7 @@ private:
 
     void changeListenerCallback (ChangeBroadcaster*) override;
     int getNumRows() override;
+    String getNameForRow (int rowNumber) override;
     void paintListBoxItem (int, Graphics&, int, int, bool) override;
     Component* refreshComponentForRow (int rowNumber, bool isRowSelected, Component*) override;
     void selectedRowsChanged (int row) override;

modules/juce_gui_basics/filebrowser/juce_FileTreeComponent.cpp

@@ -190,6 +190,11 @@ public:
                                                    indexInContentsList, owner);
     }
 
+    String getAccessibilityName() override
+    {
+        return file.getFileName();
+    }
+
     void itemClicked (const MouseEvent& e) override
     {
         owner.sendMouseClickMessage (file, e);

modules/juce_gui_basics/filebrowser/juce_FilenameComponent.cpp

@@ -70,11 +70,11 @@ void FilenameComponent::resized()
     getLookAndFeel().layoutFilenameComponent (*this, &filenameBox, browseButton.get());
 }
 
-KeyboardFocusTraverser* FilenameComponent::createFocusTraverser()
+std::unique_ptr<ComponentTraverser> FilenameComponent::createKeyboardFocusTraverser()
 {
     // This prevents the sub-components from grabbing focus if the
     // FilenameComponent has been set to refuse focus.
-    return getWantsKeyboardFocus() ? Component::createFocusTraverser() : nullptr;
+    return getWantsKeyboardFocus() ? Component::createKeyboardFocusTraverser() : nullptr;
 }
 
 void FilenameComponent::setBrowseButtonText (const String& newBrowseButtonText)

modules/juce_gui_basics/filebrowser/juce_FilenameComponent.h

@@ -212,7 +212,7 @@ public:
     /** @internal */
     void fileDragExit (const StringArray&) override;
     /** @internal */
-    KeyboardFocusTraverser* createFocusTraverser() override;
+    std::unique_ptr<ComponentTraverser> createKeyboardFocusTraverser() override;
 
 private:
     //==============================================================================

modules/juce_gui_basics/filebrowser/juce_ImagePreviewComponent.cpp

@@ -117,4 +117,10 @@ void ImagePreviewComponent::paint (Graphics& g)
     }
 }
 
+//==============================================================================
+std::unique_ptr<AccessibilityHandler> ImagePreviewComponent::createAccessibilityHandler()
+{
+    return std::make_unique<AccessibilityHandler> (*this, AccessibilityRole::image);
+}
+
 } // namespace juce

modules/juce_gui_basics/filebrowser/juce_ImagePreviewComponent.h

@@ -53,6 +53,8 @@ public:
     void paint (Graphics&) override;
     /** @internal */
     void timerCallback() override;
+    /** @internal */
+    std::unique_ptr<AccessibilityHandler> createAccessibilityHandler() override;
 
 private:
     File fileToLoad;