bullet_train 1.19.1 → 1.19.2
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- checksums.yaml +4 -4
- data/docs/javascript.md +26 -1
- data/lib/bullet_train/version.rb +1 -1
- metadata +2 -2
checksums.yaml
CHANGED
|
@@ -1,7 +1,7 @@
|
|
|
1
1
|
---
|
|
2
2
|
SHA256:
|
|
3
|
-
metadata.gz:
|
|
4
|
-
data.tar.gz:
|
|
3
|
+
metadata.gz: 25357542c637b51836199e4c2c7eb1098da726f0bf6cfd941dfebb2464f1434c
|
|
4
|
+
data.tar.gz: d6ce5ec84eff8fd66df86be38647a821edcc7d37f70991ca013b387b97d38516
|
|
5
5
|
SHA512:
|
|
6
|
-
metadata.gz:
|
|
7
|
-
data.tar.gz:
|
|
6
|
+
metadata.gz: 7ce4f17e7ec96fba77d8771a56174301e010e40f54b9ae8ac552b6415d1773fbfdad39d2848fd00c1037be4c0e4f40e4e6954af7c075d291ef633aeb0e3dba7f
|
|
7
|
+
data.tar.gz: 40a7147e189cb22ed5e3523eea6a669ea7339f3ab01dd3845c26e9434a9f1af0946a6d5547ef832aa8b285261433d5c085e0d99ecbb92cbc5004a5e085825f07
|
data/docs/javascript.md
CHANGED
|
@@ -4,6 +4,31 @@ Bullet Train leans into the use of [Stimulus](https://stimulus.hotwired.dev) for
|
|
|
4
4
|
## Writing Custom JavaScript
|
|
5
5
|
The happy path for writing new custom JavaScript is to [write it as a Stimulus controller](https://stimulus.hotwired.dev/handbook/building-something-real) in `app/javascript/controllers` and invoke it by augmenting the HTML in your views. If you name the file `*_controller.js`, it will be automatically picked up and compiled as part of your application's JavaScript bundle. Be careful to [avoid adding scripts to the body of your pages (see below)](#avoid-scripts-in-the-body).
|
|
6
6
|
|
|
7
|
+
## Overriding BulletTrain Stimulus Controllers
|
|
8
|
+
|
|
9
|
+
If you need to slightly tweak the behavior of the built-in Bullet Train Stimulus controllers you can do it easily.
|
|
10
|
+
|
|
11
|
+
Let's say you want to alter the SuperSelectController.
|
|
12
|
+
|
|
13
|
+
First create a file at: `app/javascript/controllers/fields/super_select_controller.js`
|
|
14
|
+
|
|
15
|
+
And then update that controller to first `import` the BT controller that you want to override,
|
|
16
|
+
and then `export` a class that `extends` the controller that you just imported.
|
|
17
|
+
|
|
18
|
+
For example, this will make it so that the BT Super Select controller will log a line to the console
|
|
19
|
+
every time that `connect` is called:
|
|
20
|
+
|
|
21
|
+
```javascript
|
|
22
|
+
import { SuperSelectController } from '@bullet-train/fields'
|
|
23
|
+
|
|
24
|
+
export default class extends SuperSelectController {
|
|
25
|
+
connect() {
|
|
26
|
+
console.log('super_select_controller connected')
|
|
27
|
+
super.connect()
|
|
28
|
+
}
|
|
29
|
+
}
|
|
30
|
+
```
|
|
31
|
+
|
|
7
32
|
## npm Packages
|
|
8
33
|
npm packages are managed by [Yarn](https://yarnpkg.com) and any required importing can be done in `app/javascript/application.js`.
|
|
9
34
|
|
|
@@ -53,4 +78,4 @@ If you experience slow Turbo interactions, check for script tags in the body of
|
|
|
53
78
|
<head>
|
|
54
79
|
<script src="third-party-tracker.js" defer></script>
|
|
55
80
|
</head>
|
|
56
|
-
```
|
|
81
|
+
```
|
data/lib/bullet_train/version.rb
CHANGED
metadata
CHANGED
|
@@ -1,13 +1,13 @@
|
|
|
1
1
|
--- !ruby/object:Gem::Specification
|
|
2
2
|
name: bullet_train
|
|
3
3
|
version: !ruby/object:Gem::Version
|
|
4
|
-
version: 1.19.
|
|
4
|
+
version: 1.19.2
|
|
5
5
|
platform: ruby
|
|
6
6
|
authors:
|
|
7
7
|
- Andrew Culver
|
|
8
8
|
bindir: bin
|
|
9
9
|
cert_chain: []
|
|
10
|
-
date: 2025-03-
|
|
10
|
+
date: 2025-03-25 00:00:00.000000000 Z
|
|
11
11
|
dependencies:
|
|
12
12
|
- !ruby/object:Gem::Dependency
|
|
13
13
|
name: standard
|