kanmaniraja / Template.Hierarchical-Navigation

Alloy App Template for apps that require hierarchical navigation, also known as parent-child or master-detail.

Template.Hierarchical-Navigation

The Barebones template provides the necessary scaffolding to implement native hierarchical, also known as Parent-Child or Master-Detail, using platform-specific containers with content reusability, ensuring the best native user experience with high code reusability when required. Here's what it offers:

• Index.xml is an empty view
• Index.js picks up the request and loads the "home" controller
• The "home" controller is platform specific, so you have two versions: /views/ios/home.xml and /views/android/home.xml. Alloy picks up the right one for the platform.
• Home.xml "Requires" the "sharedhome" controller
• Home.js is a single cross-platform controller used by either one of the home.xml files. From here we can "talk" to the "sharedhome" files, effectively providing platform-specific containers with shared content

Important to keep in mind

This template project is using platform-specific folders to organize your main app containers and keep them in separate places. This practice is perfectly fine for the main container. For all other windows I recommend you keep your code in a single View file and use the platform attribute, for example:

<Alloy>
  <Window backgroundColor="#fff">

    <!-- this tag is Android-only -->
    <ActionBar platform="android" title="Window Title"/>

    <!-- this tag is iOS-only -->
    <Toolbar platform="ios" title="Window Title" top="20">
      <Items>
        <FlexSpace/>
        <Label id="wintitle">Window Title</Label>
        <FlexSpace/>
      </Items>
    </Toolbar>

  </Window>
</Alloy>

The same thing goes for your controllers, where you can use platform variables like:

if (OS_IOS){
  // do some iOS stuff
}else if (OS_ANDROID){
  // do some Android stuff
}

---

NOTES:

home.js includes ActionBarExtras to help you easily customize the ActionBar without the need for custom ActionBar Styles.

It also includes three base themes you could use in your tiapp.xml: Light, Dark and LightDarkBar. To use any of these, simply declare them in the Android section like so:

<android xmlns:android="http://schemas.android.com/apk/res/android">
    <manifest>
          <application android:theme="@style/Light"/>
    </manifest>
</android>

License

This code is licensed under the Apache Public License (Version 2).