Editing Aqua (user interface) (section)

=== Interface elements ===
{{More citations needed section|date=May 2021}}
==== Windows ====
Historically, Aqua had two window designs: the default Aqua windows and "brushed metal" windows. Aqua windows typically have a metal-like or gray titlebar with three buttons on the left side (for closing, minimizing and zooming or entering fullscreen mode). Visually, these buttons used to be placed on top, but later appeared 'sunken' into the window. Aqua windows have almost no frame or outside border, instead [[drop shadow]]s are used to separate and distinguish active from inactive windows. The aesthetic of the window backgrounds changed from pin-striped to white backgrounds. Brushed-metal windows had a thick frame with a metallic texture or dark-gray background and sunken buttons and inner frames. They had the additional property of being draggable at every point of the frame instead of just the titlebar and toolbar. Apple recommended brushed-metal windows for applications that mimic real-world devices (such as [[iTunes]]) or are used to interface with such devices (such as [[iSync]]),<ref>{{Cite web|url = http://www.idemployee.id.tue.nl/g.w.m.rauterberg//lecturenotes/APPLE-Guidelines-2005.pdf|title = Apple Human Interface Guidelines|date = December 6, 2005|access-date = December 7, 2015}}</ref> but was criticised by designers for not following its own guidelines or applying it inconsistently (it was also used in Safari or Finder).<ref>{{Cite web|url = http://daringfireball.net/2004/10/brushedmetal|title = Brushed Metal and the HIG|date = October 16, 2004|access-date = December 7, 2015|website = Daring Fireball|last = Gruber|first = John|author-link = John Gruber}}</ref> Brushed-metal windows have been largely phased out since Leopard and become visually indistinctive from Aqua windows.<ref name=":0" />

In addition to titlebars, windows can also have toolbars with separate buttons. Up to Leopard, toolbars were visually separated from the titlebar and had the same background as the window frame or were pin-striped.<ref name=":1" /> Leopard introduced a unified style that extended the metal-like background of the titlebar to the toolbar, making it appear as one whole.<ref name=":0" /> Optionally, a separator could be placed between the titlebar and the toolbar to mimic the previous style. OS X Yosemite brought a compacter version of the toolbar that fused the titlebar and toolbar together, made it shorter and removed the window title (for example, in Safari 8 and later).<ref name=":2"/>

Drawers are accessory [[sidebar (computing)|sidebar]] views that can slide out from any edge of a window except the top edge. They can be resized perpendicular to their window edge but follow the window's size in the other direction. Drawers were once frequently used to display controls and information that did not need to be always visible, but Apple now recommends against their use.<ref>{{cite web|url=https://developer.apple.com/library/mac/documentation/userexperience/conceptual/applehiguidelines/Windows/Windows.html|title=OS X Human Interface Guidelines|quote=Drawers are rarely used in modern Mac apps. As much as possible, redesign your UI to avoid using drawers; if you're creating a new app, avoid adding a drawer to the design.}}</ref>

Sheets are [[dialog boxes]] that are [[Modal window|modal]] to a specific window. When opened, they are thrust towards the user like a sheet of paper, hence the name. They are partially transparent and focus attention on the content of the sheet. The parent window's controls are disabled until the sheet is dismissed, but the user is able to continue work in other windows (including those in the same application) while the sheet is open.

==== Menus ====
[[File:Leopard Menu Bar Icons.jpg|thumb|The menu bar in Leopard]]
Menus are backed with a slightly translucent solid gray, and when menu items are highlighted they appear blue. In [[Application software|application]] menus, which run in a single bar across the top of the [[Computer monitor|screen]], keyboard shortcuts appear to the right-hand side of the menu whilst the actual menu item is on the left. In Yosemite, the menus are much more translucent and have a blur effect.

Drop down menus for use in windows themselves are also available in several varieties. The standard "pop up" menu is white with a blue end cap with opposing arrows, whilst 'pull down' menus only have one downward facing arrow in the end cap. 'Pull down' menus are available in four different Aqua varieties, most of which have fallen into disuse in later macOS releases.

==== Text boxes and fields ====
Text boxes are black on white text with a sunken effect border. In addition to regular square text boxes, rounded search text boxes are available . For more extensive text requirements, there is also a multi-line text field. A combined text box and pull down menu is available, which allows the user to type in a value in addition to choosing from a menu. There is also a combination textbox and picker control, which allows the user to type in a date and time or edit it with directional buttons. [[Mac OS X Tiger|Mac OS X 10.4]] introduced a new interface element that allows the user to drag non-editable 'tokens' to a text box, between which text can be typed. Whitespace before and after the tokens is [[trim (programming)|trim]]med.

==== Push buttons ====
Standard push buttons with rounded corners are available in two varieties: white and blue. A blue button is the default action, and in OS releases prior to Yosemite, would appear to pulse to prompt the user to carry out that action. The action of a blue button can usually also be invoked with the [[return key]]. White buttons are usually associated with all other actions.

Also available are rounded bevel buttons, designed to hold an icon; standard square buttons; glass square buttons and round buttons. In addition, circular, purple [[online help]] buttons are available which display help relative to the current task when clicked. [[Disclosure widget|Disclosure triangles]], although technically buttons, allow views of controls to be shown and hidden to preserve space.

==== Checkboxes and radio buttons ====
In macOS, empty check boxes are small, white rounded rectangles. When they are checked, they turn blue and a [[checkmark]] is present. They are essentially buttons which can be toggled on or off. Radio buttons are similar in appearance and behaviour except that they are circular and contain a dot instead of a check. Radio buttons are classed into groups of which only one can  be activated at a time.

In Yosemite, a short animation was added to show the checkbox or radio button filling in.

==== Tables and lists ====
Tables and lists can be broadly categorised in three ways: A standard multi-columnar table with space to enter values or place other interface elements such as buttons; An outline view that can contain disclosure triangles to show and hide sets of data; and a [[Miller columns]] view akin to the column view in the [[Finder (software)|Finder]]. All table views can use alternating blue and white row backgrounds.

==== Progress indicators ====
Two main types of loading/saving progress indicator are available: a progress bar or a monochromatic spinning wheel (not the [[spinning pinwheel]]). The progress bar itself is available in two varieties: indeterminate, which simply shows diagonal blue and white stripes in animation with no measure of progress; or determinate, which shows a blue pulsing bar against a white background proportional to the percentage of a task completed. The spinning wheel indicator, also found in the Mac OS X startup screen since version 10.2, is simply a series of 12 increasingly darker grey lines arranged circularly, like the side view of a [[spoke]]d wheel rotating clockwise. Many other interfaces have adopted this device, including the [[Firefox]] and [[Camino (web browser)|Camino]] web browsers and many [[Web 2.0]]-influenced web sites.

In Yosemite, the progress bar was changed to a thin, light gray. The "indeterminate" variation kept the pulses, but slower and spaced out. A progress indicator now appears during boot, replacing the spinning wheel indicator found in earlier versions.

==== Miscellaneous ====
Sliders are available in three types: one with tick marks and a triangular scrubber, one with a round scrubber and no tick marks and a circular slider which can be rotated. All are available horizontally or vertically. The circular slider is simply a gray dot on a white circle which can be rotated to set values.

macOS has a standard control for picking colors which appears as a regular square button with a color sample in the middle. When clicked, it shows the standard macOS [[palette window|color palette]].

Tabs in macOS are nearly identical to push buttons, with the unselected tab(s) being white and the selected tab being blue. Image "wells" are also available: a small, sunken container into which image files can be dropped. When the well contains an image, it can display a thumbnail representation of the file's contents.