teng2015 / ng-showcase

Angular指令及组件的全面范例

Angular范例集

这是一个基于angular的界面元素范例程序，基于bootstrap 3框架，优先使用内置指令来完成。 其目标是做一个类似smartclient等控件包的showcase程序，展示angular的能力，同时作为精简的备查字典。

当前进展：刚刚开始。

在线预览：http://www.ngnice.com/showcase/

注意：

1. clone下去之后，请先确保有node环境，然后执行npm install和bower install命令，以便对grunt环境进行初始化。 之后就可以用grunt serve来启动服务器进行查看和调试了。
2. 如果使用windows系统，请务必在提交更改前用下列命令配置git： git config core.autocrlf input 我们统一使用unix的行结尾风格提交，以免出现不必要的修改。
3. 建议修改前先调用git pull --rebase拉取一下远端代码，以免出现不必要的冲突。
4. 请把所有文件中的缩进都设置为2空格，以免出现不必要的修改。
5. 如果要参与开发，请先看看本项目的wiki，我会把一些开发中的注意事项随时放在里面。

总体原则

1. 参照smartclient的demo实现
2. 优先使用内置指令实现，除非能证明有显著优势，否则不要封装自定义指令
3. 候选方案顺序 内置指令 > filter > service > 自定义指令
4. 任何会修改数据的操作均通过ng-model完成
5. css框架统一使用bootstrap 3
6. 复杂的控件尽量用封装适当的jquery控件或bootstrap控件的方式进行，但是不要依赖jquery-ui
7. 如果有可以实现此功能的成熟的第三方指令，可以直接使用它并链接到它的开发页和demo页。注意，这里使用的第三方指令必须是足够成熟、友好的。

组织方式

1. 通过issue进行沟通
2. 可以通过把issue assign给自己的方式主动认领任务
3. 在对程序有一定程度理解的基础上，可以自行调整菜单甚至代码结构。如果觉得不是很有把握，请在群里提出讨论。
4. 定期review，对功能规划进行审议，可能会进行菜单调整或功能合并。但不会因为把某人实现的功能移出菜单而将其移出贡献列表。

分工

1. 构建基于github的CI环境，并支持自动发布
2. 开发一个界面框架，能让访客体验操作并现场查看源码，仿smartclient的demo
3. 所有人均可报名参加用户化测试
4. 产品组负责把关filter/directive等界面元素的描述性，并纠正命名不当等问题
5. 多语言组负责开发多语言界面

目标

1. 基本输入指令
2. grid
3. tree
4. 表单及校验
5. 对话框
6. 综合demo

其他目标可在开发过程中增补