selectrowsjs's Introduction

SelectRows.Js

The SelectRows.Js is a JavaScript library for handling the rows selection of an HTML table.

Find a live example here.

>>>> IF YOU LIKE THIS PROJECT, STAR IT ! <<<<

Outline:

Getting Started.
Enabling / Disabling Buttons.
Using SelectRows.Js as a MySaaS Extension.

1. Getting Started

Get started in 3 simple steps.

Step 1. Download the libraries jquery-3.5.1.min.js and selectrows.min.js. You can download them from this page.

Step 2. Include the file of your HTML page.

<script src="jquery-3.5.1.min.js" type="text/javascript"></script>
<script src="./selectrows.min.js" type="text/javascript"></script>

Step 3. Create your table with rows selection.

Example:

<table class="table table-striped" style='table-layout: fixed; width: 100%;'>
    <thead>
        <th style='text-align: center; width:15px' >
            <input class="checkbox select-all-rows" data-input-id='ids' data-rows-group-id='users' type="checkbox">
        </th>
        <th style ='width:auto;'>
            Name
        </th>
        ...
    </thead>
        
    <tbody>
        <input type='hidden' name='ids' id='ids' value='' />
        <tr>
            <td style='text-align: center; vertical-align: top;'>
                <input class="checkbox select-row" data-rows-group-id='users' type="checkbox" id="123" data-id="123" />
            </td>
            <td>
                <input class='user-input input-block-level' type='text' id='name' value='Leandro Daniel Sardi' />
            </td>
            ...
        </tr>
    </tbody>
</table>

<script>
    // call the function init when the page is loaded.
    selectRowsJs.init();
</script>

2. Enabling / Disabling Buttons

Some buttons in your screen may require one or more rows are selected.

Add the tag data-rows-group-id='users' on the buttons and checkboxes, in order to link all of them together.

E.g.:

<table class="table table-striped">
    <thead>
        <th style='text-align: center; width:15px' >
            <input class="checkbox select-all-rows" data-input-id='ids' data-rows-group-id='users' type="checkbox">
        </th>
        ...

    <tbody>
        <tr>
            <td style='text-align: center; vertical-align: top;'>
                <input class="checkbox select-row" data-rows-group-id='users' type="checkbox" id="123" data-id="123" />
            </td>
            ...

3. Using SelectRows.Js as a MySaaS Extension

If you are running a MySaaS project, you can add SelectRows.js as an extension.

Such an extension includes a code example screen (/selectrowsjs) that you show to other developers, for reference.

Install SelectRows.js as an extension of MySaaS is pretty simple.

Step 1: Clone the project in the extensions filder.

cd ~/code/mysaas/extensions
git clone https://github.com/leandrosardi/selectrowsjs

Step 2: Add the extension to your config.rb file.

BlackStack::Extensions.append :selectrowsjs

selectrowsjs's People

Contributors

Stargazers

Watchers

selectrowsjs's Issues

Use selectrowsjs as a MySaaS extension.

Add the app.rb file.
Setup extension.rb to add a link to /developers/selectrowsjs/example.html in the footer of MySaaS, in the section Developers.
Setup extension.rb to call the file selectrows.min.js when load a page of MySaaS.
Remove the source code of SelectRows.Js from the screen /settings/users.
This code: https://github.com/leandrosardi/mysaas/blob/0.0.3/views/settings/users.erb#L276
Add the extension in the config.rb of your MySaaS project, and test it in the /settings/users screen.
Add a new section 2. Using SelectRows.Js as a [MySaaS](https://github.com/leandrosardi/mysaas) Extension in the README.md file of the selectrowsjs project. There, explain how to add filters.js as an extension of MySaaS.
Here is a good example that you can follow: https://github.com/leandrosardi/leads#1-getting-started.

Recommend Projects