Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/fuxingloh/vue-horizontal
An ultra simple pure vue horizontal layout for modern responsive web with zero dependencies. (SPA/SSG/SSR)
https://github.com/fuxingloh/vue-horizontal
horizontal horizontal-scrolling layouts list-layouts listview nuxtjs spa ssg ssr vue vue-horizontal vuejs
Last synced: about 3 hours ago
JSON representation
An ultra simple pure vue horizontal layout for modern responsive web with zero dependencies. (SPA/SSG/SSR)
- Host: GitHub
- URL: https://github.com/fuxingloh/vue-horizontal
- Owner: fuxingloh
- License: mit
- Created: 2020-12-10T12:07:38.000Z (almost 4 years ago)
- Default Branch: main
- Last Pushed: 2023-12-18T02:09:10.000Z (9 months ago)
- Last Synced: 2024-04-30T05:04:59.605Z (5 months ago)
- Topics: horizontal, horizontal-scrolling, layouts, list-layouts, listview, nuxtjs, spa, ssg, ssr, vue, vue-horizontal, vuejs
- Language: Vue
- Homepage: https://vue-horizontal.fuxing.dev
- Size: 11.3 MB
- Stars: 218
- Watchers: 5
- Forks: 33
- Open Issues: 33
-
Metadata Files:
- Readme: README.md
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
Awesome Lists containing this project
README
# [Vue Horizontal](https://vue-horizontal.fuxing.dev) [](https://www.npmjs.com/package/vue-horizontal) [](https://www.npmjs.com/package/vue-horizontal)
Designing your web app for a horizontal experience can be tedious and overwhelming if you are new to web development.
While a vertical design comes naturally as html is naturally vertical by design `display:block`.
With `display:flex`, aligning your content horizontally becomes natural and intuitive,
but it doesn't support overflow or navigation.
You start to add more hacks and tricks to get the design you wanted, but those hacks are not consistent and
cross-browser tested, SSG or SEO friendly.
You get the idea.
There are many libraries already in an open-source world, some using direct DOM manipulation, some importing another
legacy JavaScript or JQuery library.
You don't want that.
Vue already does that.
This is Vue native created for Vue, and only Vue is the peer dependency required.
All modes of rendering (SPA/SSR/SSG) are supported and tested with E2E tools.
The actual library is only about 400 LOC while there are at least 100x more LOC in the documentation, end-to-end testing
and a bunch of other fun stuff.
#### [DEMO](https://vue-horizontal.fuxing.dev/recipes/cards) • [DOCUMENTATION](https://vue-horizontal.fuxing.dev) • [FEATURES](https://vue-horizontal.fuxing.dev/features)
[](https://vue-horizontal.fuxing.dev)
## Features and Design Philosophy
- **SSR/SSG/SPA: all modes of rendering supported**
- Mobile first for the responsive web
- Customizable navigation: scroll bar, buttons or basically everything
- UX focused, smooth scrolling, snapping for a variety of use cases.
- Small size of 3 KB for CDN users
- Highly extensible for any use case
with [well documented recipes](https://vue-horizontal.fuxing.dev/design/principles).
- You control how to structure your content with HTML
- You control how it looks with CSS
- You control how to navigate your layout with Vue.js
## Installation
```shell
# for Vue 2
npm i vue-horizontal
# for Vue 3
# migration notes: https://github.com/fuxingloh/vue-horizontal/pull/87
npm i vue-horizontal@next
# or
yarn add vue-horizontal
# or via
https://cdn.jsdelivr.net/npm/[email protected]/dist/vue-horizontal.esm.min.js
```
## Usage
<details>
<summary><b>Import Locally</b></summary>
```vue
<script>
import VueHorizontal from "vue-horizontal";
export default {
components: {VueHorizontal}
}
```
Import Globally
```javascript
import Vue from 'vue';
import VueHorizontal from "vue-horizontal";
Vue.component(VueHorizontal)
```
Import Script
```html
```
### Using Vue Horizontal
```vue
{{ item.title }}
{{ item.content }}
import VueHorizontal from "vue-horizontal";
export default {
components: {VueHorizontal},
data() {
return {
// E.g: creates 20 array items...
items: [...Array(20).keys()].map((i) => {
return {title: `Item ${i}`, content: `🚀 Content ${i}`};
}),
}
}
}
section {
padding: 16px 24px;
background: #f5f5f5;
}
```
### [More features and examples](https://vue-horizontal.fuxing.dev/features)
- [All features demo](https://vue-horizontal.fuxing.dev/features)
- [Design: Principles](https://vue-horizontal.fuxing.dev/design/principles)
- [Design: Responsive](https://vue-horizontal.fuxing.dev/design/responsive)
- [Design: Navigation](https://vue-horizontal.fuxing.dev/design/navigation)
- [Design: Scrollbar](https://vue-horizontal.fuxing.dev/design/scrollbar)
- [Recipes](https://vue-horizontal.fuxing.dev/recipes/about)
## Known Limitations
### [CSS Scroll Behavior: Smooth](https://vue-horizontal.fuxing.dev/limitations#css-scroll-behavior-smooth)
In Vue Horizontal, smooth scrolling is enabled by default. With `scroll-behavior: smooth`, it enables smooth scrolling
experience when scroll event is triggered by programmatic calls. Although this is not a breaking functional feature, it
provides a **"smooth"** scrolling user experience.
As of December 2023, there is a 96% cross-browser compatibility.
### [CSS Scroll Snap](https://vue-horizontal.fuxing.dev/limitations#css-scroll-snap)
Scroll snap align or scroll-snapping, is a CSS technique that allows customizable scrolling experiences like pagination
of carousels by setting defined snap positions. Vue Horizontal has it enabled by default to disable you can
set ``.
As of December 2023, there is a 98% cross-browser compatibility.
## Development
Setup, develop & test.
```shell
npm install # install
npm run serve # dev
npm run cypress:run # e2e testing
```
- End-to-end test cases are also written because of the UI nature of this framework.
[Cypress](https://www.cypress.io/) is used under the hood.
- There is also additional integration testing done to ensure SSR and SSG works.
## Contributions
- For any question or feature request, please feel free to create
an [issue](https://github.com/fuxingloh/vue-horizontal/issues/new)
or [pull request](https://github.com/fuxingloh/vue-horizontal/pulls).
- For feature request, do check out the examples as some of them might have been implemented.
## Prior art
- [Motivation](https://vue-horizontal.fuxing.dev/#motivation)
- [vue-horizontal-list](https://github.com/fuxingloh/vue-horizontal-list)
- [kenwheeler/slick](https://github.com/kenwheeler/slick)
Originally, this project started out as another project
called [vue-horizontal-list](https://github.com/fuxingloh/vue-horizontal-list). I created the origin project because I
liked how AirBnb does their horizontal layout. I couldn't find a library that implements it vue natively without relying
on a legacy js/jquery dependency.
This project is another take on it with an ultra simple implementation that is extensible and moves the responsibility
to the user rather than the library.
## License
[](https://app.fossa.com/projects/git%2Bgithub.com%2Ffuxingloh%2Fvue-horizontal?ref=badge_large)