Skip to content

ntrajic/boc

Repository files navigation

Quick customisation for the BOC non-profit organisation (Burnabyoutdoor.com) >

Image Viewer of BOC trips, with addition of editing trip reports.

Currently boc/img/ directory will contain images of 2 trips - to Buntzen Lake ndn Lyn Canyon Loop.

In the future - for production, there will be directory structure:

boc/img/<06Sep2019_tripName> directory with all its images boc/img/ single directory for *.pdf trip reports

NOTE: boc/src/App.vue HTML template file needs to be updated with trip pictures

ddTripPicture.jpg, dd = n, d is a digit for picutures ordering purposes Pictures need to be placed in the aabove directory, following the directory structure. Trip report needs to be converted from MS Word docx format to PDF (to be read-only), and placed into the single tripReports directory.

Prototype will place all images and reports to boc/img directory - the reason why this is "quick and dirty" prototype, and customisation.

img-vuer

An Mobile-First image viewer for Vue2

中文 README


🙆‍♀️ Easy to use

👉 Swipe gesture

🔍 Zoom gesture

V0.11.0 Now you can use thumbnail~

V0.13.0 Gallery hide when the physical back button is pressed (android device only)

V0.15.0 Fix blurry after using scale()

💻 v0.17.1 compatible with PC

Now you can use both Mobile and PC Browser 😆

live demo

or scan the QRcode

Install

npm i img-vuer --save

Usage

// import img-vuer and install
import gallery from 'img-vuer'
Vue.use(gallery, {
  swipeThreshold: 150, // default 100
  isIndexShow: true, // show image index, default true
  useCloseButton: true, // trigger gallery close with close button, default true
  preload: true, // preload images in the same group, default true
})
<!-- add direact to <img> -->
<img v-gallery :src="..." />

<!-- group images -->
<img v-gallery:groupName :src="..." />
<img v-gallery:groupName :src="..." />
<img v-gallery:groupName :src="..." />

<!-- OR (dynamic bind) -->
<img v-gallery="'groupName'" :src="..." />

<!-- use thumbnail, new in 0.11.0 -->
<img v-gallery :src="thumbnailSrc" data-large="originSrc" />

<!-- trigger close gallery, new in 0.14.0 -->
<button @click="$imgVuer.close()">close</button>

API

api arg description
close() / close the viwer
onIndexChange() cb $imgVuer.onIndexChange((newVal, oldVal)=>{...})
onToggle() cb on close or on open $imgVuer.onToggle((newVal, oldVal)=>{...})
changeBGColor() color change the background color of viwer $imgVuer.changeBGColor('#fff')
next() / switch to next image $imgVuer.next()
prev() / switch to previous image $imgVuer.prev()
getCurrentIndex() / /

Development

# development environment node v6.15.1

# install dependencies
npm install

# serve with hot reload at localhost:8080
npm run dev

# build for production with minification
npm run build

Troubleshooting

Abnormal with page scale

Add meta

<meta
  name="viewport"
  content="width=device-width, initial-scale=1,user-scalable=0, maximum-scale=1"
/>

for a large number of large images

If you group a large number of large images, img-vuer will load all image in the same group, so it will cause unnecessary mobile data traffic and slow the page down.

You can use preload option in this situation and img-vuer will only load the image you watched.

key

Should not use index as key for the component which is added v-gallery.

License

MIT

About

www.burnabyoutdoor.com Forked from https://github.com/ssshooter/img-vuer for Burnaby Outdoor Club purposes (image viewer of trips).

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages