efficiently/jquery-laravel

This package provides jQuery and the jQuery-ujs driver for your Laravel >= 5.1 application.

2.3.0 2018-03-07 14:38 UTC

README

jQuery! For Laravel 5.1, 5.2, 5.3, 5.4 and 5.5! So great.

This package provides:

  • jQuery 1, 2 and 3
  • the jQuery UJS adapter

Versions

The jquery-laravel package follows these version guidelines to provide more control over your app's jQuery version from your composer.json file:

patch version bump = updates to jquery-ujs, jquery-laravel, and patch-level updates to jQuery
minor version bump = minor-level updates to jQuery
major version bump = major-level updates to jQuery and updates to Laravel/Larasset which may be backwards-incompatible

For Laravel 5.1 or 5.2 supports see jQuery-Laravel 2.1 branch

For Laravel 5.0 supports see jQuery-Laravel 2.0 branch

For Laravel 4.1 or 4.2 supports see jQuery-Laravel 1.0 branch

Prerequisites

You must install Node.js on your computer (development environment).

This package version is only compatible with PHP >= 5.5 and Laravel >= 5.1 framework.

Installation

Read the wiki Installation Instructions page, if you don't want to use the Larasset package

Or, if you want to use the Larasset package which include jquery-laravel by default:

  1. Just make a new app

    composer create-project laravel/laravel your-project-name --prefer-dist
    1. Go inside your new app path

      cd your-project-name
  2. Then install Larasset package

    Click here to follow the installation instructions of this package.

NOTE: The jquery.js and jquery-ujs.js files will be added to the asset pipeline and available for you to use. If they're not already in resources/js/app.js by default, add these lines:

//= require jquery
//= require jquery_ujs

If you want to use jQuery 2, you can require jquery2 instead:

//= require jquery2
//= require jquery_ujs

And if you want to use jQuery 3, you can require jquery3:

//= require jquery3
//= require jquery_ujs

Contributing

Feel free to open an issue ticket if you find something that could be improved. A couple notes:

  • If it's an issue pertaining to the jquery-ujs javascript, please report it to the jquery-ujs project.

  • If the jQuery scripts are outdated (i.e. maybe a new version of jQuery was released yesterday), feel free to open an issue and prod us to get that thing updated. However, for security reasons, we won't be accepting pull requests with updated jQuery scripts.

Credits

This package is a port of the jquery-rails gem from the Ruby on Rails framework.

Acknowledgements

Released under the MIT License.