@jrc03c/misc-vue-components
v0.0.15
Published
This library contains a few Vue components I've found to be useful in various projects.
Downloads
10
Readme
Intro
This library contains a few Vue components I've found to be useful in various projects.
Installation
npm install --save @jrc03c/misc-vue-components
Usage
Import
With bundlers:
const {
ContextMenu,
Draggable,
Frame,
Resizeable,
} = require("@jrc03c/misc-vue-components")
Without bundlers:
Add the script to your HTML:
<script src="path/to/dist/misc-vue-components.js"></script>
And then in your JS:
const { ContextMenu, Draggable, Frame, Resizeable } = MiscVueComponents
Add to a Vue app or component
const MyComponent = {
name: "x-my-component",
components: {
"x-context-menu": ContextMenu,
"x-draggable": Draggable,
"x-frame": Frame,
"x-resizeable": Resizeable,
},
}
API
ContextMenu
Props
is-visible
(Required) A boolean indicating whether or not the menu should be visible.
items
(Required) An array of objects, each of which has the following properties:
"label"
= the text label of the context menu item (e.g., "Copy", "Paste", "Undo", etc.)"action"
= a callback function to be called when the context menu item is selected; this value is required if"children"
is not defined"children"
= an array of menu items with this same interface; required if"action"
is not defined
x
(Required) A number representing the x-coordinate in pixels of the top-left corner of the context menu; note that this only applies to the "root" menu; descendant menus are dynamically placed relative to viewport edges
y
(Required) A number representing the y-coordinate in pixels of the top-left corner of the context menu; note that this only applies to the "root" menu; descendant menus are dynamically placed relative to viewport edges
Events
"cancel"
Is emitted when the user does not select a menu item and indicates that they want the menu to close.
"close"
Is emitted when the menu closes.
"open"
Is emitted when the menu opens (i.e., when it becomes visible).
"select"
Is emitted when a particular menu item has been selected. The particular menu item that was selected will be passed to event handlers.
Draggable
Props
is-h-locked
(Optional) A boolean indicating whether or not the element is locked to its current horizontal position. In other words, if set to true
, then the element cannot be dragged left or right. The default is false
.
is-v-locked
(Optional) A boolean indicating whether or not the element is locked to its current vertical position. In other words, if set to true
, then the element cannot be dragged up or down. The default is false
.
x
(Optional) A number representing the x-coordinate in pixels of the top-left corner of the element relative to its closest manually-positioned ancestor (i.e., an ancestor whose "position" CSS property has been given a value like "relative", "absolute", or "fixed"). The default is 0
.
y
(Optional) A number representing the y-coordinate in pixels of the top-left corner of the element relative to its closest manually-positioned ancestor (i.e., an ancestor whose "position" CSS property has been given a value like "relative", "absolute", or "fixed"). The default is 0
.
Events
"drag"
Is emitted when the element is dragged. (Note: Movement must occur for this event to be emitted; i.e., it is not emitted while the element is stationary, even if the user has already initiated a drag.) Is passed a DOMRect
representing the bounding box of the element.
"drag-end"
Is emitted when the user stops dragging the element. (Is emitted when the user releases their mouse button or lifts their touch from the screen, not merely when the element is stationary.) Is passed a DOMRect
representing the bounding box of the element.
"drag-start"
Is emitted when a drag is initiated. Is passed a DOMRect
representing the bounding box of the element.
Frame
Props
is-locked
(Optional) A boolean indicating whether or not the frame is locked against pane resizing. In other words, if set to true
, then the panes within the frame cannot be resized. The default is false
.
max-size
(Optional) A number indicating the maximum possible pane size along the primary axis (i.e., the maximum width of each pane in the case of horizontal frames and the maximum height of each pane in the case of vertical frames). The default is Infinity
.
min-size
(Optional) A number indicating the minimum possible pane size along the primary axis (i.e., the minimum width of each pane in the case of horizontal frames and the minimum height of each pane in the case of vertical frames). The default is 64
.
orientation
(Optional) A string representing which way the panes in the frame will be stacked against each other. Must be "horizontal"
or "vertical"
. Horizontal frames will contain panes sitting side-by-side. Vertical frames will contain panes sitting on top of one another.
Events
"resize"
Is emitted when a pane is resized. (Note: Size change must occur for this event to be emitted; i.e., it is not emitted while a pane is not changing size, even if the user has already initiated the resizing process.) Is passed an array containing the two panes (as HTMLElement
instances) being resized.
"resize-end"
Is emitted when the user stops resizing the pane. (Is emitted when the user releases their mouse button or lifts their touch from the screen, not merely when the mouse or touch is stationary while in the process of resizing.) Is passed an array containing the two panes (as HTMLElement
instances) that were being resized.
"resize-start"
Is emitted when pane resizing is initiated. Is passed an array containing the two panes (as HTMLElement
instances) being resized.
Resizeable
Note that a Resizeable
is built on top of a Draggable
; so almost all of the Draggable
API also applies to Resizeable
. Any differences are noted below.
Note also that the "Shift" key can be held down during resizing diagonally to maintain aspect ratio.
Props
height
(Optional) A number representing the height in pixels of the element's bounding box. The default is 256
.
is-drag-h-locked
(Optional) Is passed as the internal Draggable
is-h-locked
prop. The default is false
.
is-drag-v-locked
(Optional) Is passed as the internal Draggable
is-v-locked
prop. The default is false
.
is-resize-bottom-locked
(Optional) A boolean indicating whether or not the element's bottom border is locked against resizing. In other words, if set to true
, then the element cannot be resized by dragging its bottom border up or down. The default is false
.
is-resize-left-locked
(Optional) A boolean indicating whether or not the element's left border is locked against resizing. In other words, if set to true
, then the element cannot be resized by dragging its left border to the left or right. The default is false
.
is-resize-right-locked
(Optional) A boolean indicating whether or not the element's right border is locked against resizing. In other words, if set to true
, then the element cannot be resized by dragging its right border to the left or right. The default is false
.
is-resize-top-locked
(Optional) A boolean indicating whether or not the element's top border is locked against resizing. In other words, if set to true
, then the element cannot be resized by dragging its top border up or down. The default is false
.
min-height
(Optional) A number representing the minimum allowable height in pixels of the element's bounding box. The default is 8
.
min-width
(Optional) A number representing the minimum allowable width in pixels of the element's bounding box. The default is 8
.
width
(Optional) A number representing the width in pixels of the element's bounding box. The default is 256
.
x
(Optional) Is passed as the Draggable
x
prop. The default is 0
.
y
(Optional) Is passed as the Draggable
y
prop. The default is 0
.
Events
"drag"
Same as the Draggable
"drag"
event.
"drag-end"
Same as the Draggable
"drag-end"
event.
"drag-start"
Same as the Draggable
"drag-start"
event.
"resize"
Is emitted when the element is resized. (Note: Size change must occur for this event to be emitted; i.e., it is not emitted while the element is not changing size, even if the user has already initiated the resizing process.) Is passed a DOMRect
representing the bounding box of the element.
"resize-end"
Is emitted when the user stops resizing the element. (Is emitted when the user releases their mouse button or lifts their touch from the screen, not merely when the mouse or touch is stationary while in the process of resizing.) Is passed a DOMRect
representing the bounding box of the element.
"resize-start"
Is emitted when resizing is initiated. Is passed a DOMRect
representing the bounding box of the element.