UNPKG

create-modulo

Version:

Starter projects for Modulo.html - Ready for all uses - Markdown-SSG / SSR / API-backed SPA

modulohtml.org

66 lines (52 loc) • 2.75 kB
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
<!DOCTYPE html><script src=../static/Modulo.html></script><script type=md>--- title: Library --- # Library Use a Library to share Component "Library files" between components. The most typical usage is in conjunction with `-src` and `namespace`, as below: ``` <Library namespace="mylib" -src="./static/libraries/mylib.html" ></Library> ``` ## attrs Libraries use their attributes to configure the Components that they load. That means their attributes are the same as the Component class attributes, except they are "applied" across all child components. This means you can configure *any* configuration option on Components. However, you typically only want to set *namespace*, and possibly *mode*. * `namespace` - - default: `namespace="x"` - The namespace prefix that goes before the component when registering on the DOM. This is the most common thing you will set on a Library, since it allows you to "namespace" or isolate the components that you load and prevent names from conflicting. For example, you can import two Libraries, each with a `name="Modal"` component, but by giving them separate namespaces, you can distinguish them with something like `lib1-Modal` and `lib2-Modal`, instead of `x-Modal` for both, which would get confusing. * `mode` - Override the default mode of loaded components. - You can use this to force a _Library_ to have vanishing components (`mode="vanish"`), or have components that isolate their style (`mode="shadow"`). - Note that if you are loading somebody else's component library and overriding the component modes with this attribute, it may not work correctly (or at all!), since many components may require they stay on the page after rendering for the JavaScript and other functionality to work. However, some components may work either way, allowing a lighter-weight usage with "vanish", a style-isolated version with "shadow", or an interactive, non-isolated version as default. * `alias` - default: (none) - Override the default alias of loaded components - This allows you to give the components a "nick-name" that you then refer to them as in your _Template_ - If `alias` is specified while `namespace` left blank, the components will get an auto-generated and unique namespace based on on the full definition name of the component - When your templates compile, they will swap the tags for the nick-name, allowing you to have easily remembered local names for imported Library components, but the final component will have a long, unique tag name (and all that will be "baked in" to the final compiled template