@ansible/ansible-ui-framework 0.0.335 → 0.0.337
Sign up to get free protection for your applications and to get access to all the features.
- package/cjs/PageLayout.d.ts +1 -1
- package/cjs/PageLayout.js +1 -1
- package/docs/BulkActionDialog.md +1 -1
- package/docs/Framework.md +6 -4
- package/docs/GettingStarted.md +22 -11
- package/docs/Guides.md +0 -1
- package/docs/PageFramework.md +1 -1
- package/docs/PageHeader.md +1 -1
- package/docs/PageLayout.md +2 -2
- package/docs/assets/css/style.scss +10 -9
- package/docs/index.md +4 -4
- package/package.json +1 -1
package/cjs/PageLayout.d.ts
CHANGED
@@ -2,7 +2,7 @@ import { ReactNode } from 'react';
|
|
2
2
|
/**
|
3
3
|
* The PageLayout is used as the container for the contents of the page.
|
4
4
|
* It enables page components to leverage full page layout and scrolling of sub content.
|
5
|
-
* An example is a full page table
|
5
|
+
* An example is a full page table where the page header, toolbar, column headers, and pagination stay fixed, but the rows of the table can scroll.
|
6
6
|
*
|
7
7
|
* @example
|
8
8
|
* <Page>
|
package/cjs/PageLayout.js
CHANGED
@@ -37,7 +37,7 @@ var useFrameworkTranslations_1 = require("./useFrameworkTranslations");
|
|
37
37
|
/**
|
38
38
|
* The PageLayout is used as the container for the contents of the page.
|
39
39
|
* It enables page components to leverage full page layout and scrolling of sub content.
|
40
|
-
* An example is a full page table
|
40
|
+
* An example is a full page table where the page header, toolbar, column headers, and pagination stay fixed, but the rows of the table can scroll.
|
41
41
|
*
|
42
42
|
* @example
|
43
43
|
* <Page>
|
package/docs/BulkActionDialog.md
CHANGED
package/docs/Framework.md
CHANGED
@@ -8,12 +8,14 @@ A framework for building applications using [PatternFly](https://www.patternfly.
|
|
8
8
|
- [Guides](Guides.md)
|
9
9
|
- [Components](Components.md)
|
10
10
|
|
11
|
-
The framework is made up of high level components
|
12
|
-
This allows the framework to adjust the web application for responsive layout.
|
11
|
+
The framework is made up of high level components abstracting design patterns away from the PatternFly components used underneath.
|
13
12
|
|
14
|
-
|
13
|
+
While PatternFly provides the building blocks and guidance on building applications, PatternFly does not manage state for the developer. This framework adds state management and abstractions for common patterns of application development.
|
14
|
+
|
15
|
+
This framework:
|
15
16
|
|
16
17
|
- does not use any state libraries other than the built in react context state management.
|
17
18
|
- does not assume any specific translation libraries, but does provide a hook for internal translations.
|
18
19
|
- does not assume any specific navigation libraries, but does provide a hook for internal navigation.
|
19
|
-
|
20
|
+
|
21
|
+
There is an [Ansible UI Framework Demo](https://github.com/jamestalton/ansible-ui-framework-demo) repo showing an example of using the framework.
|
package/docs/GettingStarted.md
CHANGED
@@ -2,13 +2,9 @@
|
|
2
2
|
|
3
3
|
# Getting Started
|
4
4
|
|
5
|
-
While PatternFly provides the building blocks and guidance on building applications, PatternFly does not manage state for the developer. This framework adds state management and abstractions for common patterns of application development.
|
6
|
-
|
7
|
-
There is an [Ansible UI Framework Demo](https://github.com/jamestalton/ansible-ui-framework-demo) repo showing an example of using the framework.
|
8
|
-
|
9
5
|
## Install the NPM package
|
10
6
|
|
11
|
-
|
7
|
+
NPM Package: [@ansible/ansible-ui-framework](https://www.npmjs.com/package/@ansible/ansible-ui-framework)
|
12
8
|
|
13
9
|
```
|
14
10
|
npm install @ansible/ansible-ui-framework
|
@@ -16,7 +12,7 @@ npm install @ansible/ansible-ui-framework
|
|
16
12
|
|
17
13
|
## Add the PageFramework to your application
|
18
14
|
|
19
|
-
Near the top of your application add the [PageFramework](
|
15
|
+
Near the top of your application add the [PageFramework](PageFramework.md) component.
|
20
16
|
|
21
17
|
This component adds the state management needed by the framework.
|
22
18
|
|
@@ -24,7 +20,7 @@ This component adds the state management needed by the framework.
|
|
24
20
|
|
25
21
|
### Use PageLayout to control the layout in your pages
|
26
22
|
|
27
|
-
The [PageLayout](
|
23
|
+
The [PageLayout](PageLayout.md) is used as the container for the contents of the page. It enables page components to leverage full page layout and scrolling of sub content. An example is a full page table where the page header, toolbar, column headers, and pagination stay fixed, but the rows of the table can scroll.
|
28
24
|
|
29
25
|
```tsx
|
30
26
|
<Page>
|
@@ -37,7 +33,7 @@ The [PageLayout](https://github.com/ansible/ansible-ui/blob/main/framework/docs/
|
|
37
33
|
|
38
34
|
### Use PageHeader for the heading of your pages
|
39
35
|
|
40
|
-
The [PageHeader](
|
36
|
+
The [PageHeader](PageHeader.md) is used at the top of each page. It provides a consistent layout of header elements.
|
41
37
|
|
42
38
|
```tsx
|
43
39
|
<Page>
|
@@ -52,7 +48,7 @@ The [PageHeader](https://github.com/ansible/ansible-ui/blob/main/framework/docs/
|
|
52
48
|
|
53
49
|
#### Table Pages
|
54
50
|
|
55
|
-
For pages containing a table, use the [PageTable](
|
51
|
+
For pages containing a table, use the [PageTable](PageTable.md) component. The PageTable support table, list, and card views of the data.
|
56
52
|
|
57
53
|
```tsx
|
58
54
|
<Page>
|
@@ -65,7 +61,7 @@ For pages containing a table, use the [PageTable](https://github.com/ansible/ans
|
|
65
61
|
|
66
62
|
#### Form Pages
|
67
63
|
|
68
|
-
For pages containing an input form, use the [PageForm](
|
64
|
+
For pages containing an input form, use the [PageForm](PageForm.md) component.
|
69
65
|
|
70
66
|
```tsx
|
71
67
|
<Page>
|
@@ -76,4 +72,19 @@ For pages containing an input form, use the [PageForm](https://github.com/ansibl
|
|
76
72
|
</Page>
|
77
73
|
```
|
78
74
|
|
79
|
-
|
75
|
+
#### Detail Pages
|
76
|
+
|
77
|
+
TODO
|
78
|
+
|
79
|
+
#### Page sub navigation
|
80
|
+
|
81
|
+
TODO
|
82
|
+
|
83
|
+
### Other Useful Components
|
84
|
+
|
85
|
+
<!-- - [PageAlertToaster](PageAlertToaster.md) -->
|
86
|
+
|
87
|
+
- [BulkActionDialog](BulkActionDialog.md)
|
88
|
+
<!-- - [BulkConfirmationDialog](BulkConfirmationDialog.md) -->
|
89
|
+
<!-- - [SelectDialog](SelectDialog.md) -->
|
90
|
+
<!-- - [SelectMultipleDialog](SelectMultipleDialog.md) -->
|
package/docs/Guides.md
CHANGED
package/docs/PageFramework.md
CHANGED
@@ -4,7 +4,7 @@
|
|
4
4
|
|
5
5
|
The `PageFramework` component bundles up all the context providers in the Ansible UI framework in a convienent component for framework consumers. Examples of internal context providers are translations, navigation, settings, alerts, and dialogs.
|
6
6
|
|
7
|
-
|
7
|
+
**Example**
|
8
8
|
|
9
9
|
```tsx
|
10
10
|
<PageFramework navigate={navigate}>...</PageFramework>
|
package/docs/PageHeader.md
CHANGED
package/docs/PageLayout.md
CHANGED
@@ -4,9 +4,9 @@
|
|
4
4
|
|
5
5
|
The PageLayout is used as the container for the contents of the page.
|
6
6
|
It enables page components to leverage full page layout and scrolling of sub content.
|
7
|
-
An example is a full page table
|
7
|
+
An example is a full page table where the page header, toolbar, column headers, and pagination stay fixed, but the rows of the table can scroll.
|
8
8
|
|
9
|
-
|
9
|
+
**Example**
|
10
10
|
|
11
11
|
```tsx
|
12
12
|
<Page>
|
@@ -51,27 +51,28 @@ h4 {
|
|
51
51
|
}
|
52
52
|
|
53
53
|
.highlight .p {
|
54
|
-
color: #
|
54
|
+
color: #da71d6;
|
55
55
|
}
|
56
56
|
|
57
57
|
.highlight .nv {
|
58
|
-
color: #
|
58
|
+
color: #579cd6;
|
59
59
|
}
|
60
60
|
|
61
61
|
.highlight .nc {
|
62
|
-
color: #
|
62
|
+
color: #579cd6;
|
63
|
+
font-weight: normal;
|
63
64
|
}
|
64
65
|
|
65
66
|
.highlight .na {
|
66
|
-
color: #
|
67
|
+
color: #579cd6;
|
67
68
|
}
|
68
69
|
|
69
70
|
.highlight .k {
|
70
|
-
color: #
|
71
|
+
color: #579cd6;
|
71
72
|
}
|
72
73
|
|
73
74
|
.highlight .kd {
|
74
|
-
color: #
|
75
|
+
color: #579cd6;
|
75
76
|
}
|
76
77
|
|
77
78
|
.highlight .o {
|
@@ -79,7 +80,7 @@ h4 {
|
|
79
80
|
}
|
80
81
|
|
81
82
|
.highlight .s1 {
|
82
|
-
color: #
|
83
|
+
color: #bb846e;
|
83
84
|
}
|
84
85
|
|
85
86
|
.highlight .s {
|
@@ -96,11 +97,11 @@ h4 {
|
|
96
97
|
}
|
97
98
|
|
98
99
|
table thead {
|
99
|
-
background-color: #
|
100
|
+
background-color: #08090b;
|
100
101
|
}
|
101
102
|
|
102
103
|
table tbody {
|
103
|
-
background-color: #
|
104
|
+
background-color: #08090b;
|
104
105
|
}
|
105
106
|
|
106
107
|
.markdown-body table tr {
|
package/docs/index.md
CHANGED
@@ -8,12 +8,12 @@ A framework for building applications using [PatternFly](https://www.patternfly.
|
|
8
8
|
- [Guides](Guides.md)
|
9
9
|
- [Components](Components.md)
|
10
10
|
|
11
|
-
The framework is made up of high level components
|
12
|
-
This allows the framework to adjust the web application for responsive layout.
|
11
|
+
The framework is made up of high level components abstracting design patterns away from the PatternFly components used underneath.
|
13
12
|
|
14
|
-
|
13
|
+
This framework:
|
15
14
|
|
16
15
|
- does not use any state libraries other than the built in react context state management.
|
17
16
|
- does not assume any specific translation libraries, but does provide a hook for internal translations.
|
18
17
|
- does not assume any specific navigation libraries, but does provide a hook for internal navigation.
|
19
|
-
|
18
|
+
|
19
|
+
There is an [Ansible UI Framework Demo](https://github.com/jamestalton/ansible-ui-framework-demo) repo showing an example of using the framework.
|