ionic-team/ionic-framework

A powerful cross-platform UI toolkit for building native-quality iOS, Android, and Progressive Web Apps with HTML, CSS, and JavaScript.

Ionic

Ionic is an open source app development toolkit for building modern, fast, top-quality cross-platform native and Progressive Web Apps from a single codebase with JavaScript and the Web.

Ionic is based on Web Components, which enables significant performance, usability, and feature improvements alongside support for popular web frameworks like Angular, React, and Vue.

Quickstart · Documentation · Contribute · Blog
Community: Discord · Forums · Twitter

Packages

Project	Package	Version	Downloads	Links
Core	@ionic/core			README.md
Angular	@ionic/angular			README.md
Vue	@ionic/vue			README.md
React	@ionic/react			README.md

Looking for the ionic-angular package? Ionic 3 has been moved to the ionic-v3 repo. See Earlier Versions.

Getting Started

Start a new project by following our documentation. We would love to hear from you! If you have any feedback or run into issues using our framework, please file an issue on this repository.

Migration Guides

Already have an Ionic app? These guides will help you migrate to the latest versions.

• Migrate from v7 to v8
• Migrate from v6 to v7
• Migrate from v5 to v6
• Migrate from v4 to v5
• Migrate from v3 to v4

Examples

The Ionic Conference App is a full featured Ionic app. It is the perfect starting point for learning and building your own app.

• Angular Ionic Conference App
• React Ionic Conference App
• Vue Ionic Conference App

Contributing

Thanks for your interest in contributing! Read up on our guidelines for contributing and then look through our issues with a help wanted label.

Please note that this project is released with a Contributor Code of Conduct. By participating in this project you agree to abide by its terms.

Earlier Versions

The source code for earlier versions of the Ionic Framework may exist in other repositories. Please open issues and pull requests in their respective repositories.

• Ionic 2/3: Moved to ionic-team/ionic-v3
• Ionic 1: Moved to ionic-team/ionic-v1

ionic-framework's Issues

Trigger events on show/hide for tab bar

Remove webkit appearance from form elements

Do we need to do this for search inputs, etc.?

http://css-tricks.com/almanac/properties/a/appearance/

Single item slide box fail

Support mouse events in event controller?

Not sure why tap.js listens/works around them: https://github.com/alexgibson/tap.js/blob/master/tap.js

content without has-header doesn't have a `top`

Content needs to specify a default top or something, otherwise it doesn't work without a has-header qualifier.

Component List

A list of all the components we need to add:

• Button
• Button group
• Button bar
• Header
• Footer
• Secondary header/footer bars
  • Support embedded form controls
• Tab bar
• List views
  • With icon
  • With badge/count
  • With anything
• Forms
  • Input groups (Full width, content-padded, inset)
  • Text Inputs (email, date, tel, etc.)
  • Search Inputs
  • Selects
  • Toggle Switch (Checkbox)
  • Checkmark (like a user checking images they want to select)
  • Range (Slider)
  • Radio Button (Listview checkmark)
  • Validation styles
• Side Menu
• Nav Bar Menu
• Alert
• Badge
• Tag
• Alert
• Card
• Grid
• Modal / Popover

Content area not under header bar

I have a content wrapper with has-header = "true" but the content area is not "below" the header bar. It is, however, below the footer bar. The margin-top I think is the culprit.

TabController: remove node on tab switch

We should be detaching the content DOM node of any hidden tabs with the tab controller.

bug: Header bar new height should be...

Type: bug

Platform: ios 7 webview

.bar { height: 44px; padding: 8px; }

ngAnimate for service animations

Use it for actionsheets and popups

iOS input cursor bugs

It seems the Web View on iOS has a bug where a focused text box will the input caret through any layers on top of it.

Can't scroll with drag gesture

Drag gesture blocks scrolling

List icon should just be a carrot icon by default, not an arrow

Let list item buttons close editing

If you have a button in a list item (slide over mode), you should be able to auto close the slider if you hit a certain button.

content not sized correctly.

Right now we aren't setting sizing properties on our content areas, apart from using top, left, right, and bottom. I've encountered some sizing issues because of this. We shoudl fix.

Angular Testing Checklist

• Action Sheet
• Modal
• List
• Side Menu Controller
• Nav Controller
• Tab Controller
• TemplateLoader

Remove dependency on Gesture in event layer

Not ever sure we need the event layer, but it shouldn't rely on the gesture addon

Remove :hover css

Remove any use of :hover

List-item padding should be...

padding: 15px 15px;

line-height not correct

The line-height property is being computed incorreclty, and isn't even being applied anyways because it's missing units.

Need styles for HTML5 form validation errors

For example, if you have an input type="email", the validation system will apply styles that we need to have a say in.

Handling native events

How should we help handle memory warnings and app launch/awake events? Might be best to delegate to pg

Form grids need tweaking for tablet sizes

This doesn't quite work on tablet.

docs: Use active state classnames

Type: docs

Platform: desktop browser

Remove use of :active and instead use classnames

Use angular minification-friendly syntax

Switch controllers, directives, etc. to use the array dep injection format instead of the magic one that won't minify.

use strict and pass jshint

Need to run and fix jshint errors, and use strict

Verify List Item content/buttons markup

Right now I have this markup, is it necessary?

            <a href="#" class="list-item">
              <div class="list-item-edit">
                <button><i class="icon-minus-circled"></i></button>
              </div>
              <div class="list-item-content">
                Sasafras
                <i class="icon-arrow-right"></i>
              </div>
              <div class="list-item-buttons">
                <button class="button button-danger">Delete</button>
              </div>
            </a>

input-group background color and border?

I was trying to make a block button that sits below a set of form inputs. I needed to align the button to the other form inputs.

Using .input-group, a background color and border are applied, but I'm not sure this is the way we should do that.

Thoughts?

Form label wraps

Handle tablet and phone layouts

I don't think responsive is the answer for native apps.

Header component displaying in mobile Chrome but not Safari

Header title sits above buttons

The absolutely positioned header title sits above the buttons making them untappable.

Allow side menu drag on headers and footers

Right now it only triggers on the content area in the controller.

Button without type has default border color

If you don't specify a button class type it will use some defaults that suck.

Header bar and Footer bar shouldn't be scrollable

Check out the input-text example page, and try scrolling by tapping on the main body area. Perfect, right?

Now try doing it by starting with your finger on either the Header or Footer bar. Things get a little wonky. Put simply, the Header/Footer bars shouldn't be scrollable.

Split pane layout

For tablets

Give background color and styles for lists

Move to ngAnimate for all directive animations

Use the $animate service to make our services and directives animatable.

iOS 5 things

Note: we won't support iOS 5, but let's make sure these issues aren't in 6:

Test this scrolling keyboard issue: http://stackoverflow.com/questions/7970389/ios-5-fixed-positioning-and-virtual-keyboard

Emit change event for list item reordering

Content padding edges need to match up with header buttons

Having edges line up is crucial. We need to normalize these paddings and margins to make this work:

Add support for "tap" virtual event

We have to detect and emit a "tap" event when we think we have one. We should never use a "click" event since it's too slow.

Fix examples in test/

Many of these examples are broken due to path changes.

Angular sideMenuCtrl try to get side-menu-ctrl scoping working with restrict: 'E'

I was having trouble with scope inheritance with the sideMenuCtrl directive when it was using transclusion and replacing content. I changed it to a class or attribute and it's working again, but I'd prefer the element replacement.

See the toderp side menu for example.

Grid discussion on docs

Talk about flex box, etc. maybe we can simplify flex box?

Define icon button states

How should the icon buttons behave on tap, hold, click, etc.? @bensperry

Angular side menu only use sides that have directives

Don't show the right menu if there is no directive with side="right"

Border radius is missing on grouped buttons

We need to make sure that the 2px border radius is still present on the outer buttons in button groups.

Add threshold for side menu drag start

SideMenuControl

Think of generic view controller functionality

What happens when you want to use a custom view controller, how do you "extend" and make your own?