[jira] [Commented] (ISIS-1740) New Feature: Where am I

["ASF subversion and git services (JIRA)" <ji...@apache.org>]

    [ https://issues.apache.org/jira/browse/ISIS-1740?page=com.atlassian.jira.plugin.system.issuetabpanels:comment-tabpanel&focusedCommentId=16364241#comment-16364241 ] 

ASF subversion and git services commented on ISIS-1740:
-------------------------------------------------------

Commit cc2f5d0736d1db38b189397dbb35a1f14e964712 in isis's branch refs/heads/master from [~danhaywood]
[ https://gitbox.apache.org/repos/asf?p=isis.git;h=cc2f5d0 ]

ISIS-1740: fixes merge issues (NullSafe moved to applib and renamed)


> New Feature: Where am I
> -----------------------
>
>                 Key: ISIS-1740
>                 URL: https://issues.apache.org/jira/browse/ISIS-1740
>             Project: Isis
>          Issue Type: New Feature
>          Components: Core
>            Reporter: Andi Huber
>            Assignee: Andi Huber
>            Priority: Major
>             Fix For: 2.0.0-M1
>
>         Attachments: Clipboard01.png, Clipboard02.png, Clipboard03.png, Clipboard04.png
>
>
> Its common practice to display a navigation hint somewhere at top of an application's page or below the main menu, indicating where the user currently has navigated to. (Typically within a navigable tree-structure.) 
> Let's call this the *WhereAmI hint*. We could integrate such a feature into ISIS.
> +Examples+
> [^Clipboard01.png]
> [^Clipboard02.png]
> [^Clipboard03.png]
> Note: we could optionally include the DomainObject's icons
> +Proposal+
> For any DomainObject/View currently displayed ISIS would need to know its corresponding
> navigable tree-structure. Let's call this the DomainObject's *WhereAmI tree*.
> All the framework needs to known to build the relevant sub-tree, is to know the parent node of any DomainObject/View that 'takes part' in the tree.
> We could provide this 'who is your parent' meta information similar to the existing 'what is your title' mechanism:
> {code:java}
> // Who is your parent? if null there is none
> public AnyDomainObjectOrView parent()
> {
>     return foo;
> }
> {code}
> or
> {code:java}
> // Who is your parent? if null there is none
> @Parent
> public AnyDomainObjectOrView anyMethodName()
> {
>     return foo;
> }
> {code}
> The typical layout.xml could look like this:
> {code:xml}
> <bs3:grid >
>     <bs3:row>
>         <bs3:col span="12" unreferencedActions="true">
>             <cpt:whereAmI />
>             <cpt:domainObject />
>             ...
>         </bs3:col>
>     </bs3:row>
>      ...
> </bs3:grid >
> {code}
> +Implementation Notes+
> # The framework needs to ensure that the chain of parent references starting at the current DomainObject/View is finite. (No circular or self references.) If it detects a circle, be nice and just stop the 'tree-up' traversal there.
> # For standalone Collection Views we could display a WhereAmI hint that allows back navigation to the DomainObject/View that had produced the collection.



--
This message was sent by Atlassian JIRA
(v7.6.3#76005)