Git Product home page Git Product logo

grid's Introduction

Windows Library for JavaScript (WinJS)

Join the chat at https://gitter.im/winjs/winjs Build Status

Status

Microsoft is committed to making sure that WinJS continues to run for existing customers. At this time we don't have plans to invest in new features or feature requests. Bug fixes will be limited to correcting substantial issues that are blocking customer deployments. We may also consider bug fixes to help our customers maintain their existing WinJS-based apps.

Intro

WinJS is a set of JavaScript toolkits that allow developers to build applications using HTML/JS/CSS technology forged with the following principles in mind:

  • Provide developers with a distinctive set of UI controls with high polish and performance with fundamental support for touch, mouse, keyboard and accessibility
  • Provide developers with a cohesive set of components and utilities to build the scaffolding and infrastructure of their applications

This is a first step for the WinJS project and there is still a lot of work that needs to be done. Feel free to participate by contributing along the way.

Contribute

There are many ways to contribute to the project.

You can contribute by reviewing and sending feedback on code checkins, suggesting and trying out new features as they are implemented, submitting bugs and helping us verify fixes as they are checked in, as well as submitting code fixes or code contributions of your own.

Note that all code submissions will be rigorously reviewed and tested by the team, and only those that meet an extremely high bar for both quality and design appropriateness will be merged into the source.

Build WinJS

In order to build WinJS, ensure that you have git and Node.js installed.

Clone a copy of the master WinJS git repo:

git clone https://github.com/winjs/winjs.git

Change to the winjs directory:

cd winjs

Install the grunt command-line interface globally:

npm install -g grunt-cli

Grunt dependencies are installed separately in each cloned git repo. Install the dependencies with:

npm install

Run the following and the WinJS JavaScript and CSS files will be put in the bin directory:

grunt

Note: You may need to use sudo (for OSX, *nix, BSD etc) or run your command shell as Administrator (for Windows) to install Grunt globally.

Tests status

Refer to http://winjs.azurewebsites.net/#status for the current status of the unit tests and the list of known issues.

Try WinJS

Check out our online playground at http://winjsdevelop.azurewebsites.net/

Follow Us

Twitter https://twitter.com/BuildWinJS
Facebook https://www.facebook.com/buildwinjs

grid's People

Contributors

blustemy avatar chrisbalt avatar josephdaly avatar kylezinter avatar vmaha avatar

Stargazers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

Watchers

 avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar  avatar

grid's Issues

Global Box-sizing - borderbox

I don't think you should globally set box-sizing to border-box. This has the potential to conflict w/ other plugins or techniques that developers are using. The grid should be self-contained and only apply styles that are relative to itself.

please consider doing this instead:

.grid, .row, [class*="col-"] { -moz-box-sizing: border-box; // <= Mozilla v.28 -webkit-box-sizing: border-box; // <= IOS4, <= Android 2.3 box-sizing: border-box; }

Vertical Padding and Margins on grid elements:

The grid should not be setting vertical padding & margins. Vertical spacing should determined by the content of a grid, not the grid itself.

.grid:
change: margin: 0 auto
to: margin-left: auto; margin-right: auto;

change: padding: 0 1em; padding: 1vw;
to: padding-left: 1em; padding-left: 1vw; padding-right: 1em; padding-right: 1vw;

.grid.fixed
change: padding: 0 2px;
to: padding-left: 2px; padding-right: 2px;

.grid.fixed .row
change: margin: -2px;
to: margin-left: 2px; margin-right: 2px;

.grid.zero-margin .row
change: margin: 0;
to: margin-left: 0; margin-right: 0;

.grid .row
change: margin: 0 -1em; margin: 0 -1vw; margin-bottom: 0;
to: margin-left: -1em; margin-left: -1vw; margin-right: -1em; margin-left: -1vw;

.grid .row.content-flush
change: margin: 0 -2em; margin: 0 -2vw;
to: margin-left: -2em; margin-left: -2vw; margin-right: -2em; margin-right: -2vw;

[class*="col-"]
from: padding: 1em 1em; padding: -webkit-calc(1em + 0.5vh) 1vw; padding: calc(1em + 0.5vh) 1vw;
to: padding-left: 1em; padding-left: 1vw; padding-right: 1em; padding-right: 1vw;

I think that's it... Basically, we should only be setting horizontal margins and padding.

Add vertical spacing

I'd like to add vertical spacing for tiled layouts, in which we need the vertical spacing between cells to be equal to the horizontal spacing. For example, the grid should allow us to create layouts that look like the image below, where the horizontal and vertical arrows are equal in length.

image

I plan on sending our a pull request with this addition, but I wanted to figure out the best way to solve it first.

Option 1

Users can add .vertical-spacing to their grid element or individual row. This will work much like the existing fixed-* helpers.

Option 2

We'll add a vertical-spacing boolean to config.scss, which users can turn on if they want vertical spacing.

From the users perspective, option 1 seems better in every way: option 2 forces them to apply the rule to the entire webpage, and forces them to rebuild the grid.

Let me know which option is better and I'll submit the PR.

Specify who it is for

Is it for those devs that work with winjs. Ok. Navs are generated. Scripts and styles included from cdn. And then yes the grid issue arises. As UWP is pixel based correct me if I am wrong - which I am not quite sure but obviously certain - a dev starts to search for precooked css solutions/recs/specs. Is this the one? Might it be helpful to mention in the desc of the project?

Columns Float in RTL

Having issues with columns not changing direction when using dir='rtl'. It appears that columns still render in an left to right fashion with their content being successfully rendered in right to left.

This issue appears only on IE10. In IE11 this is not an issue. I have debugged the issue in IE10 and IE11 and don't anything from a content perspective from my site that could cause this issue.

Thanks for looking into this.

Fixed margin fix for grid margins at 540px or 320px and below.

For a 320 viewport, there should be 12px on each side for apps, which is 3.75% (not 5%)

From: Nicholas Rice
Sent: Wednesday, October 22, 2014 3:14 PM
To: Kyle Zinter
Cc: Jeremy Knudsen; Angela Nelson
Subject: RE: MSCOM Mobile Grid

Hey Kyle-

No worries, just wanted to make sure it didn’t fall off 

I’m looking to Jeremy to define that breakpoint, all I have to go off is mobile. > 540px sounds like a good breakpoint though.

I think the desire for Services is to use the ‘fixed margin grid’ (4px gutters). I think that, beyond mobile sizes, they are fine with having 5% margin’s on the edge of the grid content area. But below that, 5% feels too large and they would like to go 4px ‘margin’ as well as having 4px gutters between columns. Is that correct Jeremy?

I believe what you’ve outlined below is what they are looking for (with that fixed margin being 4px). What I don’t know is if this is something other teams are looking for. Before you create it, you may want to run it by your own design team and gather their thoughts.

Thanks Kyle!
Nick

From: Kyle Zinter
Sent: Wednesday, October 22, 2014 3:04 PM
To: Nicholas Rice
Cc: Jeremy Knudsen; Angela Nelson
Subject: Re: MSCOM Mobile Grid

Also, can you let me know which breakpoint specifically we are looking at?

I'm going to do a little work on the grid tonight after this conference is done for the day. I could definitely add in something quick for this then.

I was thinking that under 540px, on the fixed margin grid only, we make the outer grid margins change from percentage to a fixed margin of your choosing. Thoughts?

KZ


From: Kyle Zinter
Sent: Wednesday, October 22, 2014 1:33 PM
To: Nicholas Rice
Cc: Jeremy Knudsen; Angela Nelson
Subject: Re: MSCOM Mobile Grid

Sorry Nick, not ignoring you. At a conference this weekend.

Is this in regards to outside margins of the whole grid? We have a fixed margin grid offering, if we just want to do it on that, I think that probably makes a lot of sense but I would probably think we should not do it on the true fluid offering.

We should have a chat about this. If we think it should be default behavior or not. This is certainly something that is very easy to accommodate but do we want to or just have an override provided?

KZ


From: Nicholas Rice
Sent: Wednesday, October 22, 2014 12:11 PM
To: Kyle Zinter
Cc: Jeremy Knudsen; Angela Nelson
Subject: RE: MSCOM Mobile Grid

Ping!

From: Nicholas Rice
Sent: Tuesday, October 21, 2014 10:05 AM
To: Kyle Zinter
Cc: Jeremy Knudsen; Angela Nelson
Subject: MSCOM Mobile Grid

Hey Kyle-

Jeremy’s design team has an ask that, at mobile sizes (Jermey, can you clarify at which breakpoint this you mean? 320?), the “margin” grid actually switches from 5% margins to a 4px margin. The reason for this is that, at those sizes, explorations have shown that the margins are pretty huge. Their ask is that we would align to the Metro 2.0 grid at mobile sizes.

Is this something we can accommodate with your grid? Is this something MSCOM designers have considered and might also desire?

Thanks Kyle!
Nick

Landing on breakpoints

Currently breakpoints are set up at 320px, 540, 768, 992, 1200. Will send email til we have consensus inside team.

hidden/toggle?

Is there any way to cause an element to be hidden on specific viewports? for example, a left-toggle refiner menu on a narrow viewport should collapse into the hamburger.

Recommend Projects

  • React photo React

    A declarative, efficient, and flexible JavaScript library for building user interfaces.

  • Vue.js photo Vue.js

    🖖 Vue.js is a progressive, incrementally-adoptable JavaScript framework for building UI on the web.

  • Typescript photo Typescript

    TypeScript is a superset of JavaScript that compiles to clean JavaScript output.

  • TensorFlow photo TensorFlow

    An Open Source Machine Learning Framework for Everyone

  • Django photo Django

    The Web framework for perfectionists with deadlines.

  • D3 photo D3

    Bring data to life with SVG, Canvas and HTML. 📊📈🎉

Recommend Topics

  • javascript

    JavaScript (JS) is a lightweight interpreted programming language with first-class functions.

  • web

    Some thing interesting about web. New door for the world.

  • server

    A server is a program made to process requests and deliver data to clients.

  • Machine learning

    Machine learning is a way of modeling and interpreting data that allows a piece of software to respond intelligently.

  • Game

    Some thing interesting about game, make everyone happy.

Recommend Org

  • Facebook photo Facebook

    We are working to build community through open source technology. NB: members must have two-factor auth.

  • Microsoft photo Microsoft

    Open source projects and samples from Microsoft.

  • Google photo Google

    Google ❤️ Open Source for everyone.

  • D3 photo D3

    Data-Driven Documents codes.