Migration guide
TIP
Zumly, a new zooming UI library, is now public at [https://github.com/zumly/zumly](https://github.com/zumly/zumly)
Give a try!
With the release of zircle-ui 0.9.0 many internal and external things have changed. As a result zircle-ui is now more intuitive and easy to use.
Following this brief migration guide it will be easy for you to adatp your project to the new version of zircle-ui.
Built-in components with changes
z-canvas
Changes:
z-canvas
has now a new property namedviews
- Use prop
views
to pass all your zircle's views.
See
z-view-manager
Changes:
z-view-manager
becomes a child component ofz-canvas
- It is no longer a
public
component, so you don't need to use anymore.
See
z-panel
Changes:
z-panel
changed its name toz-view
See
z-scale
Changes:
z-scale
changed its name toz-spot
z-spot
has three behaviours:- By default is a view controller to zoom-in to another view
- When property
button
is truez-spot
becomes a button - When property
knob
is truez-spot
becomes a range knob
See
z-button
- Changes:
z-button
was deleted- Use
z-spot
with propertybutton
<z-spot button></z-spot>
- See
z-range
- Changes:
z-range
was deleted- Use
z-spot
with propertyknob
<z-spot knob></z-spot>
- See
z-list
Changes:
- Its child component
z-item
was deleted. Usez-spot
- Its child component
See
z-item
z-alert
Changes:
- Its name was changed to
z-dialog
- Its name was changed to
See
Public API
- Changes:
- The store state is not exposed anymore. Just its
actions
- The store state is not exposed anymore. Just its
$zircleStore
Changes:
- Its name was changed to
$zircle
- Its name was changed to
See
config()
- New
- Optional
- Use to config your zircle-ui project
$zircle.config({
mode: 'full' // or 'mixed'
style: {
theme:,
theme-mode:
},
router: router, // vue-router object
debug: false // or true
})
- See
setRouter()
Changes:
setRouter()
was deleted- Use
config()
See
routerHooks()
Changes:
routerHooks()
was deleted- Use
config()
See
CSS styles
Before zircle-ui 0.9.0 the css styles were embedded into zircle.js
. At the begining, I thought it was cool, but using it a while I realized that it is difficult to adapt the styles to a particular project. So, in zircle-ui >= 0.9.0 the css styles are extracted into a separated css file again.
From zircle-ui 0.9.0 the css prepocessor SASS is used in development. Now there are two sass files. One, called styles
with generic styles and other called themes
.
Some css classes were renamed to avoid potentials conflicts with others libraries.