Skip to content
Branch: master
Find file History
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
..
Failed to load latest commit information.
app chore(android): set markingMode:none by default (#58) Jun 10, 2019
hooks/after-createProject chore: npm package fixes (#9) Feb 7, 2019
tools chore: migrate template to version 2 (#63) Jan 9, 2019
.editorconfig chore: add .editorconfig and tsfmt.json files (#16) Mar 5, 2019
.eslintignore chore: migrate template to version 2 (#63) Jan 9, 2019
.eslintrc refactor: eslint fixes Jan 11, 2019
.gitignore chore: npm package fixes (#9) Feb 7, 2019
.npmignore chore: npm package fixes (#9) Feb 7, 2019
README.md
jsconfig.json chore: add .editorconfig and tsfmt.json files (#16) Mar 5, 2019
package.json chore: merge release to master (#76) Aug 19, 2019

README.md

NativeScript Core Tab Navigation Template

App templates help you jump start your native cross-platform apps with built-in UI elements and best practices. Save time writing boilerplate code over and over again when you create new apps.

App template featuring a TabView component for navigation.

Key Features

  • Tab navigation
  • Five blank pages hooked to the tab navigation
  • Customizable theme
  • UX and development best practices
  • Easy to understand code

Quick Start

Execute the following command to create an app from this template:

tns create my-tab-js --template tns-template-tab-navigation

Note: This command will create a new NativeScript app that uses the latest version of this template published to [npm] (https://www.npmjs.com/package/tns-template-tab-navigation).

If you want to create a new app that uses the source of the template from the master branch, you can execute the following:

# clone nativescript-app-templates monorepo locally
git clone git@github.com:NativeScript/nativescript-app-templates.git

# create app template from local source (all templates are in the 'packages' subfolder of the monorepo)
tns create my-tab-js --template nativescript-app-templates/packages/template-tab-navigation

NB: Please, have in mind that the master branch may refer to dependencies that are not on NPM yet!

Walkthrough

Architecture

The application root component is located at:

  • app-root.xml - sets up the tab navigation page layout and references the navigatable pages contents.

The template has the following pages used for the tab views:

  • /home/home-items-page.js - the master home page. Displays a list of items and navigates to the item details page on item tap.
  • /home/home-item-detail/home-item-detail-page.js - the item details page. Displays the details of the tapped item.
  • /browse/browse-page.js - blank page
  • /search/search-page.js - blank page

Styling

This template is set up to use SASS for styling. All classes used are based on the {N} core theme – consult the documentation to understand how to customize it. Check it out to see what classes you can use on which component.

It has 4 global style files that are located at the root of the app folder:

  • _app-variables.scss - holds the global SASS variables that are imported on each component's styles.
  • app.scss - the global common style sheet. These style rules are applied to both Android and iOS.
  • platform.android.scss - the global Android style sheet. These style rules are applied to Android only.
  • platform.ios.scss - the global iOS style sheet. These style rules are applied to iOS only.

Each component has 3 style files located in the its folder:

  • _page-name.scss - the component common style sheet. These style rules are applied to both Android and iOS.
  • page-name.android.scss - the component Android style sheet. These style rules are applied to Android only.
  • page-name.ios.scss - the component iOS style sheet. These style rules are applied to iOS only.

Get Help

The NativeScript framework has a vibrant community that can help when you run into problems.

Try joining the NativeScript community Slack. The Slack channel is a great place to get help troubleshooting problems, as well as connect with other NativeScript developers.

If you have found an issue with this template, please report the problem in the NativeScript repository.

Contributing

We love PRs, and accept them gladly. Feel free to propose changes and new ideas. We will review and discuss, so that they can be accepted and better integrated.

You can’t perform that action at this time.