Skip to content

Latest commit

 

History

History
86 lines (67 loc) · 5.27 KB

DatePicker.md

File metadata and controls

86 lines (67 loc) · 5.27 KB
id title
datePicker
DatePicker

import PlatformTabs from '@theme/PlatformTabs';

Description

Dialog which allows the user to select date.

Example

import React from 'react';
import { View, DatePicker, Scene, Prism } from 'magic-script-components';

export default class MyApp extends React.Component {

    onDateChanged = event => {
        // event.Date, event.DateString
        console.log("onDateChanged event received: ", event);
    };

    onDateConfirmed = event => {
        // event.Date, event.DateString
        console.log("onDateConfirmed event received: ", event);
    };

    render() {
        return (
            <Scene>
                <Prism size={[1, 1, 0.2]} >
                    <View name='main-view' alignment={'center-center'} position={[-0.25, 0, 0]}>
                        <DatePicker
                            label="Select Date"
                            labelSide="left"
                            color={[0.112, 0.655, 0.766, 1]}
                            defaultDate="03/21/2019"
                            showHint={false}
                            height={0.3}
                            yearMin={1990}
                            yearMax={2020}
                            onDateChanged={this.onDateChanged}
                            onDateConfirmed={this.onDateConfirmed}
                        />
                    </View>
                </Prism>
            </Scene>
        );
    }
}

Create Properties

Name Type Default Value Required Description
label string n/a N The text label that appears with the date picker.
labelSide string top N Side enum specifying whether the label appears on the side or top. Only top and left are currently supported.
defaultDate string (current DateTime) N The default date to appear on the date picker instead of the placeholder strings.
yearMin number -1 N The minimum year available to choose from.
yearMax number -1 N The maximum year available to choose from.
dateFormat string MM/DD/YYYY N Format of date complies with DateFormat

LabelSide values:

  • bottom
  • left
  • right
  • top

Element Properties

Name Type Default Value Description
color vec4 N/A Sets the DatePicker component's color. This does not affect the label.
date string N/A Sets the date manually. This only has an affect when not currently focused.
showHint boolean false To show the selected Date eg. 01/01/2019 or the format hint eg. MM/DD/YYYY. This will only have an affect when not currently focused. The full hint is always displayed on creation. Each field will continue to show the hint, ie MM or DD or YYYYY, until that field is focused. This can override that behavior and display the Date immediately if desired. The full Date will be shown when the user confirms a selected Date.