Skip to content

Commit 9d38dd7

Browse files
author
Petya Sotirova
committed
Add Rich Components page
1 parent 5cad079 commit 9d38dd7

File tree

2 files changed

+133
-119
lines changed

2 files changed

+133
-119
lines changed

docs/ui/components.md

Lines changed: 0 additions & 119 deletions
Original file line numberDiff line numberDiff line change
@@ -32,31 +32,6 @@ NativeScript ships with a set of user interface [`views`](http://docs.nativescri
3232
* [Dialogs](#dialogs)
3333

3434

35-
36-
37-
Some of the components are provided by Telerik UI for NativeScript plugin, which is distributed in two versions:
38-
39-
* Telerik UI for NativeScript (free)
40-
* Telerik UI for NativeScript Pro (paid)
41-
42-
Telerik UI for NativeScript is available for download on npmjs.com under the [nativescript-telerik-ui](https://www.npmjs.com/package/nativescript-telerik-ui) name. It contains two free components:
43-
44-
* [RadListView](#radlistview)
45-
* [SideDrawer](#sidedrawer)
46-
47-
48-
A fully functioning trial of Telerik UI for NativeScript Pro is available for download from the [Telerik website](https://www.telerik.com/download-trial-file/v2/nativescript-ui) or from npmjs.com under the [nativescript-telerik-ui-pro](https://www.npmjs.com/package/nativescript-telerik-ui-pro) name. Besides the two free components mentioned above, it also contains:
49-
50-
* [Calendar <sup>Premium</sup>](#calendar)
51-
* [Chart <sup>Premium</sup>](#chart)
52-
* [DataForm <sup>Premium</sup>](#dataform)
53-
{% nativescript %}
54-
* [Gauges <sup>Premium</sup>](#gauges)
55-
* [AutoCompleteTextView <sup>Premium</sup>](#autocompletetextview)
56-
{% endnativescript %}
57-
58-
59-
6035
Defining the layout of the application is also an important part of the application development. For more information about the different layout containers that are available in NativeScript, see [The NativeScript Layout System]({%slug layouts %}).
6136

6237
> **TIP:** You can access the underlying native widget for each view at runtime using the following properties:
@@ -290,97 +265,3 @@ The [dialogs module]({%slug dialogs %}) lets you create and show dialog windows.
290265

291266
![dialog-confirm android](../img/gallery/android/dialogsPage_confirm.png "dialog-confirm android")![dialog-confirm ios](../img/gallery/ios/dialogsPage_confirm.png "dialog-confirm ios")
292267

293-
## RadListView
294-
295-
{% nativescript %}
296-
The [RadListView component](http://docs.telerik.com/devtools/nativescript-ui/Controls/NativeScript/ListView/overview) for NativeScript is a virtualizing list component that provides the most popular features associated with scenarios where a list of items is used.
297-
{% endnativescript %}
298-
299-
{% angular %}
300-
The [RadListView component](http://docs.telerik.com/devtools/nativescript-ui/Controls/Angular/ListView/overview) for NativeScript is a virtualizing list component that provides the most popular features associated with scenarios where a list of items is used.
301-
{% endangular %}
302-
303-
![rad-list-view android](../img/ui-for-nativescript/List_Android.png "rad-list-view android")![rad-list-view ios](../img/ui-for-nativescript/List_iOS.png "rad-list-view ios")
304-
305-
## SideDrawer
306-
307-
{% nativescript %}
308-
The [SideDrawer](http://docs.telerik.com/devtools/nativescript-ui/Controls/NativeScript/SideDrawer/overview) is a component can show a hidden view that contains navigation UI or common settings.
309-
{% endnativescript %}
310-
311-
{% angular %}
312-
The [SideDrawer](http://docs.telerik.com/devtools/nativescript-ui/Controls/Angular/SideDrawer/overview) is a component can show a hidden view that contains navigation UI or common settings.
313-
{% endangular %}
314-
315-
316-
![side-drawer android](../img/ui-for-nativescript/Drawer_Android.png "side-drawer android")![side-drawer ios](../img/ui-for-nativescript/Drawer_iOS.png "side-drawer ios")
317-
318-
319-
## Calendar
320-
321-
>This component is part of [Telerik UI for NativeScript Pro](http://docs.telerik.com/devtools/nativescript-ui/introduction).
322-
323-
{% nativescript %}
324-
The [Calendar](http://docs.telerik.com/devtools/nativescript-ui/Controls/NativeScript/Calendar/overview) for NativeScript is based on the corresponding native calendar components from the Telerik UI for iOS and Telerik UI for Android suites. It exposes a unified API covering all major features coming from the native components like:
325-
{% endnativescript %}
326-
327-
{% angular %}
328-
The [Calendar](http://docs.telerik.com/devtools/nativescript-ui/Controls/Angular/Calendar/overview) for NativeScript is based on the corresponding native calendar components from the Telerik UI for iOS and Telerik UI for Android suites. It exposes a unified API covering all major features coming from the native components like:
329-
{% endangular %}
330-
331-
* inline events
332-
* different view modes
333-
* cells customization
334-
* selection
335-
336-
337-
338-
![calendar android](../img/ui-for-nativescript/Calendar_Android.png "calendar android")![calendar ios](../img/ui-for-nativescript/Calendar_iOS.png "calendar ios")
339-
340-
## Chart
341-
342-
>This component is part of [Telerik UI for NativeScript Pro](http://docs.telerik.com/devtools/nativescript-ui/introduction).
343-
344-
345-
{% nativescript %}
346-
The [Chart](http://docs.telerik.com/devtools/nativescript-ui/Controls/NativeScript/Chart/overview) for NativeScript is a charting component that has been designed for the mobile environment.
347-
{% endnativescript %}
348-
349-
{% angular %}
350-
The [Chart](http://docs.telerik.com/devtools/nativescript-ui/Controls/Angular/Chart/overview) for NativeScript is a charting component that has been designed for the mobile environment.
351-
{% endangular %}
352-
353-
![chart android](../img/ui-for-nativescript/Chart_Android.png "chart android")![chart ios](../img/ui-for-nativescript/Chart_iOS.png "chart ios")
354-
355-
## DataForm
356-
357-
>This component is part of [Telerik UI for NativeScript Pro](http://docs.telerik.com/devtools/nativescript-ui/introduction).
358-
359-
{% nativescript %}
360-
The [DataForm](http://docs.telerik.com/devtools/nativescript-ui/Controls/NativeScript/DataForm/dataform-overview) for NativeScript helps you edit the properties of a business object during runtime and build a mobile form fast and easy.
361-
{% endnativescript %}
362-
363-
{% angular %}
364-
The [DataForm](http://docs.telerik.com/devtools/nativescript-ui/Controls/Angular/DataForm/dataform-overview) for NativeScript helps you edit the properties of a business object during runtime and build a mobile form fast and easy.
365-
{% endangular %}
366-
367-
![data-form android](../img/ui-for-nativescript/DataForm_Android.png "data-form android")![data-form ios](../img/ui-for-nativescript/DataForm_iOS.png "data-form ios")
368-
369-
{% nativescript %}
370-
## Gauges
371-
372-
>This component is part of [Telerik UI for NativeScript Pro](http://docs.telerik.com/devtools/nativescript-ui/introduction).
373-
374-
The [Gauges](http://docs.telerik.com/devtools/nativescript-ui/Controls/NativeScript/Gauges/overview) is a highly customizable component that allows you to show the current status of a value within a range of upper and lower bounds, illustrate progress towards a goal or a summary of a fluctuating metric.
375-
376-
![gauges android](../img/ui-for-nativescript/Gauges_Android.png "gauges android")![gauges ios](../img/ui-for-nativescript/Gauges_iOS.png "gauges ios")
377-
378-
## AutoCompleteTextView
379-
380-
>This component is part of [Telerik UI for NativeScript Pro](http://docs.telerik.com/devtools/nativescript-ui/introduction).
381-
382-
The [AutoCompleteTextView](http://docs.telerik.com/devtools/nativescript-ui/Controls/NativeScript/AutoCompleteTextView/overview) can automatically complete user input string by comparing the text being entered to all strings in the associated data source.
383-
384-
![auto-complete-text-view android](../img/ui-for-nativescript/AutoComplete_Android.png "auto-complete-text-view android")![auto-complete-text-view ios](../img/ui-for-nativescript/AutoComplete_iOS.png "auto-complete-text-view ios")
385-
386-
{% endnativescript %}

docs/ui/rich-components.md

Lines changed: 133 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,133 @@
1+
---
2+
title: Rich Components
3+
description: Get familiar with the premium user interface elements (widgets) in NativeScript UI.
4+
position: 25
5+
slug: rich-components
6+
---
7+
8+
# Rich UI Widgets
9+
10+
11+
NativeScript UI is a free suite of rich and customizable premium UI widgets for building NativeScript apps. It is available for download as a plugin on npmjs.com under [nativescript-telerik-ui](https://www.npmjs.com/package/nativescript-telerik-ui).
12+
13+
> Continue reading more about each component below or take them up for a spin with the {% nativescript %}[NativeScript UI sample app on GitHub](https://github.com/telerik/nativescript-ui-samples){% endnativescript %}{% angular %}[NativeScript UI sample app on GitHub](https://github.com/telerik/nativescript-ui-samples-angular){% endangular %}.
14+
15+
16+
* [AutoCompleteTextView](#autocompletetextview)
17+
* [Calendar](#calendar)
18+
* [Chart](#chart)
19+
* [DataForm](#dataform)
20+
* [Gauges](#gauges)
21+
* [RadListView](#radlistview)
22+
* [SideDrawer](#sidedrawer)
23+
24+
25+
## AutoCompleteTextView
26+
27+
28+
{% nativescript t%}[AutoCompleteTextView](http://docs.telerik.com/devtools/nativescript-ui/Controls/NativeScript/AutoCompleteTextView/overview){% endnativescript %}{% angular %}[AutoCompleteTextView](http://docs.telerik.com/devtools/nativescript-ui/Controls/Angular/AutoCompleteTextView/overview){% endangular %} offers suggested options to your user based on characters they’ve already typed. It provides means for easy customization and data management, among which:
29+
30+
31+
* Suggest modes - you can choose to show suggestions in a drop-down list, one suggestion at a time in the text input, or a combination of both
32+
* `StartsWith` and `Contains` completion modes
33+
* Two distinct display modes - `Plain` in which only one item can be selected, and `Tokens` allowing multiple selection of suggestions, each of which displayed as a token
34+
35+
36+
![auto-complete-text-view android](../img/ui-for-nativescript/AutoComplete_Android.png "auto-complete-text-view android")![auto-complete-text-view ios](../img/ui-for-nativescript/AutoComplete_iOS.png "auto-complete-text-view ios")
37+
38+
39+
## Calendar
40+
41+
42+
The {% nativescript %}[Calendar](http://docs.telerik.com/devtools/nativescript-ui/Controls/NativeScript/Calendar/overview){% endnativescript %}{% angular %}[Calendar](http://docs.telerik.com/devtools/nativescript-ui/Controls/Angular/Calendar/overview){% endangular %} is a highly customizable calendar components that exposes a unified API covering:
43+
44+
45+
* Four different view modes - `Week`, `Month`, `MonthNames` and `Year`
46+
* `Single`, `Multiple` and `Range` date selection
47+
* Inline events
48+
* Vast control over the styling and cell customization options
49+
50+
51+
![calendar android](../img/ui-for-nativescript/Calendar_Android.png "calendar android")![calendar ios](../img/ui-for-nativescript/Calendar_iOS.png "calendar ios")
52+
53+
54+
## Chart
55+
56+
57+
The {% nativescript %}[Chart](http://docs.telerik.com/devtools/nativescript-ui/Controls/NativeScript/Chart/overview){% endnativescript %}{% angular %}[Chart](http://docs.telerik.com/devtools/nativescript-ui/Controls/Angular/Chart/overview){% endangular %} can be used to visualize data in a human-readable way through lines, areas, bars, pies and much more.
58+
59+
60+
* Various data types - feed numerical, string or `DataTime` data depending on the chart you want to visualize.
61+
* Smooth interaction and zooming
62+
* The chart series your application needs:
63+
64+
* Show trends with `Line`, `Area` and `Spline Area` charts
65+
* Compare sets of data with `Bar` charts
66+
* Illustrate proportions with `Pie` and `Donut` charts and use `Spline` and `Spline Area` charts to plot data that require the use of curve fittings
67+
* Show relationship among values using `Scatter` and `Bubble` series, even use `Financial` series and indicators.
68+
* Annotations, tooltips and trackball
69+
* Multiple axes support
70+
71+
72+
![chart android](../img/ui-for-nativescript/Chart_Android.png "chart android")![chart ios](../img/ui-for-nativescript/Chart_iOS.png "chart ios")
73+
74+
75+
## DataForm
76+
77+
78+
The {% nativescript %}[DataForm](http://docs.telerik.com/devtools/nativescript-ui/Controls/NativeScript/DataForm/dataform-overview){% endnativescript %}{% angular %}[DataForm](http://docs.telerik.com/devtools/nativescript-ui/Controls/Angular/DataForm/dataform-overview){% endangular %} provides an easy and versatile approach to processing data objects’ public members and building mobile forms fast.
79+
80+
* Bind to an object with a single line of code
81+
* Take advantage of more than **15** built-in editors or provide your own custom editor
82+
* Create groups of editors, allow them to be collapsed and style them
83+
* `ReadOnly` mode
84+
* Take control over the collected data through in validation - use a built-in validator or create a custom one
85+
86+
87+
![data-form android](../img/ui-for-nativescript/DataForm_Android.png "data-form android")![data-form ios](../img/ui-for-nativescript/DataForm_iOS.png "data-form ios")
88+
89+
90+
## Gauges
91+
92+
93+
The {% nativescript %}[Gauges](http://docs.telerik.com/devtools/nativescript-ui/Controls/NativeScript/Gauges/overview){% endnativescript %}{% angular %}[Gauges](http://docs.telerik.com/devtools/nativescript-ui/Controls/Angular/Gauges/overview){% endangular %} allow you to show the current status of a value within a range of upper and lower bounds, illustrate progress towards a goal or a summary of a fluctuating metric.
94+
95+
96+
* Add one or more `RadialScale` instances to your gauge
97+
* Use `Bar` indicators to visualize a range of values or a `Needle` indicator to point to a specific value
98+
* Ready-to-use animations for smooth transition effects
99+
100+
101+
![gauges android](../img/ui-for-nativescript/Gauges_Android.png "gauges android")![gauges ios](../img/ui-for-nativescript/Gauges_iOS.png "gauges ios")
102+
103+
104+
## RadListView
105+
106+
107+
{% nativescript %}[RadListView](http://docs.telerik.com/devtools/nativescript-ui/Controls/NativeScript/ListView/overview){% endnativescript %}{% angular %}[RadListView](http://docs.telerik.com/devtools/nativescript-ui/Controls/Angular/ListView/overview){% endangular %} is a virtualizing list component that provides the most needed features associated with scenarios where a list of items is used, such as:
108+
109+
* Pull to refresh
110+
* Items animation when the user scrolls and 4 out-of-the-box effects to choose from
111+
* `Linear`, `Grid` and `Staggered` layout modes, allowing horizontal and vertical scrolling direction
112+
* Single and multiple selection modes
113+
* Smart defaults for many gestures - select on long press, execution of special action on swipe, reorder of items on long press and drag, refreshing the list on swipe or loading more items only when needed
114+
115+
116+
![rad-list-view android](../img/ui-for-nativescript/List_Android.png "rad-list-view android")![rad-list-view ios](../img/ui-for-nativescript/List_iOS.png "rad-list-view ios")
117+
118+
119+
## SideDrawer
120+
121+
122+
The {% nativescript %}[SideDrawer](http://docs.telerik.com/devtools/nativescript-ui/Controls/NativeScript/SideDrawer/overview){% endnativescript %}{% angular %}[SideDrawer](http://docs.telerik.com/devtools/nativescript-ui/Controls/Angular/SideDrawer/overview){% endangular %} allows you to follow a popular application pattern and show a hidden view which contains navigation UI or common settings.
123+
124+
125+
* Embed any content inside the sliding panel from text and icons to sliders and filters
126+
* The control slides in from all four sides of the screen
127+
* Pick from a large set of polished out-of-the-box transition modes
128+
* Programmatic control over the state of the side drawer
129+
* Ability to show over the navigation or action bar
130+
131+
132+
![side-drawer android](../img/ui-for-nativescript/Drawer_Android.png "side-drawer android")![side-drawer ios](../img/ui-for-nativescript/Drawer_iOS.png "side-drawer ios")
133+

0 commit comments

Comments
 (0)