AccessibilityUIExamples: Version 3.0, 2017-09-12

Rewritten in Swift 4.

This sample contains examples of several common control elements with various implementations and code to make them accessible, including using the accessibility methods of NSControl subclasses and implementing accessibility protocols for custom elements.

Signed-off-by: Liu Lantao <[email protected]>

Author: Lax

AccessibilityUIExamples/.gitignore

@@ -0,0 +1,10 @@
+# See LICENSE folder for this sample’s licensing information.
+#
+# Apple sample code gitignore configuration.
+
+# Finder
+.DS_Store
+
+# Xcode - User files
+xcuserdata/
+*.xcworkspace

AccessibilityUIExamples/AccessibilityUIExamples.xcodeproj/.xcodesamplecode.plist

@@ -0,0 +1,5 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<array/>
+</plist>

AccessibilityUIExamples/AccessibilityUIExamples.xcodeproj/project.pbxproj

@@ -0,0 +1,13 @@
+/*
+See LICENSE folder for this sample’s licensing information.
+
+Abstract:
+This sample's application delegate.
+*/
+
+import Cocoa
+
+@NSApplicationMain
+class AppDelegate: NSObject, NSApplicationDelegate {
+
+}

AccessibilityUIExamples/AccessibilityUIExamples/Application/AppDelegate.swift

@@ -0,0 +1,17 @@
+/*
+See LICENSE folder for this sample’s licensing information.
+
+Abstract:
+Helpful extension to Character.
+*/
+
+import Cocoa
+
+extension Character {
+    init?(_ ascii: Int) {
+        guard let scalar = UnicodeScalar(ascii) else {
+            return nil
+        }
+        self = Character(scalar)
+    }
+}

AccessibilityUIExamples/AccessibilityUIExamples/Application/Character.swift

@@ -0,0 +1,12 @@
+/*
+See LICENSE folder for this sample’s licensing information.
+
+Abstract:
+Encompassing view that holds the detail view controller's content.
+*/
+
+import Cocoa
+
+class DetailView: NSView {
+    
+}

AccessibilityUIExamples/AccessibilityUIExamples/Application/DetailView.swift

@@ -0,0 +1,84 @@
+/*
+See LICENSE folder for this sample’s licensing information.
+
+Abstract:
+This sample's detail view controller showing the accessibility examples.
+*/
+
+import Cocoa
+import MediaLibrary
+
+class DetailViewController: NSViewController {
+
+    @IBOutlet var descriptionField: NSTextField!
+    @IBOutlet var exampleArea: NSView!
+    
+    var detailItemRecord: Example! {
+        didSet {
+            // Remove the old child view controller, if any exists.
+            if !childViewControllers.isEmpty {
+                let vc = childViewControllers[0]
+                vc.view.isHidden = true
+                vc.removeFromParentViewController()
+            }
+            
+            descriptionField.stringValue = ""
+            
+            guard detailItemRecord != nil else { return }
+            
+            // Update the description of the example.
+            descriptionField.stringValue = detailItemRecord.desc
+            
+            // Check if this sample actually has a valid view controller to display.
+            guard !detailItemRecord.viewControllerIdentifier.characters.isEmpty else { return }
+            
+            // Load the example storyboard and embed.
+            let storyboard: NSStoryboard =
+                NSStoryboard(name: NSStoryboard.Name(rawValue: detailItemRecord.viewControllerIdentifier), bundle: nil)
+
+            let sceneIdentifier = NSStoryboard.SceneIdentifier(rawValue: detailItemRecord.viewControllerIdentifier)
+
+            guard let buttonViewController =
+                storyboard.instantiateController(withIdentifier: sceneIdentifier) as? NSViewController else { return }
+
+            insertChildViewController(buttonViewController, at: 0)
+
+            buttonViewController.view.translatesAutoresizingMaskIntoConstraints = false
+
+            view.addSubview(buttonViewController.view)
+            
+            // Add the proper constraints to the detail view controller so it embeds properly with it's parent view controller.
+            let top = NSLayoutConstraint(item: buttonViewController.view,
+                                         attribute: .top,
+                                         relatedBy: .equal,
+                                         toItem: exampleArea,
+                                         attribute: .top,
+                                         multiplier: 1,
+                                         constant: 0)
+            let left = NSLayoutConstraint(item: buttonViewController.view,
+                                          attribute: .left,
+                                          relatedBy: .equal,
+                                          toItem: exampleArea,
+                                          attribute: .left,
+                                          multiplier: 1,
+                                          constant: 0)
+            let height = NSLayoutConstraint(item: buttonViewController.view,
+                                            attribute: .height,
+                                            relatedBy: .equal,
+                                            toItem: exampleArea,
+                                            attribute: .height,
+                                            multiplier: 1,
+                                            constant: 0)
+            let width = NSLayoutConstraint(item: buttonViewController.view,
+                                           attribute: .width,
+                                           relatedBy: .equal,
+                                           toItem: exampleArea,
+                                           attribute: .width,
+                                           multiplier: 1,
+                                           constant: 0)
+            view.addConstraints([top, left, height, width])
+        }
+    }
+
+}
+

AccessibilityUIExamples/AccessibilityUIExamples/Application/DetailViewController.swift

@@ -0,0 +1,22 @@
+/*
+See LICENSE folder for this sample’s licensing information.
+
+Abstract:
+Object to describe an accessibility example.
+*/
+
+import Foundation
+
+class Example: NSObject {
+    var name = ""
+    var desc = ""
+    var viewControllerIdentifier = ""
+    
+    init(name: String, description: String, viewControllerIdentifier: String) {
+        self.name = name
+        self.desc = description
+        self.viewControllerIdentifier = viewControllerIdentifier
+        super.init()
+    }
+    
+}

AccessibilityUIExamples/AccessibilityUIExamples/Application/Example.swift

@@ -0,0 +1,12 @@
+/*
+See LICENSE folder for this sample’s licensing information.
+
+Abstract:
+Encompassing view that holds the master view controller's content.
+*/
+
+import Cocoa
+
+class MasterView: NSView {
+    
+}