rblade 0.5.0 → 1.0.0
Sign up to get free protection for your applications and to get access to all the features.
- checksums.yaml +4 -4
- data/CHANGELOG.md +23 -2
- data/README.md +180 -543
- data/REFERENCE.md +138 -0
- data/examples/README.md +3 -0
- data/examples/application/home.rblade +23 -0
- data/examples/components/content/alert.rblade +6 -0
- data/examples/components/content/hero.rblade +14 -0
- data/examples/components/h1.rblade +6 -0
- data/examples/components/p.rblade +14 -0
- data/examples/layouts/app.rblade +16 -0
- data/lib/rblade/compiler/compiles_components.rb +3 -3
- data/lib/rblade/compiler/{compiles_echos.rb → compiles_prints.rb} +11 -10
- data/lib/rblade/compiler/compiles_ruby.rb +1 -1
- data/lib/rblade/compiler/compiles_statements.rb +24 -17
- data/lib/rblade/compiler/statements/{compiles_props.rb → compiles_component_helpers.rb} +13 -5
- data/lib/rblade/compiler/statements/compiles_conditionals.rb +45 -13
- data/lib/rblade/compiler/statements/compiles_form.rb +48 -0
- data/lib/rblade/compiler/statements/compiles_loops.rb +8 -4
- data/lib/rblade/compiler/statements/compiles_once.rb +6 -6
- data/lib/rblade/compiler/statements/compiles_stacks.rb +43 -19
- data/lib/rblade/compiler/tokenizes_statements.rb +13 -2
- data/lib/rblade/compiler.rb +3 -3
- data/lib/rblade/component_store.rb +1 -1
- data/lib/rblade/helpers/attributes_manager.rb +28 -8
- data/lib/rblade/helpers/slot_manager.rb +8 -2
- data/rblade.gemspec +1 -1
- metadata +17 -9
- data/TODO.md +0 -2
data/REFERENCE.md
ADDED
|
@@ -0,0 +1,138 @@
|
|
|
1
|
+
<a name="quick-reference"></a>
|
|
2
|
+
# Quick Reference
|
|
3
|
+
|
|
4
|
+
A table below provides a quick overview of RBlade syntax and directives. The [readme](README.md) has a more in depth look at RBlade's capabilities.
|
|
5
|
+
|
|
6
|
+
| Syntax | Description |
|
|
7
|
+
|:--------------------------------------------------------|:------------------------------------------------------------------------------------------|
|
|
8
|
+
| `{{ RUBY_EXPRESSION }}`<br/>`<%= RUBY_EXPRESSION %>` | Print the string value of the ruby expression, escaping HTML special characters |
|
|
9
|
+
| `{!! RUBY_EXPRESSION !!}`<br/>`<%== RUBY_EXPRESSION %>` | Print the string value of the ruby expression, _without_ escaping HTML special characters |
|
|
10
|
+
| `@ruby( RUBY_EXPRESSION )` | Execute an inline ruby expression |
|
|
11
|
+
| `@ruby ... @endRuby` | Execute a block of ruby code |
|
|
12
|
+
| `{{-- ... --}}`<br/>`<%# ... %>` | Comments, removed from the compiled template with no performance cost |
|
|
13
|
+
| `@verbatim ... @endVerbatim` | Print the given content without parsing RBlade directives |
|
|
14
|
+
|
|
15
|
+
<a name="quick-reference-components"></a>
|
|
16
|
+
## Components
|
|
17
|
+
|
|
18
|
+
By default, RBlade will look for components in the `app/views/components` folder. Additionally, components in the `layout` namespace are found in the `app/views/layouts` folder, and components in the `view` namespace are found in the `app/views` folder.
|
|
19
|
+
|
|
20
|
+
| Syntax | Description |
|
|
21
|
+
|:---------------------------------------------------------|:-------------------------------------------------------------------------------------------------------------------------------------------|
|
|
22
|
+
| `<x-component.name/>` | Render the component found at `app/views/components/name{.rblade,.html.rblade}` or `app/views/components/name/index{.rblade,.html.rblade}` |
|
|
23
|
+
| `<x-layout::name/>` | Render the "name" component found in the "layout" namespace folder |
|
|
24
|
+
| `<x-component.name>...</x-component.name>` | Render the component with the given slot content |
|
|
25
|
+
| `<x-component.name>...<//>` | Short closing tag syntax (note: this bypasses some sanity checking during compilation) |
|
|
26
|
+
| `<x-name attribute="STRING"/>` | Pass a string value to a component |
|
|
27
|
+
| `<x-name :attribute="RUBY_EXPRESSION"/>` | Pass a ruby expression, executed in the local scope, to a component |
|
|
28
|
+
| `<x-name :attribute/>` | Pass the `attribute` local variable into a component |
|
|
29
|
+
| `<x-name @class({'bg-red-600': is_error})/>` | Conditionally pass classes to a component |
|
|
30
|
+
| `<x-name @style({'bg-red-600': is_error})/>` | Conditionally pass styles to a component |
|
|
31
|
+
| `<x-name attribute/>` | Pass an attribute to a component with value `true` |
|
|
32
|
+
| `<x-name {{ attributes }}/>` | Pass attributes to a child component |
|
|
33
|
+
| `@props({header: "Header"})` | Remove `header` from the attributes Hash and introduce it as a local variable, using the specified value as a default |
|
|
34
|
+
| `@props({header: _required})` | Remove `header` from the attributes Hash and introduce it as a local variable, raising an error if it is not set |
|
|
35
|
+
| `{{ slot }}` | Output the block content passed into the current component |
|
|
36
|
+
| `<x-name><x-slot::header><h1>Header</h1><//>Content<//>` | Pass a named block to a component |
|
|
37
|
+
| `{{ header }}` | Output the contents of a named block |
|
|
38
|
+
| `<div {{ header.attributes }}>` | Output the attributes passed into a named block |
|
|
39
|
+
|
|
40
|
+
<a name="quick-reference-attributes"></a>
|
|
41
|
+
## Attributes
|
|
42
|
+
|
|
43
|
+
The attributes variable is an instance of a class that manages attributes. As well as the methods used in the examples below, you can use any method belonging to the Hash class.
|
|
44
|
+
|
|
45
|
+
| Syntax | Description |
|
|
46
|
+
|:-------------------------------------------------------------------------|:-----------------------------------------------------------------------------------------------------------|
|
|
47
|
+
| `<div {{ attributes }}>` | Print the contents of attributes as HTML attributes |
|
|
48
|
+
| `<div {{ attributes.merge({class: "text-black", type: "button"}) }}>` | Merge in additional attributes, combining the `:class` and `:style`, and setting defaults for other values |
|
|
49
|
+
| `<div {{ attributes.except(['type']) }}>` | Output the attributes array excluding the given keys |
|
|
50
|
+
| `<div {{ attributes.only(['type']) }}>` | Output only the given keys of the attributes array |
|
|
51
|
+
| `<div {{ attributes.filter { \|key, value\| key.start_with? "on:" } }}>` | Output the attributes for which the block returns true |
|
|
52
|
+
| `<div @class({'bg-red-600': is_error})>` | Conditionally print classes in an HTML class attribute |
|
|
53
|
+
| `<div @style({'bg-red-600': is_error})>` | Conditionally print styles in an HTML style attribute |
|
|
54
|
+
|
|
55
|
+
<a name="quick-reference-conditions"></a>
|
|
56
|
+
## Conditions
|
|
57
|
+
|
|
58
|
+
| Syntax | Description |
|
|
59
|
+
|:----------------------------------------------------------------------|:-------------------------------------------------------------------------------------------------------------------|
|
|
60
|
+
| `@if( RUBY_EXPRESSION ) ... @endIf` | Compiles to a Ruby if statement |
|
|
61
|
+
| `@if( RUBY_EXPRESSION ) ... @else ... @endIf` | Compiles to a Ruby if/else statement |
|
|
62
|
+
| `@if( RUBY_EXPRESSION ) ... @elsif( RUBY_EXPRESSION ) ... @endIf` | Compiles to a Ruby if/elsif statement |
|
|
63
|
+
| `@unless( RUBY_EXPRESSION ) ... @endunless` | Compiles to a Ruby unless statement |
|
|
64
|
+
| `@case( RUBY_EXPRESSION ) @when(1) ... @when(2) ... @else ... @endIf` | Compiles to a Ruby case statement |
|
|
65
|
+
| `@blank?( RUBY_EXPRESSION ) ... @endBlank?` | Compiles to a Ruby if statement that calls `blank?` method on the given expression |
|
|
66
|
+
| `@defined?( RUBY_EXPRESSION ) ... @endDefined?` | Compiles to a Ruby if statement that calls `defined?` function on the given expression |
|
|
67
|
+
| `@empty?( RUBY_EXPRESSION ) ... @endEmpty?` | Compiles to a Ruby if statement that calls `empty?` method on the given expression |
|
|
68
|
+
| `@nil?( RUBY_EXPRESSION ) ... @endNil?` | Compiles to a Ruby if statement that calls `nil?` method on the given expression |
|
|
69
|
+
| `@present?( RUBY_EXPRESSION ) ... @endPresent?` | Compiles to a Ruby if statement that calls `present?` method on the given expression |
|
|
70
|
+
| `@env(['development', 'test']) ... @endEnv` | Compiles to a Ruby if statement that checks if the current Rails environment matches any of the given environments |
|
|
71
|
+
| `@production ... @endProduction` | Shortcut for `@env('production')` |
|
|
72
|
+
| `@once ... @endOnce` | Render the given block the first time it appears in the template |
|
|
73
|
+
| `@once('unique key') ... @endOnce` | Render the given block the first time "unique key" is used in the template |
|
|
74
|
+
|
|
75
|
+
<a name="quick-reference-loops"></a>
|
|
76
|
+
## Loops
|
|
77
|
+
|
|
78
|
+
| Syntax | Description |
|
|
79
|
+
|:------------------------------------------------------|:-----------------------------------------------------------------------------------------------------------|
|
|
80
|
+
| `@while( looping ) ... @endWhile` | Compiles to a Ruby while statement |
|
|
81
|
+
| `@until( finished ) ... @endUntil` | Compiles to a Ruby until statement |
|
|
82
|
+
| `@for( i in 1..10 ) ... @endFor` | Compiles to a Ruby for loop |
|
|
83
|
+
| `@each( i in 1..10 ) ... @endEach` | Calls `each` on the given collection, with `\|i\|` as the block argument |
|
|
84
|
+
| `@each( key, value in {a: 1} ) ... @endEach` | Calls `each` on the given Hash, with `\|key, value\|` as the block arguments |
|
|
85
|
+
| `@forElse( i in 1..10 ) ... @empty ... @endForElse` | Compiles to a for loop as above, but the block after `@empty` is printed if the given collection is empty |
|
|
86
|
+
| `@eachElse( i in 1..10 ) ... @empty ... @endEachElse` | Compiles to a each loop as above, but the block after `@empty` is printed if the given collection is empty |
|
|
87
|
+
| `@break` | Break out of the current loop |
|
|
88
|
+
| `@next` | Go to the next iteration in the current loop |
|
|
89
|
+
| `@break( RUBY_EXPRESSION )` | Break out of the current loop if the expression evaluate to true |
|
|
90
|
+
| `@next( RUBY_EXPRESSION )` | Go to the next iteration in the current loop if the expression evaluate to true |
|
|
91
|
+
|
|
92
|
+
<a name="quick-reference-forms"></a>
|
|
93
|
+
## Forms
|
|
94
|
+
|
|
95
|
+
| Syntax | Description |
|
|
96
|
+
|:---------------------------------|:-----------------------------------------------------------------------------------------------------------------|
|
|
97
|
+
| `@old(:email, user[:email])` | Fetches `:email` from the params Hash, defaulting to the user's email if it doesn't exist |
|
|
98
|
+
| `@method('PATCH')` | Prints a hidden input setting the HTTP request type to the given value using the Rails MethodOverride middleware |
|
|
99
|
+
| `@DELETE` | Shortcut for `@method('DELETE')` |
|
|
100
|
+
| `@PATCH` | Shortcut for `@method('PATCH')` |
|
|
101
|
+
| `@PUT` | Shortcut for `@method('PUT')` |
|
|
102
|
+
| `@checked( RUBY_EXPRESSION )` | Prints "checked" if the ruby expression evaluates to true |
|
|
103
|
+
| `@disabled( RUBY_EXPRESSION )` | Prints "disabled" if the ruby expression evaluates to true |
|
|
104
|
+
| `@readonly( RUBY_EXPRESSION )` | Prints "readonly" if the ruby expression evaluates to true |
|
|
105
|
+
| `@required( RUBY_EXPRESSION )` | Prints "required" if the ruby expression evaluates to true |
|
|
106
|
+
| `@selected( RUBY_EXPRESSION )` | Prints "selected" if the ruby expression evaluates to true |
|
|
107
|
+
|
|
108
|
+
<a name="quick-reference-stacks"></a>
|
|
109
|
+
## Stacks
|
|
110
|
+
|
|
111
|
+
Stacks are a way of rendering content outside of the usual document order. For example, you could define a "sidebar" stack, then you'd be able to add content to that sidebar from anywhere else in the site.
|
|
112
|
+
|
|
113
|
+
Note that the stack is printed once the current view or component finishes.
|
|
114
|
+
|
|
115
|
+
| Syntax | Description |
|
|
116
|
+
|:------------------------------------------------------------|:--------------------------------------------------------------------------------------------|
|
|
117
|
+
| `@stack('scripts')` | Start a stack with the name 'scripts'. Stacks can be pushed to elsewhere in the code. |
|
|
118
|
+
| `@push('scripts') ... @endPush` | Add block content to the 'scripts' stack |
|
|
119
|
+
| `@prepend('scripts') ... @endPrepend` | Add block content to the start of the 'scripts' stack |
|
|
120
|
+
| `@pushIf(RUBY_EXPRESSION, 'scripts') ... @endPushIf` | Add block content to the 'scripts' stack if the expression evaluate to true |
|
|
121
|
+
| `@prependIf(RUBY_EXPRESSION, 'scripts') ... @endprependIf` | Add block content to the start of the 'scripts' stack if the expression evaluate to true |
|
|
122
|
+
| `@pushOnce('scripts') ... @endPushOnce` | Add block content to the 'scripts' stack only once |
|
|
123
|
+
| `@prependOnce('scripts') ... @endPrependOnce` | Add block content to the start of the 'scripts' stack only once |
|
|
124
|
+
| `@pushOnce('scripts', 'unique key') ... @endPushOnce` | Add block content to the 'scripts' stack the first time "unique key" is pushed |
|
|
125
|
+
| `@prependOnce('scripts', 'unique key') ... @endPrependOnce` | Add block content to the start of the 'scripts' stack the first time "unique key" is pushed |
|
|
126
|
+
|
|
127
|
+
## Tips
|
|
128
|
+
|
|
129
|
+
* Except for `@push`, `@prepend` and their variants, all end directives can simply be replaced with `@end` if preferred:
|
|
130
|
+
- `@nil?(...) ... @endnil?`
|
|
131
|
+
- `@nil?(...) ... @endnil`
|
|
132
|
+
- `@nil?(...) ... @end`
|
|
133
|
+
* Except for `@ruby` and `@verbatim`, directives are case insensitive and can contain underscores. The following are identical:
|
|
134
|
+
- `@pushonce`
|
|
135
|
+
- `@pushOnce`
|
|
136
|
+
- `@PushOnce`
|
|
137
|
+
- `@push_once`
|
|
138
|
+
- `@PUSHONCE`
|
data/examples/README.md
ADDED
|
@@ -0,0 +1,23 @@
|
|
|
1
|
+
@ruby
|
|
2
|
+
# Typically these values would be set in the controller
|
|
3
|
+
banner_image = 'banner.png'
|
|
4
|
+
alert = nil
|
|
5
|
+
@endruby
|
|
6
|
+
<x-layout::app title="Home page">
|
|
7
|
+
<x-content.alert :alert/>
|
|
8
|
+
<x-content.alert alert="This is an alert"/>
|
|
9
|
+
<x-h1 blue>Welcome to the home page!</x-h1>
|
|
10
|
+
|
|
11
|
+
<x-p class="mt-2">
|
|
12
|
+
Lorem ipsum dolor sit amet, consectetur adipisicing elit. Alias amet architecto, at commodi consectetur ipsa itaque magni minus neque nostrum pariatur possimus recusandae sunt! Est explicabo praesentium quidem vero voluptatum!
|
|
13
|
+
</x-p>
|
|
14
|
+
|
|
15
|
+
@if (banner_image)
|
|
16
|
+
<x-content.hero class="mt-4">
|
|
17
|
+
<x-slot::heading class="text-blue-600">
|
|
18
|
+
Beatae placeat porro quibusdam repudiandae sunt?
|
|
19
|
+
</x-slot::heading>
|
|
20
|
+
Adipisci blanditiis, dolor dolorem, ea iste laudantium minima natus nesciunt nostrum odio perferendis praesentium quae, similique.
|
|
21
|
+
</x-content.hero>
|
|
22
|
+
@endif
|
|
23
|
+
</x-layout::app>
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
@props({heading: nil})
|
|
2
|
+
@pushOnce('scripts')
|
|
3
|
+
<script src="/js/hero.js"></script>
|
|
4
|
+
@endPushOnce
|
|
5
|
+
<div class="bg-blue-50 p-16">
|
|
6
|
+
<div class="max-w-96">
|
|
7
|
+
@if (heading)
|
|
8
|
+
<h2 {{ heading.attributes.merge({class: "text-lg font-bold"}) }}>
|
|
9
|
+
{{ heading }}
|
|
10
|
+
</h2>
|
|
11
|
+
@end
|
|
12
|
+
<p class="mt-4">{{ slot }}</p>
|
|
13
|
+
</div>
|
|
14
|
+
</div>
|
|
@@ -0,0 +1,14 @@
|
|
|
1
|
+
<p {{ attributes.merge({
|
|
2
|
+
class: "
|
|
3
|
+
text-base font-normal
|
|
4
|
+
{{--
|
|
5
|
+
The tailwindcss-unimportant plugin works well with component design:
|
|
6
|
+
the "-:" prefix allows the consumer of the component to easily override
|
|
7
|
+
the component classes and extend the component.
|
|
8
|
+
See: https://www.npmjs.com/package/tailwindcss-unimportant
|
|
9
|
+
--}}
|
|
10
|
+
-:mt-1
|
|
11
|
+
"
|
|
12
|
+
}) }}>
|
|
13
|
+
{{ slot }}
|
|
14
|
+
</p>
|
|
@@ -0,0 +1,16 @@
|
|
|
1
|
+
@props({title: _required})
|
|
2
|
+
<!DOCTYPE html>
|
|
3
|
+
<html lang="en">
|
|
4
|
+
<head>
|
|
5
|
+
<meta charset="UTF-8">
|
|
6
|
+
<meta name="viewport" content="width=device-width, initial-scale=1.0">
|
|
7
|
+
<meta http-equiv="X-UA-Compatible" content="ie=edge">
|
|
8
|
+
<title>{{ title }}</title>
|
|
9
|
+
<script src="https://cdn.tailwindcss.com"></script>
|
|
10
|
+
@stack('scripts')
|
|
11
|
+
</head>
|
|
12
|
+
<body>
|
|
13
|
+
<div {{ attributes.merge({class: "max-w-prose mt-8 mx-auto flex flex-col gap-4"}) }}>
|
|
14
|
+
{{ slot }}
|
|
15
|
+
</body>
|
|
16
|
+
</html>
|
|
@@ -51,11 +51,11 @@ module RBlade
|
|
|
51
51
|
|
|
52
52
|
namespace = nil
|
|
53
53
|
name = component[:name]
|
|
54
|
-
if name.match
|
|
54
|
+
if name.match? "::"
|
|
55
55
|
namespace, name = component[:name].split("::")
|
|
56
56
|
end
|
|
57
57
|
|
|
58
|
-
|
|
58
|
+
if namespace == "slot"
|
|
59
59
|
compile_slot_end name, component
|
|
60
60
|
else
|
|
61
61
|
compile_component_end component
|
|
@@ -73,7 +73,7 @@ module RBlade
|
|
|
73
73
|
|
|
74
74
|
def compile_component_end component
|
|
75
75
|
code = "_slot=RBlade::SlotManager.new(_out);_out=_c#{component[:index]}_swap;"
|
|
76
|
-
code << "_out<<#{ComponentStore.component(component[:name])}(_slot,_c#{component[:index]}_attr);"
|
|
76
|
+
code << "_out<<#{ComponentStore.component(component[:name])}(_slot,_c#{component[:index]}_attr,params,session,flash,cookies);"
|
|
77
77
|
code << "_slot=nil;_c#{component[:index]}_swap=nil;_c#{component[:index]}_attr=nil;"
|
|
78
78
|
|
|
79
79
|
code
|
|
@@ -1,22 +1,23 @@
|
|
|
1
1
|
module RBlade
|
|
2
|
-
class
|
|
2
|
+
class CompilesPrints
|
|
3
3
|
def compile!(tokens)
|
|
4
|
-
|
|
5
|
-
|
|
4
|
+
compile_unsafe_prints!(tokens)
|
|
5
|
+
compile_regular_prints!(tokens)
|
|
6
6
|
end
|
|
7
7
|
|
|
8
8
|
private
|
|
9
9
|
|
|
10
|
-
def
|
|
11
|
-
|
|
12
|
-
|
|
10
|
+
def compile_regular_prints!(tokens)
|
|
11
|
+
compile_prints! tokens, "{{", "}}", "RBlade.e"
|
|
12
|
+
compile_prints! tokens, "<%=", "%>", "RBlade.e"
|
|
13
13
|
end
|
|
14
14
|
|
|
15
|
-
def
|
|
16
|
-
|
|
15
|
+
def compile_unsafe_prints!(tokens)
|
|
16
|
+
compile_prints! tokens, "{!!", "!!}"
|
|
17
|
+
compile_prints! tokens, "<%==", "%>"
|
|
17
18
|
end
|
|
18
19
|
|
|
19
|
-
def
|
|
20
|
+
def compile_prints!(tokens, start_token, end_token, wrapper_function = nil)
|
|
20
21
|
tokens.map! do |token|
|
|
21
22
|
next(token) if token.type != :unprocessed
|
|
22
23
|
|
|
@@ -41,7 +42,7 @@ module RBlade
|
|
|
41
42
|
else
|
|
42
43
|
"(" + segments[i] + ").to_s;"
|
|
43
44
|
end
|
|
44
|
-
segments[i] = Token.new(:
|
|
45
|
+
segments[i] = Token.new(:print, segment_value)
|
|
45
46
|
|
|
46
47
|
i += 1
|
|
47
48
|
elsif !segments[i].nil? && segments[i] != ""
|
|
@@ -1,9 +1,10 @@
|
|
|
1
|
+
require "rblade/compiler/statements/compiles_component_helpers"
|
|
1
2
|
require "rblade/compiler/statements/compiles_conditionals"
|
|
3
|
+
require "rblade/compiler/statements/compiles_form"
|
|
2
4
|
require "rblade/compiler/statements/compiles_html_attributes"
|
|
3
5
|
require "rblade/compiler/statements/compiles_inline_ruby"
|
|
4
6
|
require "rblade/compiler/statements/compiles_loops"
|
|
5
7
|
require "rblade/compiler/statements/compiles_once"
|
|
6
|
-
require "rblade/compiler/statements/compiles_props"
|
|
7
8
|
require "rblade/compiler/statements/compiles_stacks"
|
|
8
9
|
|
|
9
10
|
module RBlade
|
|
@@ -48,7 +49,12 @@ module RBlade
|
|
|
48
49
|
handler_class, handler_method = @@statement_handlers[name.tr("_", "").downcase]
|
|
49
50
|
|
|
50
51
|
if !handler_class&.method_defined?(handler_method)
|
|
51
|
-
|
|
52
|
+
if name.start_with? "end"
|
|
53
|
+
## Fallback to the default end handler
|
|
54
|
+
handler_class, handler_method = @@statement_handlers["end"]
|
|
55
|
+
else
|
|
56
|
+
raise StandardError.new "Unhandled statement: @#{name}"
|
|
57
|
+
end
|
|
52
58
|
end
|
|
53
59
|
|
|
54
60
|
if handler_class == CompilesStatements
|
|
@@ -63,51 +69,52 @@ module RBlade
|
|
|
63
69
|
@@handler_instances = {}
|
|
64
70
|
|
|
65
71
|
@@statement_handlers = {
|
|
72
|
+
"blank?" => [CompilesConditionals, :compileBlank],
|
|
66
73
|
"break" => [CompilesLoops, :compileBreak],
|
|
67
|
-
"breakif" => [CompilesLoops, :compileBreakIf],
|
|
68
74
|
"case" => [CompilesConditionals, :compileCase],
|
|
69
75
|
"checked" => [CompilesConditionals, :compileChecked],
|
|
70
76
|
"class" => [CompilesHtmlAttributes, :compileClass],
|
|
77
|
+
"defined?" => [CompilesConditionals, :compileDefined],
|
|
78
|
+
"delete" => [CompilesForm, :compileDelete],
|
|
71
79
|
"disabled" => [CompilesConditionals, :compileDisabled],
|
|
72
80
|
"else" => [CompilesConditionals, :compileElse],
|
|
73
81
|
"elsif" => [CompilesConditionals, :compileElsif],
|
|
74
82
|
"each" => [CompilesLoops, :compileEach],
|
|
75
83
|
"eachelse" => [CompilesLoops, :compileEachElse],
|
|
76
84
|
"empty" => [CompilesLoops, :compileEmpty],
|
|
85
|
+
"empty?" => [CompilesConditionals, :compileEmpty],
|
|
77
86
|
"end" => [CompilesStatements, :compileEnd],
|
|
78
|
-
"endcase" => [CompilesStatements, :compileEnd],
|
|
79
|
-
"endeach" => [CompilesStatements, :compileEnd],
|
|
80
|
-
"endeachelse" => [CompilesStatements, :compileEnd],
|
|
81
|
-
"endenv" => [CompilesStatements, :compileEnd],
|
|
82
|
-
"endfor" => [CompilesStatements, :compileEnd],
|
|
83
|
-
"endforelse" => [CompilesStatements, :compileEnd],
|
|
84
|
-
"endif" => [CompilesStatements, :compileEnd],
|
|
85
|
-
"endonce" => [CompilesStatements, :compileEnd],
|
|
86
87
|
"endprepend" => [CompilesStacks, :compileEndPrepend],
|
|
88
|
+
"endprependif" => [CompilesStacks, :compileEndPrependIf],
|
|
87
89
|
"endprependonce" => [CompilesOnce, :compileEndPrependOnce],
|
|
88
|
-
"endproduction" => [CompilesStatements, :compileEnd],
|
|
89
90
|
"endpush" => [CompilesStacks, :compileEndPush],
|
|
91
|
+
"endpushif" => [CompilesStacks, :compileEndPushIf],
|
|
90
92
|
"endpushonce" => [CompilesOnce, :compileEndPushOnce],
|
|
91
|
-
"endunless" => [CompilesStatements, :compileEnd],
|
|
92
|
-
"enduntil" => [CompilesStatements, :compileEnd],
|
|
93
|
-
"endwhile" => [CompilesStatements, :compileEnd],
|
|
94
93
|
"env" => [CompilesConditionals, :compileEnv],
|
|
95
94
|
"for" => [CompilesLoops, :compileFor],
|
|
96
95
|
"forelse" => [CompilesLoops, :compileForElse],
|
|
97
96
|
"if" => [CompilesConditionals, :compileIf],
|
|
97
|
+
"method" => [CompilesForm, :compileMethod],
|
|
98
98
|
"next" => [CompilesLoops, :compileNext],
|
|
99
|
-
"
|
|
99
|
+
"nil?" => [CompilesConditionals, :compileNil],
|
|
100
|
+
"old" => [CompilesForm, :compileOld],
|
|
100
101
|
"once" => [CompilesOnce, :compileOnce],
|
|
102
|
+
"patch" => [CompilesForm, :compilePatch],
|
|
101
103
|
"prepend" => [CompilesStacks, :compilePrepend],
|
|
104
|
+
"prependif" => [CompilesStacks, :compilePrependIf],
|
|
102
105
|
"prependonce" => [CompilesOnce, :compilePrependOnce],
|
|
106
|
+
"present?" => [CompilesConditionals, :compilePresent],
|
|
103
107
|
"production" => [CompilesConditionals, :compileProduction],
|
|
104
|
-
"props" => [
|
|
108
|
+
"props" => [CompilesComponentHelpers, :compileProps],
|
|
105
109
|
"push" => [CompilesStacks, :compilePush],
|
|
110
|
+
"pushif" => [CompilesStacks, :compilePushIf],
|
|
106
111
|
"pushonce" => [CompilesOnce, :compilePushOnce],
|
|
112
|
+
"put" => [CompilesForm, :compilePut],
|
|
107
113
|
"readonly" => [CompilesConditionals, :compileReadonly],
|
|
108
114
|
"required" => [CompilesConditionals, :compileRequired],
|
|
109
115
|
"ruby" => [CompilesInlineRuby, :compile],
|
|
110
116
|
"selected" => [CompilesConditionals, :compileSelected],
|
|
117
|
+
"shouldrender" => [CompilesComponentHelpers, :compileShouldRender],
|
|
111
118
|
"stack" => [CompilesStacks, :compileStack],
|
|
112
119
|
"style" => [CompilesHtmlAttributes, :compileStyle],
|
|
113
120
|
"unless" => [CompilesConditionals, :compileUnless],
|
|
@@ -2,10 +2,18 @@ require "rblade/helpers/tokenizer"
|
|
|
2
2
|
|
|
3
3
|
module RBlade
|
|
4
4
|
class CompilesStatements
|
|
5
|
-
class
|
|
5
|
+
class CompilesComponentHelpers
|
|
6
|
+
def compileShouldRender args
|
|
7
|
+
if args&.count != 1
|
|
8
|
+
raise StandardError.new "Should render statement: wrong number of arguments (given #{args&.count || 0}, expecting 1)"
|
|
9
|
+
end
|
|
10
|
+
|
|
11
|
+
"unless(#{args[0]});return'';end;"
|
|
12
|
+
end
|
|
13
|
+
|
|
6
14
|
def compileProps args
|
|
7
|
-
if args
|
|
8
|
-
raise StandardError.new "Props statement: wrong number of arguments (given #{args&.count}, expecting 1)"
|
|
15
|
+
if args&.count != 1
|
|
16
|
+
raise StandardError.new "Props statement: wrong number of arguments (given #{args&.count || 0}, expecting 1)"
|
|
9
17
|
end
|
|
10
18
|
|
|
11
19
|
props = extractProps args[0]
|
|
@@ -13,8 +21,8 @@ module RBlade
|
|
|
13
21
|
compiled_code = ""
|
|
14
22
|
if value == "_required"
|
|
15
23
|
compiled_code << "if !attributes.has?(:'#{RBlade.escape_quotes(key)}');raise \"Props statement: #{key} is not defined\";end;"
|
|
16
|
-
|
|
17
|
-
|
|
24
|
+
compiled_code << "#{key}=attributes[:'#{RBlade.escape_quotes(key)}'];attributes.delete :'#{RBlade.escape_quotes(key)}';"
|
|
25
|
+
elsif isValidVariableName key
|
|
18
26
|
compiled_code << "#{key}=attributes[:'#{RBlade.escape_quotes(key)}'].nil? ? #{value} : attributes[:'#{RBlade.escape_quotes(key)}'];"
|
|
19
27
|
compiled_code << "attributes.delete :'#{RBlade.escape_quotes(key)}';"
|
|
20
28
|
else
|
|
@@ -9,6 +9,46 @@ module RBlade
|
|
|
9
9
|
"if #{args[0]};"
|
|
10
10
|
end
|
|
11
11
|
|
|
12
|
+
def compileBlank args
|
|
13
|
+
if args&.count != 1
|
|
14
|
+
raise StandardError.new "Blank? statement: wrong number of arguments (given #{args&.count || 0}, expecting 1)"
|
|
15
|
+
end
|
|
16
|
+
|
|
17
|
+
"if (#{args[0]}).blank?;"
|
|
18
|
+
end
|
|
19
|
+
|
|
20
|
+
def compileDefined args
|
|
21
|
+
if args&.count != 1
|
|
22
|
+
raise StandardError.new "Defined? statement: wrong number of arguments (given #{args&.count || 0}, expecting 1)"
|
|
23
|
+
end
|
|
24
|
+
|
|
25
|
+
"if defined? #{args[0]};"
|
|
26
|
+
end
|
|
27
|
+
|
|
28
|
+
def compileEmpty args
|
|
29
|
+
if args&.count != 1
|
|
30
|
+
raise StandardError.new "Empty? statement: wrong number of arguments (given #{args&.count || 0}, expecting 1)"
|
|
31
|
+
end
|
|
32
|
+
|
|
33
|
+
"if (#{args[0]}).empty?;"
|
|
34
|
+
end
|
|
35
|
+
|
|
36
|
+
def compileNil args
|
|
37
|
+
if args&.count != 1
|
|
38
|
+
raise StandardError.new "Nil? statement: wrong number of arguments (given #{args&.count || 0}, expecting 1)"
|
|
39
|
+
end
|
|
40
|
+
|
|
41
|
+
"if (#{args[0]}).nil?;"
|
|
42
|
+
end
|
|
43
|
+
|
|
44
|
+
def compilePresent args
|
|
45
|
+
if args&.count != 1
|
|
46
|
+
raise StandardError.new "Present? statement: wrong number of arguments (given #{args&.count || 0}, expecting 1)"
|
|
47
|
+
end
|
|
48
|
+
|
|
49
|
+
"if (#{args[0]}).present?;"
|
|
50
|
+
end
|
|
51
|
+
|
|
12
52
|
def compileElsif args
|
|
13
53
|
if args&.count != 1
|
|
14
54
|
raise StandardError.new "Elsif statement: wrong number of arguments (given #{args&.count || 0}, expecting 1)"
|
|
@@ -18,8 +58,8 @@ module RBlade
|
|
|
18
58
|
end
|
|
19
59
|
|
|
20
60
|
def compileElse args
|
|
21
|
-
|
|
22
|
-
raise StandardError.new "Else statement: wrong number of arguments (given #{args
|
|
61
|
+
unless args.nil?
|
|
62
|
+
raise StandardError.new "Else statement: wrong number of arguments (given #{args.count}, expecting 0)"
|
|
23
63
|
end
|
|
24
64
|
|
|
25
65
|
"else;"
|
|
@@ -42,8 +82,8 @@ module RBlade
|
|
|
42
82
|
end
|
|
43
83
|
|
|
44
84
|
def compileWhen args
|
|
45
|
-
if args.nil?
|
|
46
|
-
raise StandardError.new "When statement: wrong number of arguments (given
|
|
85
|
+
if args.nil?
|
|
86
|
+
raise StandardError.new "When statement: wrong number of arguments (given 0, expecting at least 1)"
|
|
47
87
|
end
|
|
48
88
|
|
|
49
89
|
"when #{args.join ","};"
|
|
@@ -101,19 +141,11 @@ module RBlade
|
|
|
101
141
|
|
|
102
142
|
def compileProduction args
|
|
103
143
|
unless args.nil?
|
|
104
|
-
raise StandardError.new "Production statement: wrong number of arguments (given #{args.count}, expecting
|
|
144
|
+
raise StandardError.new "Production statement: wrong number of arguments (given #{args.count}, expecting 0)"
|
|
105
145
|
end
|
|
106
146
|
|
|
107
147
|
"if Rails.env.production?;"
|
|
108
148
|
end
|
|
109
|
-
|
|
110
|
-
def compileOnce args
|
|
111
|
-
if args&.count&.> 1
|
|
112
|
-
raise StandardError.new "Production statement: wrong number of arguments (given #{args.count}, expecting 0 or 1)"
|
|
113
|
-
end
|
|
114
|
-
|
|
115
|
-
args[0].nil? ? "" : args[0]
|
|
116
|
-
end
|
|
117
149
|
end
|
|
118
150
|
end
|
|
119
151
|
end
|
|
@@ -0,0 +1,48 @@
|
|
|
1
|
+
module RBlade
|
|
2
|
+
class CompilesStatements
|
|
3
|
+
class CompilesForm
|
|
4
|
+
def compileMethod args
|
|
5
|
+
if args&.count != 1
|
|
6
|
+
raise StandardError.new "Method statement: wrong number of arguments (given #{args&.count || 0}, expecting 1)"
|
|
7
|
+
end
|
|
8
|
+
method = RBlade.h(args[0].tr("\"'", ""))
|
|
9
|
+
|
|
10
|
+
%(_out<<'<input type="hidden" name="_method" value="#{method}">';)
|
|
11
|
+
end
|
|
12
|
+
|
|
13
|
+
def compileDelete args
|
|
14
|
+
unless args.nil?
|
|
15
|
+
raise StandardError.new "Delete statement: wrong number of arguments (given #{args.count}, expecting 0)"
|
|
16
|
+
end
|
|
17
|
+
|
|
18
|
+
compileMethod(["DELETE"])
|
|
19
|
+
end
|
|
20
|
+
|
|
21
|
+
def compilePatch args
|
|
22
|
+
unless args.nil?
|
|
23
|
+
raise StandardError.new "Patch statement: wrong number of arguments (given #{args.count}, expecting 0)"
|
|
24
|
+
end
|
|
25
|
+
|
|
26
|
+
compileMethod(["PATCH"])
|
|
27
|
+
end
|
|
28
|
+
|
|
29
|
+
def compilePut args
|
|
30
|
+
unless args.nil?
|
|
31
|
+
raise StandardError.new "Put statement: wrong number of arguments (given #{args.count}, expecting 0)"
|
|
32
|
+
end
|
|
33
|
+
|
|
34
|
+
compileMethod(["PUT"])
|
|
35
|
+
end
|
|
36
|
+
|
|
37
|
+
def compileOld args
|
|
38
|
+
if args.nil? || args.count > 2
|
|
39
|
+
raise StandardError.new "Old statement: wrong number of arguments (given #{args&.count || 0}, expecting 1 or 2)"
|
|
40
|
+
end
|
|
41
|
+
|
|
42
|
+
default_value = args[1] || "''"
|
|
43
|
+
|
|
44
|
+
"_out<<params.fetch(#{args[0]},#{default_value});"
|
|
45
|
+
end
|
|
46
|
+
end
|
|
47
|
+
end
|
|
48
|
+
end
|
|
@@ -7,7 +7,7 @@ module RBlade
|
|
|
7
7
|
|
|
8
8
|
def compileBreak args
|
|
9
9
|
if args&.count&.> 1
|
|
10
|
-
raise StandardError.new "Break statement: wrong number of arguments (given #{args
|
|
10
|
+
raise StandardError.new "Break statement: wrong number of arguments (given #{args.count}, expecting 0 or 1)"
|
|
11
11
|
end
|
|
12
12
|
|
|
13
13
|
if args.nil?
|
|
@@ -31,7 +31,7 @@ module RBlade
|
|
|
31
31
|
|
|
32
32
|
def compileEachElse args
|
|
33
33
|
if args.nil? || args.count > 2
|
|
34
|
-
raise StandardError.new "Each statement: wrong number of arguments (given #{args&.count || 0}, expecting 1)"
|
|
34
|
+
raise StandardError.new "Each else statement: wrong number of arguments (given #{args&.count || 0}, expecting 1)"
|
|
35
35
|
end
|
|
36
36
|
# Allow variables to be a key, value pair
|
|
37
37
|
args = args.join ","
|
|
@@ -59,7 +59,11 @@ module RBlade
|
|
|
59
59
|
"_looped_#{@loop_else_counter}=false;for #{args[0]};_looped_#{@loop_else_counter}=true;"
|
|
60
60
|
end
|
|
61
61
|
|
|
62
|
-
def compileEmpty
|
|
62
|
+
def compileEmpty args
|
|
63
|
+
unless args.nil?
|
|
64
|
+
raise StandardError.new "Empty statement: wrong number of arguments (given #{args.count}, expecting 0)"
|
|
65
|
+
end
|
|
66
|
+
|
|
63
67
|
@loop_else_counter -= 1
|
|
64
68
|
|
|
65
69
|
"end;if !_looped_#{@loop_else_counter + 1};"
|
|
@@ -67,7 +71,7 @@ module RBlade
|
|
|
67
71
|
|
|
68
72
|
def compileNext args
|
|
69
73
|
if args&.count&.> 1
|
|
70
|
-
raise StandardError.new "
|
|
74
|
+
raise StandardError.new "Next statement: wrong number of arguments (given #{args.count}, expecting 0 or 1)"
|
|
71
75
|
end
|
|
72
76
|
|
|
73
77
|
if args.nil?
|