Skip to content

Commit ec95acd

Browse files
authored
Merge pull request #25245 from abpframework/EngincanV/modern-template-cli
docs: React UI (CLI & UI Framework docs)
2 parents a6a04c2 + 3b5397b commit ec95acd

6 files changed

Lines changed: 1034 additions & 509 deletions

File tree

docs/en/cli/index.md

Lines changed: 534 additions & 437 deletions
Large diffs are not rendered by default.

docs/en/docs-nav.json

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1866,6 +1866,16 @@
18661866
}
18671867
]
18681868
},
1869+
{
1870+
"text": "React",
1871+
"items": [
1872+
{
1873+
"text": "Overview",
1874+
"path": "framework/ui/react/index.md",
1875+
"isIndex": true
1876+
}
1877+
]
1878+
},
18691879
{
18701880
"text": "React Native",
18711881
"items": [

docs/en/framework/ui/index.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,14 +1,15 @@
11
```json
22
//[doc-seo]
33
{
4-
"Description": "Explore ABP's UI options, including MVC, Blazor, Angular, React Native, and MAUI, to build dynamic applications effortlessly."
4+
"Description": "Explore ABP's UI options, including React, MVC, Blazor, Angular, React Native, and MAUI, to build dynamic applications effortlessly."
55
}
66
```
77

88
# ABP UI Options
99

1010
ABP provides several options for building the user interface (UI) in your applications. Here are some of the officially supported UI options you can use with ABP:
1111

12+
* [React](./react/index.md) *(modern template system only)*
1213
* [MVC / Razor Pages](./mvc-razor-pages/overall.md)
1314
* [Blazor](./blazor/overall.md)
1415
* [Angular](./angular/quick-start.md)

docs/en/framework/ui/mvc-razor-pages/overall.md

Lines changed: 23 additions & 23 deletions
Original file line numberDiff line numberDiff line change
@@ -17,8 +17,8 @@ ABP provides a convenient and comfortable way of creating web applications using
1717

1818
ASP.NET Core provides two models for UI development:
1919

20-
* **[MVC (Model-View-Controller)](https://docs.microsoft.com/en-us/aspnet/core/mvc/)** is the classic way that exists from the version 1.0. This model can be used to create UI pages/components and HTTP APIs.
21-
* **[Razor Pages](https://docs.microsoft.com/en-us/aspnet/core/razor-pages/)** was introduced with the ASP.NET Core 2.0 as a new way to create web pages.
20+
- **[MVC (Model-View-Controller)](https://docs.microsoft.com/en-us/aspnet/core/mvc/)** is the classic way that exists from the version 1.0. This model can be used to create UI pages/components and HTTP APIs.
21+
- **[Razor Pages](https://docs.microsoft.com/en-us/aspnet/core/razor-pages/)** was introduced with the ASP.NET Core 2.0 as a new way to create web pages.
2222

2323
**ABP supports both** of the MVC and the Razor Pages models. However, it is suggested to create the **UI pages with Razor Pages** approach and use the **MVC model to build HTTP APIs**. So, all the pre-build modules, samples and the documentation is based on the Razor Pages for the UI development, while you can always apply the MVC pattern to create your own pages.
2424

@@ -32,18 +32,18 @@ The [application startup template](../../../solution-templates/application-modul
3232

3333
ABP provides a complete [Theming](theming.md) system with the following goals:
3434

35-
* Reusable [application modules](../../../modules) are developed **theme-independent**, so they can work with any UI theme.
36-
* UI theme is **decided by the final application**.
37-
* The theme is distributed via NuGet/NPM packages, so it is **easily upgradable**.
38-
* The final application can **customize** the selected theme.
35+
- Reusable [application modules](../../../modules) are developed **theme-independent**, so they can work with any UI theme.
36+
- UI theme is **decided by the final application**.
37+
- The theme is distributed via NuGet/NPM packages, so it is **easily upgradable**.
38+
- The final application can **customize** the selected theme.
3939

4040
### Current Themes
4141

4242
Currently, three themes are **officially provided**:
4343

44-
* The [Basic Theme](Basic-Theme.md) is the minimalist theme with the plain Bootstrap style. It is **open source and free**.
45-
* The [Lepton Theme](https://abp.io/themes) is a **commercial** theme developed by the core ABP team and is a part of the [ABP](https://abp.io/) license.
46-
* The [LeptonX Theme](https://x.leptontheme.com/) is a theme that has both [commercial](../../../ui-themes/lepton-x/mvc.md) and [lite](../../../ui-themes/lepton-x-lite/asp-net-core.md) choices.
44+
- The [Basic Theme](Basic-Theme.md) is the minimalist theme with the plain Bootstrap style. It is **open source and free**.
45+
- The [Lepton Theme](https://abp.io/themes) is a **commercial** theme developed by the core ABP team and is a part of the [ABP](https://abp.io/) license.
46+
- The [LeptonX Theme](https://x.leptontheme.com/) is a theme that has both [commercial](../../../ui-themes/lepton-x/mvc.md) and [lite](../../../ui-themes/lepton-x-lite/asp-net-core.md) choices.
4747

4848
There are also some community-driven themes for the ABP (you can search on the web).
4949

@@ -72,7 +72,7 @@ You can use these libraries directly in your applications, without needing to ma
7272

7373
The themes provide the standard layouts. So, you have responsive layouts with the standard features already implemented. The screenshot below has taken from the Application Layout of the [Basic Theme](basic-theme.md):
7474

75-
![basic-theme-application-layout](../../../images/basic-theme-account-layout.png)
75+
basic-theme-application-layout
7676

7777
See the [Theming](theming.md) document for more layout options and other details.
7878

@@ -90,13 +90,13 @@ Dynamic JavaScript API Client Proxy system allows you to consume your server sid
9090

9191
**Example: Get a list of authors from the server**
9292

93-
````js
93+
```js
9494
acme.bookStore.authors.author.getList({
9595
maxResultCount: 10
9696
}).then(function(result){
9797
console.log(result.items);
9898
});
99-
````
99+
```
100100

101101
`acme.bookStore.authors.author.getList` is an auto-generated function that internally makes an AJAX call to the server.
102102

@@ -108,15 +108,15 @@ ABP makes it easier & type safe to write Bootstrap HTML.
108108

109109
**Example: Render a Bootstrap modal**
110110

111-
````html
111+
```html
112112
<abp-modal>
113113
<abp-modal-header title="Modal title" />
114114
<abp-modal-body>
115115
Woohoo, you're reading this text in a modal!
116116
</abp-modal-body>
117117
<abp-modal-footer buttons="@(AbpModalButtons.Save|AbpModalButtons.Close)"></abp-modal-footer>
118118
</abp-modal>
119-
````
119+
```
120120

121121
See the [Tag Helpers](tag-helpers) document for more.
122122

@@ -126,24 +126,24 @@ ABP provides `abp-dynamic-form` and `abp-input` tag helpers to dramatically simp
126126

127127
**Example: Use `abp-dynamic-form` to create a complete form based on a model**
128128

129-
````html
129+
```html
130130
<abp-dynamic-form abp-model="Movie" submit-button="true" />
131-
````
131+
```
132132

133133
See the [Forms & Validation](forms-validation.md) document for details.
134134

135135
### Bundling & Minification / Client Side Libraries
136136

137137
ABP provides a flexible and modular Bundling & Minification system to create bundles and minify style/script files on runtime.
138138

139-
````html
139+
```html
140140
<abp-style-bundle>
141141
<abp-style src="/libs/bootstrap/css/bootstrap.css" />
142142
<abp-style src="/libs/font-awesome/css/font-awesome.css" />
143143
<abp-style src="/libs/toastr/toastr.css" />
144144
<abp-style src="/styles/my-global-style.css" />
145145
</abp-style-bundle>
146-
````
146+
```
147147

148148
Also, Client Side Package Management system offers a modular and consistent way of managing 3rd-party library dependencies.
149149

@@ -157,11 +157,11 @@ See the [Bundling & Minification](bundling-minification.md) and [Client Side Pac
157157

158158
ABP provides a lot of built-in solutions to common application requirements;
159159

160-
* [Widget System](widgets.md) can be used to create reusable widgets & create dashboards.
161-
* [Page Alerts](page-alerts.md) makes it easy to show alerts to the user.
162-
* [Modal Manager](modals.md) provides a simple way to build and use modals.
163-
* [Data Tables](data-tables.md) integration makes straightforward to create data grids.
160+
- [Widget System](widgets.md) can be used to create reusable widgets & create dashboards.
161+
- [Page Alerts](page-alerts.md) makes it easy to show alerts to the user.
162+
- [Modal Manager](modals.md) provides a simple way to build and use modals.
163+
- [Data Tables](data-tables.md) integration makes straightforward to create data grids.
164164

165165
## Customization
166166

167-
There are a lot of ways to customize the theme and the UIs of the pre-built modules. You can override components, pages, static resources, bundles and more. See the [User Interface Customization Guide](customization-user-interface.md).
167+
There are a lot of ways to customize the theme and the UIs of the pre-built modules. You can override components, pages, static resources, bundles and more. See the [User Interface Customization Guide](customization-user-interface.md).

0 commit comments

Comments
 (0)