Documentation looks outdated

ionic-v1
#1

Hi,

I just installed ionic to start working on a new project.

My concern is that the documentation looks old. The code that I get when creating a new project looks different from what is in the documentation.

For example, the code for a header is something like -

<ion-header-bar class="bar-stable">
     <h1 class="title">Ionic Blank Starter</h1>
</ion-header-bar>

However, in the documentation the HTML for the header reads -

<div class="bar bar-header bar-positive">
  <h1 class="title">bar-positive</h1>
</div>

I am not sure which one to use and why is there this discrepancy? This gives me a feeling that ionic is not being maintained anymore. Should I be using this at all to begin with?

#2

There are CSS components and Javascript components.

CSS header: http://ionicframework.com/docs/components/#header
Javascript header: http://ionicframework.com/docs/api/directive/ionHeaderBar/

The ion-header-bar is a directive. When you use the directive it automatically applies the CSS classes for you. I use the javascript components unless I find a behavior in a directive that I don’t want. It’s up to you but if you want to take full advantage of Ionic’s components I would stick with the directives.

Ionic is being maintained, you can see the code here: https://github.com/driftyco/ionic
And nightly builds (which is the latest code available) here: http://code.ionicframework.com/#nightly

1 Like