GithubHelp home page GithubHelp logo

dusanmilko / carbon-components-vue Goto Github PK

View Code? Open in Web Editor NEW

This project forked from carbon-design-system/carbon-components-vue

0.0 2.0 0.0 93.44 MB

Vue implementation of the Carbon Design System

Home Page: http://vue.carbondesignsystem.com

License: Apache License 2.0

JavaScript 47.82% HTML 0.54% Shell 0.69% Vue 50.83% CSS 0.12%

carbon-components-vue's Introduction

carbon-components-vue

Carbon Components Vue is released under the Apache-2.0 license CircleCI

Vue implementation of the Carbon Design System A collection of Carbon Components implemented using Vue logo Vue.js.

@carbon/vue

Usage

General

The components do not import any of the carbon styles themselves. Use the SCSS or CSS from carbon-components to provide the styling.

  • In your main js file (where you include Vue) you can include the styles wholesale: import "carbon-components/css/carbon-components.min.css";
  • You can also use the unpkg cdn to bring in the styles wholesale: unpkg.com/carbon-components/css/carbon-components.min.css aliases the latest minified css file.
  • If you prefer to build the SCSS, in the <style> tag of your top-level component you can include the styles wholesale: @import "~carbon-components/scss/globals/scss/styles.scss";
  • Check out the Carbon Design System developers page for information on including individual component styles into your project.

List of Available Components

View available Vue Components here. Usage information is in the notes tab.

Getting Started

Run the following command using npm:

npm install @carbon/vue

If you prefer Yarn, use the following command instead:

yarn add @carbon/vue

NOTE: https://www.npmjs.com/package/current-script-polyfill is required for older browsers (e.g. IE11)

Using all at once

In your main js file (where you include Vue)

// No need for Babel
import CarbonComponentsVue from '@carbon/vue';

alternatively if wanting to specify babel presets

// need babel
import CarbonComponentsVue from '@carbon/vue/src/index';
Vue.use(CarbonComponentsVue);

Using one at a time

In your main js file (where you include Vue)

// No need for Babel
import { CvButton } from '@carbon/vue';

In a component file

<script>
...
import CvButton from '@carbon/vue/src/components/cv-button/cv-button';
...
components: {
  CvButton,
},
...
</script>

From unkpg

In your html file, no need to babel.

<script src="https://unpkg.com/vue@latest" />
<script src="https://unpkg.com/@carbon/vue" />
<script>
Vue.use(window['carbon-vue'].default);
<script>

. . . <cv-button>Hello</cv-button>

Project State

1.0.1

  • Removed setTimeout use
  • Added Skeleton components for
  • CvFileUpload
  • CvDropdown
  • CvCodeSnippet
  • CvCheckbox

1.0.0

  • Add actions option to data table
  • Add batch actions option to data table
  • Updated table pagination
  • Add CvDataTableRow and CvDataTableCell to allow HTML use in tables
  • Add CvButtonSkeleton
  • Add overflow menu option to table.

1.0.0-beta.4

  • Fix initially hidden expanding tile behaviour.
  • Add CvBreadCrumbSkeleton

1.0.0-beta.3

  • Add header and footer slots for CvTable
  • Set button type="button" for all buttons except CvButton. This prevents form submit if a component happens to be inside a form.
  • Added CvSkeletonText, CvAccordionSeketon and CvAccordionItemSekeleton.

v1.0.0-beta.2

  • Removed Symbol use in prop types, fixing CvRadioButton, CvSlider and CvPagination use with the minified compiled modules.
  • Minor story fixes

v1.0.0-beta.1

  • Fix typo in CvContentSwitcherContent component name

v1.0.0-beta.0

  • Storybook: update views
  • CvFileUploader: added v-model and missing parts to
  • CvToolbar: added
  • CvDataTable: added minus the filter/toolbar
  • Tests - Added unit test suite and first tests (CvTag)
  • CvContentSwitcher - Added non-DOM direct content managment
  • Turned helper and invalidMessages into slops (slot-prop hybrid)
  • CvIcon - Downgraded to helper component to remove dependency on carbon-icons
  • Renamed UMD and CommonJS modules from carbon-components-vue... to carbon-vue...

v0.3.0

  • Initial data-viz/bar-graph added
  • Story corrections
  • Change use of $parent to prefer events
  • Chagne use of $children to check child type
  • Fix overflow and interactive-tooltip position on scroll/resize

v0.2.9

  • Add gauge component - story is Data-viz/CvGauge
  • Add pie chart component - story is Data-viz/CvPieChart
  • Add router-link version of CvLink

v0.2.8 Correct duff deploy

v0.2.7

  • Fix click on modal dialog closing it

v0.2.6

  • Fix tab out of modal
  • Remove unused vars

v0.2.5 - Minor fixes

  • Make structured list native Vue
  • Simplify structured list components
  • Removed non-core CSS
  • Fix to paginator reactivity

v0.2.4 - Minor fixes

  • Make tooltip native Vue
  • Tidy up a bit of unused code
  • Make tabs native Vue and use carbon react pattern (breaks previous tab use)

v0.2.3 - Minor fixes

  • Fix modal hide on main body click and show visible in story.
  • Make cv-search native Vue.
  • Make cv-number-input native Vue.

v0.2.2 - Minor fixes

  • Fixed expandable tile and made it native Vue
  • Made notification componentes native Vue
  • Tidied toggle stories.

v0.2.0 - Moved to Storybook 4

  • Knobs now operate as Vue properties the template is no longer replaced each time (as per Knobs in storybook 3)
  • Story kinds array replaced by variants which define the settings used in each story.
  • NOTE: slots no longer editable

v0.1.0 - First draft of carbon-components-vue implementation

This initial set of components, based on v9 of carbon components, includes draft implementations of all non-data viz components found in the core carbon components library. Public parts of the component: properties, events, data, methods, computed values are at this point subject to review at this point.

Current Components

View available Vue.js components here. Usage information is available when you click the blue ? icon in the top right corner of the selected component.

Current Version: 0.1 :white_check_mark: Ready :warning: Under review :heavy_minus_sign: Not available

Components State Link
CvAccordion http://vue.carbondesignsystem.com/?selectedKind=CvAccordion
CvBarGraph ⚠️ http://vue.carbondesignsystem.com/?selectedKind=Data-Viz%2FCvBarGraph
CvBreadcrumb http://vue.carbondesignsystem.com/?selectedKind=CvBreadcrumb
CvButton http://vue.carbondesignsystem.com/?selectedKind=CvButton
CvCheckbox http://vue.carbondesignsystem.com/?selectedKind=CvCheckbox
CvCodeSnippet http://vue.carbondesignsystem.com/?selectedKind=CvCodeSnippet&selectedStory=All
CvContentSwitcher http://vue.carbondesignsystem.com/?selectedKind=CvContentSwitcher
CvDataTable carbon-design-system#51
CvDatePicker http://vue.carbondesignsystem.com/?selectedKind=CvDatePicker&selectedStory=All
CvDropdown http://vue.carbondesignsystem.com/?selectedKind=CvDropdown
CvFileUploader http://vue.carbondesignsystem.com/?selectedKind=CvFileUploader&selectedStory=All
CvForm http://vue.carbondesignsystem.com/?selectedKind=CvForm
CvGauge ⚠️ carbon-design-system#49
CvInlineNotification http://vue.carbondesignsystem.com/?selectedKind=CvInlineNotification
CvLineGraph carbon-design-system#53
CvLink http://vue.carbondesignsystem.com/?selectedKind=CvLink
CvList http://vue.carbondesignsystem.com/?selectedKind=CvList
CvLoading http://vue.carbondesignsystem.com/?selectedKind=CvLoading
CvModal http://vue.carbondesignsystem.com/?selectedKind=CvModal
CvNumberInput http://vue.carbondesignsystem.com/?selectedKind=CvNumberInput
CvOverflowMenu http://vue.carbondesignsystem.com/?selectedKind=CvOverflowMenu
CvPagination http://vue.carbondesignsystem.com/?selectedKind=CvPagination&selectedStory=All
CvPieChart ⚠️ carbon-design-system#52
CvProgress http://vue.carbondesignsystem.com/?selectedKind=CvProgress
CvRadioButton http://vue.carbondesignsystem.com/?selectedKind=CvRadioButton
CvScatterPlot carbon-design-system#50
CvSearch http://vue.carbondesignsystem.com/?selectedKind=CvSearch
CvSelect http://vue.carbondesignsystem.com/?selectedKind=CvSelect
CvSlider http://vue.carbondesignsystem.com/?selectedKind=CvSlider
CvStructuredList http://vue.carbondesignsystem.com/?selectedKind=CvStructuredList
CvTabs http://vue.carbondesignsystem.com/?selectedKind=CvTabs
CvTag http://vue.carbondesignsystem.com/?selectedKind=CvTag
CvTextArea http://vue.carbondesignsystem.com/?selectedKind=CvTextArea
CvTextInput http://vue.carbondesignsystem.com/?selectedKind=CvTextInput
CvTimePicker http://vue.carbondesignsystem.com/?selectedKind=CvTimePicker&selectedStory=All
CvTile http://vue.carbondesignsystem.com/?selectedKind=CvTile
CvToastNotification http://vue.carbondesignsystem.com/?selectedKind=CvToastNotification
CvToggle http://vue.carbondesignsystem.com/?selectedKind=CvToggle
CvTooltip http://vue.carbondesignsystem.com/?selectedKind=CvTooltip

Development

Please refer to the Contribution Guidelines before starting any work.

Contributing

Fork, create branch, submit PR. The PR will be used as part of a review process.

Publishing this library on gh-pages

sh deploy-gh-pages.sh

carbon-components-vue's People

Watchers

 avatar  avatar

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.