Development:Editing Nibs - Revision history

Sardisson: /* Naming Conventions */ Add the period-space rule, which is missing here

2009-10-16T20:10:50Z

Naming Conventions: Add the period-space rule, which is missing here

Sardisson: /* IB Considerations */ add 2.5.x

2008-01-17T20:17:45Z

IB Considerations: add 2.5.x

Sardisson: /* IB Considerations */

2008-01-03T05:02:44Z

IB Considerations

Sardisson: /* IB Considerations */ more NSMatrix fun

2007-12-27T05:28:33Z

IB Considerations: more NSMatrix fun

Sardisson: /* Positioning and Margins */ more about control spacing

2007-05-26T01:35:51Z

Positioning and Margins: more about control spacing

Sardisson: /* Naming Conventions */ my/me and you/your usage

2007-01-21T05:01:24Z

Naming Conventions: my/me and you/your usage

Sardisson: /* Special Notes on the Appearance prefPane */ 12px

2006-12-03T19:29:38Z

Special Notes on the Appearance prefPane: 12px

Sardisson: /* Special Notes on the Appearance prefPane */ l10n stub; need to talk to l10n and work out some guidelines

2006-09-12T03:20:46Z

Special Notes on the Appearance prefPane: l10n stub; need to talk to l10n and work out some guidelines

Sardisson: /* Naming Conventions */ add an example based on the ss, and note our 2 "special window" names

2006-09-12T03:16:38Z

Naming Conventions: add an example based on the ss, and note our 2 "special window" names

Sardisson: /* Positioning and Margins */

2006-09-12T02:59:18Z

Positioning and Margins

← Older revision		Revision as of 20:10, 16 October 2009
Line 29:		Line 29:

	* Omit the comma before the last item in a series.		* Omit the comma before the last item in a series.
		+
		+	* Use only one space following a period (between sentences).

	* Capitalize pref names that are sentences like sentences (aside from also capitalizing the first word in the "option" part of the sentence), and capitalize all words in pref names that are fragments.		* Capitalize pref names that are sentences like sentences (aside from also capitalizing the first word in the "option" part of the sentence), and capitalize all words in pref names that are fragments.

← Older revision		Revision as of 20:17, 17 January 2008
Line 45:		Line 45:

	==IB Considerations==		==IB Considerations==
		+	'''Until further notice, all nib work should be done only in Interface Builder 2.5.x''' (preferably under Mac OS X 10.4, as a number of features do not work properly in IB 2.5.6 under Mac OS X 10.5, but it can be run under in a pinch).

	* Be sure you do not break the focus and tab cycle (both normal and Full Keyboard Access) when adding or changing controls in nibs. Verify that all controls are included in the tab chain (forwards and backward) with Full Keyboard Access on.		* Be sure you do not break the focus and tab cycle (both normal and Full Keyboard Access) when adding or changing controls in nibs. Verify that all controls are included in the tab chain (forwards and backward) with Full Keyboard Access on.

← Older revision		Revision as of 05:02, 3 January 2008
Line 52:		Line 52:
	* In sheets, let initialFirstResponder be the closest to a "Cancel" button. That is, set initialFirstResponder to a button that "bails out" of the sheet, but has no destructive behavior.		* In sheets, let initialFirstResponder be the closest to a "Cancel" button. That is, set initialFirstResponder to a button that "bails out" of the sheet, but has no destructive behavior.

−	* Be sure that all ~~items~~ bounding boxes resemble the actual size of the item it encloses as closely as possible, especially vertically for text.	+	* Be sure that all items’ bounding boxes resemble the actual size of the item it encloses as closely as possible, especially vertically for text.

@@ Line 58: / Line 58: @@
 :For instance, hint text that is left-aligned with the left edge of the widget for which the text provides a hint on 10.4 will be indented 3px  to the right on 10.3, and, much more seriously, bounding boxes that are sized very tightly to the text on 10.4 will often be 2-3px '''too small''' on 10.3, leading to odd/broken wrapping or the disappearance of words altogether!
 ::In these two cases, we take the alignment of the hint text on 10.4 as canonical, since it does not "break" anything on 10.3, but for the bounding box sizes, we take the appearance on 10.3 to be canonical to prevent breakage.
 :Another known aberration is that NSMatrixes appear to begin one pixel lower on 10.3 than on 10.4.  Since this is "non-breaking" behavior, 10.4's measurement is canonically correct here.
 ::Also on 10.3, NSTextFields are measured differently; the layout rectangle line is 3px inside the text field instead of on the edge.  Items aligned properly on 10.4 using the edges will "appear" 3px too far apart using the measuring functions on 10.3.  Since this is merely a measuring variation (the items actually appear in the correct locations on 10.3 and 10.4), we take the 10.4 measurement as canonical.

@@ Line 3: / Line 3: @@
 ==Positioning and Margins==
-* Follow the general guidelines in the [http://developer.apple.com/documentation/UserExperience/Conceptual/OSXHIGuidelines/XHIGLayout/chapter_19_section_2.html Aqua Human Interface Guidelines] about positioning controls and center-equalization, with exceptions as noted below.
+* Follow the general guidelines in the [http://developer.apple.com/documentation/UserExperience/Conceptual/OSXHIGuidelines/XHIGLayout/chapter_19_section_2.html Aqua Human Interface Guidelines] about positioning controls (more [http://developer.apple.com/documentation/UserExperience/Conceptual/OSXHIGuidelines/XHIGControls/chapter_18_section_1.html here]) and center-equalization, with exceptions as noted below.
 * Standard distances between elements are standardized at 8 px (10 px on either side of a drop-down menu) for related items in a "section" and 17 px between sections (despite what the HIG say - see screenshot).

@@ Line 32: / Line 32: @@
 * Capitalize pref names that are sentences like sentences (aside from also capitalizing the first word in the "option" part of the sentence), and capitalize all words in pref names that are fragments.
 ** E.g., "Single Window Mode" is a fragment, but "Links from other applications" is part of a sentence that is completed by the text of the three radio button options
 * As per the HIG, buttons which have further actions receive an ellipsis ("…").  Many times this means that the ellipsis should follow buttons which open sheets, but not buttons which open windows.  Use the real elipsis character (opt-; on a US keyboard), not three periods.

← Older revision		Revision as of 19:29, 3 December 2006
Line 61:		Line 61:

	* Always save with the Colors tab active, or cmd-w will not work in the Fonts tab in real life.		* Always save with the Colors tab active, or cmd-w will not work in the Fonts tab in real life.
		+	* The top of the tab view (buttons) should be 12px from the bottom of the titlebar.

	==Localization Considerations==		==Localization Considerations==

← Older revision		Revision as of 03:20, 12 September 2006
Line 61:		Line 61:

	* Always save with the Colors tab active, or cmd-w will not work in the Fonts tab in real life.		* Always save with the Colors tab active, or cmd-w will not work in the Fonts tab in real life.
		+
		+	==Localization Considerations==

@@ Line 31: / Line 31: @@
 * Capitalize pref names that are sentences like sentences (aside from also capitalizing the first word in the "option" part of the sentence), and capitalize all words in pref names that are fragments.
 * As per the HIG, buttons which have further actions receive an ellipsis ("…").  Many times this means that the ellipsis should follow buttons which open sheets, but not buttons which open windows.  Use the real elipsis character (opt-; on a US keyboard), not three periods.
@@ Line 36: / Line 37: @@
 * Refer to button names elsewhere within the text with curly quotes.
-* website, web pages, Internet, URL, Location bar, pop-up, plug-in, auto-fill, text field.
+* website, web pages, Internet, URL, Location bar, pop-up, plug-in, auto-fill, text field, Bookmarks Manager, Downloads window
 *: See also the cb.o style guide (currently existing only in [[Website:Issues#Proto-Style_Guide|prototype form]]).

@@ Line 18: / Line 18: @@
 * For Camino icon logos on sheets, use the general guideline of 20 px around the outside margins, and 10 px between the logo and the sheet's text.  However, this case can vary widely with context, so adapt until it looks good.
-* Keep the following template in mind (from discussion over {{bug|308942}}).
+* Keep the following template in mind (from discussion over {{bug|308942}} and subsequent refinements).
 [[Image:NibAlignDownloads.png]]
 [[Image:NibAlignTabs.png]]