## page was renamed from TouchpadSettings

This is a specification covering settings, notifications, and other UI for mice and touchpads (sometimes called trackpads).

## == Prompting to set up a mouse or touchpad ==

## {{attachment:no-mouse-touchpad.png}}

## Whenever no pointing device is detected, the “Mouse & Touchpad” screen of System Settings should open with the text “No mouse or touchpad detected”. The following text should depend on the situation.
##  * On a pocket PC: “You need to use a Bluetooth mouse or touchpad with this display. Make sure it is close to the phone and its batteries are charged.”
##  * On a PC: “Connect a mouse or touchpad via USB, or use a Bluetooth device. If a Bluetooth device isn’t detected, make sure it is turned on and its batteries are charged.”

## As long as the screen is open, Bluetooth should be turned on to detect a Bluetooth keyboard. If it was off previously, it should turn off again if you exit the screen without connecting a device.

## Ubuntu should open the “Mouse & Touchpad” screen of System Settings, to display this prompt, if all of these are true:
##  * you are using a PC, or a pocket PC with a non-touch external display in use;
##  * no pointing device has been detected;
##  * a keyboard ''has'' been detected (so Ubuntu is not [[Keyboard#prompting|prompting you to connect a keyboard]] instead);
##  * System Settings is not already the active app;
##  * System Settings “Bluetooth” or “Mouse & Touchpad” screen is not already open.

<<Anchor(settings)>>
== “Mouse & Touchpad” settings ==

||<^ style="border:none">{{attachment:settings-mouse-touchpad-both.wide.png}}||<^ style="border:none">{{attachment:settings-mouse-touchpad-both.narrow.png}}||

For each device:

 * '''“Primary button”''' should be present only if the number of buttons is either unknown or at least two.

 * '''“Tap to click”''' should be present only for a touchpad that has a tappable pad.

 * '''“Scroll:”''' should be present for a mouse unless it is known that no mouse with a mousewheel is connected, and should be present for a touchpad unless it is known that no multi-touch touchpad is connected. For “Mouse”, it should contain items “Scrollwheel is off”, “Scrollwheel moves content” (the default), and “Scrollwheel moves view”. For Touchpad”, it should contain items “Off”, “Two fingers move content” (the default), “Two fingers move view”, “Right/bottom edge moves content”, and “Right/bottom edge moves view”.

''TBD: Behavior of remaining items''

'''“Set Up Bluetooth Mouse/Touchpad…”''' should navigate to the Bluetooth settings.

Whenever the view is laid out in multiple columns, there should be “Test…” buttons next to the “Scroll speed:” and “Double click speed:” rows. Whenever it is laid out in a single column, there should be a single “Test…” button in a panel fixed at the bottom of the view.

''TBD: scrolling and double-clicking test UI''

''TBD: variation for when a phone is being used as touchpad for an external display''

||<tablestyle="clear:both" style="border:none">||

== Advanced touchpad settings ==

'''These are unfinished draft designs. Do not implement.'''

{{attachment:touchpad-settings-p3.jpg}}

{{attachment:touchpad-settings-p4.jpg}}