Community
Participate
Working Groups
In 3.1 you can now specify "primary:secondary" format in IPageLayout.addView() but the javadoc in IPageLayout wasn't updated.
This also applies to addPlaceholder which accepts the same id syntax.
It would be good to clarify. Jim, these are enhancements to API that existed in 3.0. See bug 73722 for details.
improving API specs approved for RC2.
I've added the following to the IPageLayout type javadoc: * <p> * In some cases, multiple instances of a particular view may need to be added * to the same layout. These are disambiguated using a secondary id. * In layout methods taking a view id, the id can have the compound form: * <strong>primaryId [':' secondaryId]</strong>. * If a secondary id is given, the view must allow multiple instances by * having specified <code>allowMultiple="true"</code> in its extension. * View placeholders may also have a secondary id. * </p> * <p> * Wildcards are permitted in placeholder ids (but not regular view ids). * '*' matches any substring, '?' matches any single character. * Wildcards can be specified for the primary id, the secondary id, or both. * For example, the placeholder "someView:*" will match any occurrence of the view * that has primary id "someView" and that also has some non-null secondary id. * Note that this placeholder will not match the view if it has no secondary id, * since the compound id in this case is simply "someView". * </p> The addView and addPlaceholder methods in IPageLayout, IPlaceholderFolderLayout and IFolderLayout make reference to this. Did some other Javadoc cleanup here as well (some wordings were pretty stale).
Verified in I20050610-0010
