Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/orlyyani/read-more

A Vue.js read more plugin
https://github.com/orlyyani/read-more

vue vuejs2

Last synced: 4 days ago
JSON representation

A Vue.js read more plugin

Awesome Lists containing this project

README

        

# Vue.js Read-More

[![npm version](https://badge.fury.io/js/vue-read-more.svg)](https://badge.fury.io/js/vue-read-more)

Read-More is a simple plugin fo vue.js that has been created with :heart: by a bored developer.

# Examples

For examples, refer to [the demo page](https://orlyyani.github.io/read-more/#/).

# NPM

```
npm install vue-read-more --save
```

# Features!

- Add read more length
- Add read more link
- Custom read more string
- Custom read less string

# Usage

```
import ReadMore from 'vue-read-more';

Vue.use(ReadMore);
```

# Sample

You can use either the Component approach or the Directive approach.

### Component

```




export default {
data () {
return {
msg: 'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam.',
msg2: 'Lorem ipsum dolor sit amet'
}
}
}

```

### Directive

*Note:*
When using the directive approach, you will always have `lessStr` after clicking the read more and you can't modify the `moreStr` and the `lessStr` unless you will use the Component approach.

```




export default {
data () {
return {
msg: 'Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Ut enim ad minim veniam.',
msg2: 'Lorem ipsum dolor sit amet'
}
}
}

```

### Using Options

All read more options were converted to props to be able use them in the `vue-read-more` component.

*Usage*
```html

```

# API

| Option | Type | Default | Description |
|--------|------|---------|-------------|
| `text` (required) | `String` | `none` | `text` is used to limit the submitted string based on the `maxChars`.|
| `maxChars` | `Number` | `100` | It is used to limit the `text` value to generate a read more text. |
| `link` | `String` | `#` | You can pass a link incase you want to redirect the user when the `moreStr` has been triggerd.
| `moreStr` | `String` | `read more` | You can customize your read more string by passing a value to `moreStr`.
| `lessStr` | `String` | `none` | You can customize your read less string by passing a value to `lessStr`.

*Note:*
When you didn't pass something in the `lessStr`, after clicking the read more you wouldn't have a read less link.

# License

#### MIT
Use at your own risk!
with :heart: by Lyor