mirror of
https://github.com/tusen-ai/naive-ui.git
synced 2024-12-09 04:31:35 +08:00
.. | ||
components | ||
debugComponents | ||
demo.vue | ||
index.js | ||
index.tpl | ||
indexUsingCss.js | ||
init.js | ||
privateIndex.js | ||
readme.js | ||
SourceBlock.vue | ||
utils.js |
export default `<div class="markdown-body"><h1 id="naiveui">naive-ui</h1> <p>TuSimple Vue-Based Frontend Component Library</p> <h2 id="documentation">Documentation</h2> <p><a href="http://***REMOVED***/#/start">http://***REMOVED***/#/start</a></p> <h2 id="repository">Repository</h2> <p><a href="https://***REMOVED***/naive-ui/tree/develop">https://***REMOVED***/naive-ui/tree/develop</a></p> <h2 id="developguidelines">Develop Guidelines</h2> <h3 id="gitcommitmessagestyle">Git Commit Message Style</h3> <p>You <strong>MUST</strong> follow <a href="https://gist.github.com/brianclements/841ea7bffdb01346392c">Angular Commit Format</a>.</p> <p>If you want see some example, see <a href="https://github.com/angular/angular/commits/master">Angular Commits on Github</a>.</p> <h3 id="codestyles">Code Styles</h3> <h4 id="javascriptstyle">Javascript Style</h4> <p>You <strong>MUST</strong> follow <a href="https://standardjs.com/">Standard JS</a>.</p> <h4 id="scssstyle">SCSS Style</h4> <p>Run <code>npm run lint-style</code> to check styles.</p> <h4 id="checkboth">Check Both</h4> <p>Run <code>npm run lint</code> You <strong>MUST</strong> fix all lint warnings and errors before you push your branch.</p> <h3 id="unittest">Unit test</h3> <p>If you create a component, you <strong>MUST</strong> add unit test for it.</p> <p>Run <code>npm run test</code> to test all components. Run <code>npm run test-cov</code> to test all components and see detailed test coverage report.</p> <h2 id="wanttoseehowcomponentworks">Want to see how component works</h2> <ol> <li>Run <code>npm run dev</code></li> <li>Open <code>http://localhost:8086/</code> in browser.</li> </ol> <h2 id="wanttoaddyourowncomponent">Want to add your own component</h2> <p>There is no guideline for now. If you want to know how to do it, you can explore by yourself or ask <code>lecong.zhang@tusimple.ai</code>.</p> <h2 id="publishanewversion">Publish a new version</h2> <ol> <li>You <strong>MUST</strong> change your version according to <a href="https://semver.org/">semver</a></li> <li><code>npm run release</code></li> <li>You <strong>MAY</strong> publish documentation by running <code>npm run release-doc</code></li> </ol> <h2 id="installationusage">Installation & Usage</h2> <p>First install it.</p> <pre><code>npm install --save-dev naive-ui </code></pre> <p>Then add the following lines in you entry point js file.</p> <pre><code>... import naiveUi from 'naive-ui' import 'naive-ui/dist/lib/index.css Vue.use(naiveUi) ... </code></pre> <h2 id="componentdevelopstatus">Component Develop Status</h2> <table> <thead> <tr> <th>Component</th> <th style="text-align:center;">Develop status</th> <th style="text-align:center;">Unit Test</th> <th>Note</th> </tr> </thead> <tbody> <tr> <td>Alert</td> <td style="text-align:center;">😍</td> <td style="text-align:center;">❌</td> <td></td> </tr> <tr> <td>Button</td> <td style="text-align:center;">😍</td> <td style="text-align:center;">🆗</td> <td></td> </tr> <tr> <td>Checkbox</td> <td style="text-align:center;">😍</td> <td style="text-align:center;">🆗</td> <td></td> </tr> <tr> <td>DatePicker</td> <td style="text-align:center;">😍</td> <td style="text-align:center;">❌</td> <td></td> </tr> <tr> <td>TimePicker</td> <td style="text-align:center;">😍</td> <td style="text-align:center;">❌</td> <td></td> </tr> <tr> <td>GradientText</td> <td style="text-align:center;">😍</td> <td style="text-align:center;">🆗</td> <td></td> </tr> <tr> <td>Icon</td> <td style="text-align:center;">😍</td> <td style="text-align:center;">🆗</td> <td></td> </tr> <tr> <td>Input</td> <td style="text-align:center;">😍</td> <td style="text-align:center;">🆗</td> <td></td> </tr> <tr> <td>Message</td> <td style="text-align:center;">😍</td> <td style="text-align:center;">❌</td> <td>Code clean in need</td> </tr> <tr> <td>Modal</td> <td style="text-align:center;">😍</td> <td style="text-align:center;">❌</td> <td>Code clean in need</td> </tr> <tr> <td>Notification</td> <td style="text-align:center;">😍</td> <td style="text-align:center;">❌</td> <td>Code clean in need</td> </tr> <tr> <td>Pagination</td> <td style="text-align:center;">😍</td> <td style="text-align:center;">🆗</td> <td>Unit test is not enough</td> </tr> <tr> <td>Select</td> <td style="text-align:center;">😍</td> <td style="text-align:center;">🆗</td> <td>Multiple search is not done</td> </tr> <tr> <td>Switch</td> <td style="text-align:center;">😍</td> <td style="text-align:center;">❌</td> <td></td> </tr> <tr> <td>Tooltip</td> <td style="text-align:center;">😍</td> <td style="text-align:center;">❌</td> <td></td> </tr> <tr> <td>Popover</td> <td style="text-align:center;">😍</td> <td style="text-align:center;">❌</td> <td></td> </tr> <tr> <td>InputNumber</td> <td style="text-align:center;">😍</td> <td style="text-align:center;">❌</td> <td></td> </tr> <tr> <td>Radio</td> <td style="text-align:center;">😍</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Tab</td> <td style="text-align:center;">😍</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Badge</td> <td style="text-align:center;">😍</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Steps</td> <td style="text-align:center;">😍</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Tag</td> <td style="text-align:center;">😍</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Divider</td> <td style="text-align:center;">😍</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Popconfirm</td> <td style="text-align:center;">😍</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>BackTop</td> <td style="text-align:center;">😍</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Progress</td> <td style="text-align:center;">😍</td> <td style="text-align:center;"></td> <td>Multiple Value</td> </tr> <tr> <td>Timeline</td> <td style="text-align:center;">😍</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Collapse</td> <td style="text-align:center;">😍</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Cascader</td> <td style="text-align:center;">😍</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Dropdown</td> <td style="text-align:center;">😍</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Transfer</td> <td style="text-align:center;">😍</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Spin</td> <td style="text-align:center;">😍</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Drawer</td> <td style="text-align:center;">🤔</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>FormItem</td> <td style="text-align:center;">🤔</td> <td style="text-align:center;">❌</td> <td></td> </tr> <tr> <td>Form</td> <td style="text-align:center;">🤔</td> <td style="text-align:center;">❌</td> <td></td> </tr> <tr> <td>Table</td> <td style="text-align:center;">🤔</td> <td style="text-align:center;">❌</td> <td>Function is not fulfilled</td> </tr> <tr> <td>Slider</td> <td style="text-align:center;">🤔</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>LoadingBar</td> <td style="text-align:center;">😍</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>AutoComplete</td> <td style="text-align:center;">🚧</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Tree</td> <td style="text-align:center;">🚧</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>TreeSelect</td> <td style="text-align:center;">🚧</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Upload</td> <td style="text-align:center;">🚧</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Time</td> <td style="text-align:center;">🚧</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Anchor</td> <td style="text-align:center;">🚧</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Statistic</td> <td style="text-align:center;">🚧</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Breadcrumb</td> <td style="text-align:center;">🚧</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Card</td> <td style="text-align:center;">🚧</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Empty</td> <td style="text-align:center;">🚧</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Grid</td> <td style="text-align:center;">🚧</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Layout</td> <td style="text-align:center;">🚧</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Affix</td> <td style="text-align:center;">🚧</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Rating</td> <td style="text-align:center;">🚧</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Avator</td> <td style="text-align:center;">🚧</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Result</td> <td style="text-align:center;">🚧</td> <td style="text-align:center;"></td> <td></td> </tr> <tr> <td>Menu</td> <td style="text-align:center;">✋</td> <td style="text-align:center;"></td> <td>Not Planne</td> </tr> <tr> <td>Typography</td> <td style="text-align:center;">✋</td> <td style="text-align:center;"></td> <td>Not Planne</td> </tr> <tr> <td>Mentions</td> <td style="text-align:center;">✋</td> <td style="text-align:center;"></td> <td>Not Planne</td> </tr> <tr> <td>Calendar</td> <td style="text-align:center;">✋</td> <td style="text-align:center;"></td> <td>Not Planned</td> </tr> <tr> <td>Carousel</td> <td style="text-align:center;">✋</td> <td style="text-align:center;"></td> <td>Not Planned</td> </tr> </tbody> </table> <ol> <li>Z-index management on <code>Select</code> & <code>Tooltip</code> & <code>Modal</code>(Low Priority)</li> <li>Full featured table component(Medium Priority)</li> <li>Form component(Medium Priority)</li> <li>FormItem component(High Priority)</li> <li>Complete unit test for all existing components(High Priority)</li> <li>Create a Markdown webpack loader to convert documentation(Low Priority)</li> <li>Refactor documentation page(for code clairity)</li> <li>Code refactor for some 😢 messy code(which is my bad…)</li> <li>Refactor CSS use mixins(which means I should learn SCSS hard…)</li> </ol> <h2 id="roadmap">RoadMap</h2> <p>v0.3 cascader v0.4 refactor popover v0.5 finish all planned components v0.6 add keyboard event on planned components v0.7 refactor form component v0.8 refactor table component v0.9 fulfill props for all components v0.10 split icons for components v0.11 refactor css v0.12 import on demand v0.13 i18n v0.14 unit test v0.15 light theme v0.16 refactor using proper html tags v0.17 document formation v0.18 refactor document page</p></div>`