Implements pagination with page numbers

[israelss]

As requested by @caiquecastro on #11.

Also, included two more options: previous_button_icon and next_button_icon.

When using the pagination without page_numbers prop, the [previous|next]_button_text will have priority over [previous|next]_button_icon. When page_numbers is true, the icons have priority.
But in any case, the user still can override icon or text by passing a value on options.

The default icons are glyphicon-chevron-left and glyphicon-chevron-right.

I wrote some additional tests, but to be honest, until today I didn't have any experience with any kind of automatized tests, so if they are poorly written or if there are need for some more tests, please tell me!

[hootlex]

Great job @israelss
Though, I think that the page_number property should be a key within config. Why did you choose this way?

previous_button_icon 👍

[israelss]

I think that it's simpler and easier to use it that way, but on a second thought I agree that it should be included within config and passed through options, specially because I plan to improve it, and include a max_buttons option, to include an ellipsis button when given too many pages, showing only (max_buttons - 3) + ellipsis button + the two last buttons, aside previous and next buttons.

E.g., with that options:

options: {
  page_numbers: true,
  max_buttons: 7
}

And with 13 pages in total, the result will be something like that (yes, i took that example from Foundation 6 pagination):

I will change it to be passed through options and fix a small bug that I just found out 😅
The max_buttons feature will be implemented later, probably next week.

[israelss]

Ok, so ellipsis buttons are now available! 😃

A new option was created, max_buttons, and it defaults to 7, i.e., when using page_numbers: true the default maximum number of page buttons will be 7, but using the max_buttons one can define any number to it (minimum recommended 5, minimum enforced 1). When passing a number lower than 1, the default value will be applied.

Another new option is ellipses, which defaults to true, and can be used to indicate if the paginator will use ellipsis buttons when the total of pages is greater than the max_buttons option.

What are your thoughts on these changes, @hootlex?

[nmfzone]

When will this be merged? I think it would be nice. Btw, is this support Vue 2?

[israelss]

@nmfzone it works fine with Vue 2 👍

[israelss]

One more addition, the page_button_text option. One can pass a string and it will be attached before the number of the page.

[hootlex]

Awesome work @israelss
I will try to review and merge it today.

When it is done, do you plan on updating the documentation?
If you don't, it's okay. I just want to know. :)

[hootlex]

@israelss

1. I am working on the plugin and I see that some times it generates 2 ellipses buttons.
   What is the reason for this?
2. The page button prefix is cool!
3. Don't make any changes on this pr since I've already merged it and upated in a local branch.

[hootlex]

@israelss I think I'm done. Check page-numbers branch and feel free to open a pr there if you want to make any changes.

[hootlex]

@israelss could I have an answer on 1?

[israelss]

Sorry, I was off the net the last two weeks.

Answering:

When it is done, do you plan on updating the documentation?

I can work on the docs. But I can only start it on next week, is that ok?

I am working on the plugin and I see that some times it generates 2 ellipses buttons. What is the reason for this?

Is that random/unexpected? When it is happening? 😕

The page button prefix is cool!

Thanks! 😃

Check page-numbers branch and feel free to open a pr there if you want to make any changes.

I'll take a closer look tomorrow 👍

[hootlex]

Hey @israelss, thanks for the quick update.

Regarding the ellipses, I dont think it is a bug since you are displaying them intentionally.
My question is, why? I've never seen a paginator with two ellipses.

I can work on the docs. But I can only start it on next week, is that ok?

Of course, it is okay. You can do it whenever you like to. I just need to know if you will do it.

[nmfzone]

Is there any update for this?

[gsuxlzt]

Hi. just wondering if this will be implemented? Thanks a lot.

[maqduni]

Yyyeah... is it happening? You guys don't seem to have been too active in the past 1.5 years :D. This is a good feature, so if anyone can finish the job it'd be awesome.

[hootlex]

#11