Skip to content

38 — A setting the app sets, that a place can change

2026-11-15 · decision · issue #209 · Android and Mac

Some settings have one value for the app, the notification and the widgets (Mac: the menu bar panel and the widgets), and a place may differ. The owner: show only what differs, make changing the shared value the main action and a place’s value secondary, let follow the shared value be a value a place can choose (a switch: follow / on / off), one shared component per platform.

Round Design Owner’s verdict
1 (8a539afc) A Default row + an Exceptions row naming the places that differ; Android an Exceptions page, Mac an Edit… sheet “very disappointed”
2 Five alternatives: baseline, one row + its page (B), place chips, place tabs, set it at the place “all still bad”; B the least bad. No selects inside an Android row, no ⓘ hiding the places on the Mac, “Exceptions” is a terrible word
3 B iterated (below) approved: “I approve the component design”

Round 3’s details the owner shaped: the Mac nests the places (Apple’s ways of nesting, below); a following place’s pop-up is quiet; the row’s summary never breaks inside an item, one line when one place differs, one line per value when more do, and no line is a bare number.

Decision Chosen Why, over the other way
What places follow The app’s own value (Mac: the menu bar panel’s). Only the notification and widgets can differ (Mac: the widgets) A separate default plus an App place was four values for three places, and every word for it (Default, Global) needs explaining; the app’s value is one the person can point at. Every combination stays possible
Words A place says its own value or Same as the app; its dialog’s first choice Same as the app (12 h); a widget’s own settings Same as in Settings Exceptions and Default are jargon (NN/g; Chrome’s site settings call the section Customised behaviours). The short form keeps a following place quiet; the dialog says the value when choosing
Android: the setting One row; its summary names only what differs; it opens the setting’s page: the app’s values as a radio list (as Screen timeout), then one row per place, each opening the stock list dialog Google’s settings guide: radio buttons go “in a dialog or child screen”; SettingsLib’s drop-down is used only in the APN editor, never in a row. Cost: the app’s value is 2 taps (as Screen timeout)
Android: a switch The two-part row (switch = the app’s value, text opens the page); the page’s main switch, then the places (Same as the app / On / Off) The row the app already uses for switches with more behind them (a1ccea39)
Mac: nesting A page per setting inside the pane, with a back button: the menu bar’s value, then the widgets’ pop-up Apple nests by indenting, by a nested view behind a chevron, or by a disclosure triangle (HIG Layout, Toggles, Lists and tables, Disclosure controls); System Settings uses the nested view for this exact case (Accessibility › Display › Text size: the shared size, then a pop-up per app, “Use Preferred Reading Size” or its own). The ⓘ “doesn’t support navigation”; a sheet is modal; a triangle hides whether the widgets differ. Indenting in the pane (shown as Mac 2) shows a widgets row under every setting even when nothing differs
Mac: a following place Its pop-up shows just the value, grey and borderless; its own value gets the normal pop-up What you set stands out; what you didn’t stays in the background. The menu’s first item says Same as the menu bar (12 h)
The summary Nothing differs: 12 h. One place: 12 h · 3 h in the notification. More, or the one line doesn’t fit: one line per value, each saying where (12 h in the app / 3 h in the notification / 6 h on widgets); same values share a line A line never breaks inside an item, and a bare 12 h on its own line reads oddly. Android measures the one line with the row’s real width and text style, so it holds at every font size and language
One widget’s own settings Kept, the same rows (Same as in Settings) The lock-screen widget has no settings screen, and setting all widgets at once stays possible
  • Added: schema graph.hours.place / graph.sensorTime.place for the notification and widgets (Mac: widgets) only, 0 / same = Same as the app. Android :core:designsystem PlaceSummary.kt: placeSummary (pure, unit tested), PlacesRow (measures whether the one line fits), PlacesSwitchRow, PlaceDialog / OnOffPlaceDialog, and a wrapped line keeps its last two words together; the pages TimeShownContent / SensorTimeContent (SettingsRoute.PlacePage). Mac PlaceSettings.swift: PlaceSummary, PlaceSettingRow, SettingPage (the page over the pane, back button, ⌘[, Esc), PlacePopUp / SwitchPlacePopUp (quiet while following). The Mac has one place, so its line is one sentence (%@ on widgets).
  • Discarded: the Default + Exceptions rows, the Exceptions page, the Mac’s Edit… sheet, ExceptionsRow, OverrideDialog, PlaceExceptions.swift, the App and menu bar places and their keys (placeHoursApp, placeSensorTimeApp, menubarHours, placeSensorTimeMenubar; no migration). Round 2’s chips (not a SettingsLib component), tabs (the differences hidden behind a dot) and set-it-at-the-place (no single place lists the differences).

docs/img/settings/overrides/: *-before-* the round 1 design, *-after-* this one, light and dark, English and Spanish. Mockups of every state: issue #209.