superdesk-ui-framework 3.0.0-beta.0 → 3.0.1-beta.3

package/dist/react/Radios.tsx

@@ -1,391 +0,0 @@
-import * as React from 'react';
-import * as Markup from '../../js/react';
-import * as Components from '../playgrounds/react-playgrounds/components/Index';
-
-import { Radio, RadioButton, CheckGroup, CheckButtonGroup, Alert, Prop, PropsList } from '../../../app-typescript';
-
-interface IState {
-    value1?: string;
-    value2?: string;
-    value3?: string;
-    value4?: string;
-    value5?: string;
-    value6?: string;
-    value7?: string;
-    value8?: string;
-}
-
-export default class RadiosDoc extends React.Component<{}, IState> {
-    constructor(props) {
-        super(props);
-
-        this.state = {
-            value1: undefined,
-            value2: undefined,
-            value3: undefined,
-            value4: undefined,
-            value5: undefined,
-            value6: undefined,
-            value7: undefined,
-            value8: undefined,
-        };
-    }
-    render() {
-        return (
-            <section className="docs-page__container">
-                <h2 className="docs-page__h2">Radio button</h2>
-                <p className="docs-page__paragraph"></p>
-                <Markup.ReactMarkupCodePreview>{`
-                    <Radio options={[
-                        {value:'test1', label:'Default label'},
-                        {value:'test2', label:'Default label'},
-                    ]} value={value1} />
-                `}
-                </Markup.ReactMarkupCodePreview>
-                <h3 className="docs-page__h3">Basic Radio button</h3>
-                <p className="docs-page__paragraph">The label of the Radio button is by default always on the right. Although it's not in line with Superdesk design standards the label can also be placed to the left, by addind the prop <code>labelSide='left'</code>.</p>
-                <Markup.ReactMarkup>
-                    <Markup.ReactMarkupPreview>
-                        <p className="docs-page__paragraph">// Label on the right (default)</p>
-                        <div className='form__group'>
-                            <CheckGroup>
-                                <Radio options={[
-                                    {value:'test1', label:'Default label'},
-                                    {value:'test2', label:'Default label'},
-                                    {value:'test3', label:'Default label'},
-                                    {value:'test4', label:'Disabled state', disabled: true}
-                                ]} value={this.state.value1} onChange={(value) => this.setState(() => ({ value1: value }))} />
-                            </CheckGroup>
-                        </div>
-                        <p className="docs-page__paragraph docs-page__paragraph--topMarginL">// Labels on the left</p>
-                        <p className="docs-page__paragraph--small">This option should be avoided in general use.</p>
-                        <div className='form__group'>
-                            <CheckGroup>
-                                <Radio options={[
-                                    {value:'test5', label:'Label on the left'},
-                                    {value:'test6', label:'Label on the left'},
-                                    {value:'test7', label:'Label on the left'},
-                                ]} value={this.state.value2} labelSide='left' onChange={(value) => this.setState(() => ({ value2: value }))} />
-                            </CheckGroup>
-                        </div>
-                    </Markup.ReactMarkupPreview>
-                    <Markup.ReactMarkupCode>{`
-                        // Label on the right (default)
-                        <CheckGroup>
-                            <Radio options={[
-                                {value:'test1', label:'Default label'},
-                                {value:'test2', label:'Default label'},
-                                {value:'test3', label:'Default label'},
-                                {value:'test4', label:'Disabled state', disabled: true}
-                            ]} value={this.state.value1} onChange={(value) => this.setState(() => ({ value1: value }))} />
-                        </CheckGroup>
-
-                        // Labels on the left
-                        <CheckGroup>
-                            <Radio options={[
-                                {value:'test5', label:'Label on the left'},
-                                {value:'test6', label:'Label on the left'},
-                                {value:'test7', label:'Label on the left'},
-                            ]} value={this.state.value2} labelSide='left' onChange={(value) => this.setState(() => ({ value2: value }))} />
-                        </CheckGroup>
-                    `}
-                    </Markup.ReactMarkupCode>
-                </Markup.ReactMarkup>
-
-                <Components.GraphicButtonsGroup>
-                    <Components.GraphicButton graphic='design' text='Radio usage guidelines' smallText='Design guidelines' link='#/design/checkbox-and-radio' />
-                </Components.GraphicButtonsGroup>
-
-                <h3 className="docs-page__h3">Radio groups</h3>
-                <p className="docs-page__paragraph"><code>CheckGroup</code> is a helpful wrapper component used to group <code>Radio</code> components. By default the radio buttons are grouped horizontaly. To group them verticaly – in a list-like view – add the prop <code>orientation='vertical'</code> to the <code>CheckGroup</code> component.</p>
-                <Markup.ReactMarkup>
-                    <Markup.ReactMarkupPreview>
-                        <p className="docs-page__paragraph">// Horizontal group (default)</p>
-                        <div className='form__group'>
-                            <CheckGroup>
-                                <Radio options={[
-                                    {value:'test101', label:'Radio one'},
-                                    {value:'test102', label:'Radio two'},
-                                    {value:'test103', label:'Radio three'},
-                                    {value:'test104', label:'Radio four'},
-                                ]} value={this.state.value1} onChange={(value) => this.setState(() => ({ value1: value }))} />
-                            </CheckGroup>
-                        </div>
-                        <p className="docs-page__paragraph docs-page__paragraph--topMarginL">// Vertical group</p>
-                        <div className='form__group'>
-                            <CheckGroup orientation='vertical'>
-                                <Radio options={[
-                                    {value:'test105', label:'Radio vertical one'},
-                                    {value:'test106', label:'Radio vertical two'},
-                                    {value:'test107', label:'Radio vertical three'},
-                                ]} value={this.state.value2} onChange={(value) => this.setState(() => ({ value2: value }))} />
-                            </CheckGroup>
-                        </div>
-                    </Markup.ReactMarkupPreview>
-                    <Markup.ReactMarkupCode>{`
-                        // Horizontal group (default)
-                        <CheckGroup>
-                            <Radio options={[
-                                {value:'test101', label:'Radio one'},
-                                {value:'test102', label:'Radio two'},
-                                {value:'test103', label:'Radio three'},
-                                {value:'test104', label:'Radio four'},
-                            ]} value={this.state.value1} onChange={(value) => this.setState(() => ({ value1: value }))} />
-                        </CheckGroup>
-
-                        // Vertical group
-                        <CheckGroup orientation='vertical'>
-                            <Radio options={[
-                                {value:'test105', label:'Radio vertical one'},
-                                {value:'test106', label:'Radio vertical two'},
-                                {value:'test107', label:'Radio vertical three'},
-                            ]} value={this.state.value2} onChange={(value) => this.setState(() => ({ value2: value }))} />
-                        </CheckGroup>
-                    `}
-                    </Markup.ReactMarkupCode>
-                </Markup.ReactMarkup>
-
-                <h3 className="docs-page__h3">Button style radio</h3>
-                <Markup.ReactMarkupCodePreview>{`
-                    <CheckGroup>
-                        <RadioButton options={[
-                            {value:'test1', label:'Button style radio one'},
-                            {value:'test2', label:'Button style radio two'},
-                        ]} value={value1} />
-                    </CheckGroup>
-                `}
-                </Markup.ReactMarkupCodePreview>
-                <p className="docs-page__paragraph">The <code>RadioButton</code> component shares the same functionality as the Radio component but has a different visual appearance. Any icon from the <a className='link' href='#/components/icons' target='blank'>icon font</a> can be added to the component by specifying a value (icon name without the <code>icon-</code> prefix) inside an options value e.g. <code>{'{value:"somevalue", label:"I have an icon", icon:"grid-view"}'}</code>.</p>
-
-                <Markup.ReactMarkup>
-                    <Markup.ReactMarkupPreview>
-                        <p className="docs-page__paragraph docs-page__paragraph--topMarginL">// Button styled radio buttons</p>
-                        <div className='form__group'>
-                            <CheckButtonGroup>
-                                <RadioButton options={[
-                                    {value:'test6', label:'Button style radio'},
-                                    {value:'test7', label:'Button style'},
-                                    {value:'test8', label:'Button style'},
-                                    {value:'test9', label:'Button style disabled', disabled:true},
-                                ]} value={this.state.value3} onChange={(value) => this.setState(() => ({ value3: value }))} />
-                            </CheckButtonGroup>
-                        </div>
-                        <p className="docs-page__paragraph docs-page__paragraph--topMarginL">// Button style radio with icon</p>
-                        <div className='form__group'>
-                            <CheckButtonGroup>
-                                <RadioButton options={[
-                                    {value:'test10', label:'Radio button with icon', icon:'list-view'},
-                                    {value:'test11', label:'I have an icon!', icon:'grid-view'},
-                                    {value:'test12', label:'Yeah, me too!', icon:'kanban-view'},
-                                ]} value={this.state.value4} onChange={(value) => this.setState(() => ({ value4: value }))} />
-                            </CheckButtonGroup>
-                        </div>
-                        <p className="docs-page__paragraph docs-page__paragraph--topMarginL">// Button style radio with icon only (text label is hidden)</p>
-                        <div className='form__group'>
-                            <CheckButtonGroup>
-                                <RadioButton options={[
-                                    {value:'test10', label:'Radio button with icon', icon:'list-view', labelHidden: true},
-                                    {value:'test11', label:'I have an icon!', icon:'grid-view', labelHidden: true},
-                                    {value:'test12', label:'Yeah, me too!', icon:'kanban-view', labelHidden: true},
-                                ]} value={this.state.value4} onChange={(value) => this.setState(() => ({ value4: value }))} />
-                            </CheckButtonGroup>
-                        </div>
-                    </Markup.ReactMarkupPreview>
-                    <Markup.ReactMarkupCode>{`
-                        // Button styled radio buttons
-                        <CheckButtonGroup>
-                            <RadioButton options={[
-                                {value:'test6', label:'Button style radio'},
-                                {value:'test7', label:'Button style'},
-                                {value:'test8', label:'Button style'},
-                                {value:'test9', label:'Button style disabled', disabled:true},
-                            ]} value={this.state.value3} onChange={(value) => this.setState(() => ({ value3: value }))} />
-                        </CheckButtonGroup>
-
-                        // Button styled radio with icon
-                        <CheckButtonGroup>
-                            <RadioButton options={[
-                                {value:'test10', label:'Radio button with icon', icon:'list-view'},
-                                {value:'test11', label:'I have an icon!', icon:'grid-view'},
-                                {value:'test12', label:'Yeah, me too!', icon:'kanban-view'},
-                            ]} value={this.state.value4} onChange={(value) => this.setState(() => ({ value4: value }))} />
-                        </CheckButtonGroup>
-
-
-                        // Button style radio with icon only (text label is hidden)
-                        <CheckButtonGroup>
-                            <RadioButton options={[
-                                {value:'test10', label:'Radio button with icon', icon:'list-view', labelHidden: true},
-                                {value:'test11', label:'I have an icon!', icon:'grid-view', labelHidden: true},
-                                {value:'test12', label:'Yeah, me too!', icon:'kanban-view', labelHidden: true},
-                            ]} value={this.state.value4} onChange={(value) => this.setState(() => ({ value4: value }))} />
-                        </CheckButtonGroup>
-                    `}
-                    </Markup.ReactMarkupCode>
-                </Markup.ReactMarkup>
-
-                <h3 className="docs-page__h3">Button style radio Groups</h3>          
-                <p className="docs-page__paragraph"><code>CheckButtonGroup</code> is a helpful wrapper component used to group <code>RadioButton</code> components. By default the RadioButton components are grouped horizontaly. A few more options are available compared to the <code>CheckGroup</code> component – alignment (left, right and center) and grid layout. </p>
-                <Alert style='hollow' size='small' type='primary'>
-                    NOTE: Alignment will work only in parent elements with display: flex;
-                </Alert>
-                <Markup.ReactMarkup>
-                    <Markup.ReactMarkupPreview>
-                        <p className="docs-page__paragraph docs-page__paragraph--topMarginL">// Left (default)</p>
-                        <div className='form__row form__row--flex docs-page__test-helper-2'>
-                            <CheckButtonGroup>
-                                <RadioButton value={this.state.value3} options={[
-                                    {value:'test301', label:'Option one'},
-                                    {value:'test302', label:'Option two'},
-                                    {value:'test303', label:'Option three'},
-                                ]} onChange={(value) => this.setState(() => ({ value3: value }))} />
-                            </CheckButtonGroup>
-                        </div>
-                        <p className="docs-page__paragraph docs-page__paragraph--topMarginL">// Right</p>
-                        <div className='form__row form__row--flex docs-page__test-helper-2'>
-                            <CheckButtonGroup align='right'>
-                                <RadioButton value={this.state.value4} options={[
-                                    {value:'test304', label:'Option one'},
-                                    {value:'test305', label:'Option two'},
-                                    {value:'test306', label:'Option three'},
-                                ]} onChange={(value) => this.setState(() => ({ value4: value }))} />
-                            </CheckButtonGroup>
-                        </div>
-                        <p className="docs-page__paragraph docs-page__paragraph--topMarginL">// Center</p>
-                        <div className='form__row form__row--flex docs-page__test-helper-2'>
-                            <CheckButtonGroup align='center'>
-                                <RadioButton value={this.state.value5} options={[
-                                    {value:'test307', label:'Option one'},
-                                    {value:'test308', label:'Option two'},
-                                    {value:'test309', label:'Option three'},
-                                ]} onChange={(value) => this.setState(() => ({ value5: value }))} />
-                            </CheckButtonGroup>
-                        </div>
-                        <p className="docs-page__paragraph docs-page__paragraph--topMarginL">// Left + Center + Right</p>
-                        <div className='form__row form__row--flex docs-page__test-helper-2'>
-                            <CheckButtonGroup>
-                                <RadioButton value={this.state.value6} options={[
-                                    {value:'test310', label:'One'},
-                                    {value:'test311', label:'Two'},
-                                ]} onChange={(value) => this.setState(() => ({ value6: value }))} />
-                            </CheckButtonGroup>
-
-                            <CheckButtonGroup align='center'>
-                                <RadioButton value={this.state.value6} options={[
-                                    {value:'test312', label:'Three'},
-                                    {value:'test313', label:'Four'},
-                                ]} onChange={(value) => this.setState(() => ({ value6: value }))} />
-                            </CheckButtonGroup>
-
-                            <CheckButtonGroup align='right'>
-                                <RadioButton value={this.state.value6} options={[
-                                    {value:'test314', label:'Five'},
-                                    {value:'test315', label:'Six'},
-                                ]} onChange={(value) => this.setState(() => ({ value6: value }))} />
-                            </CheckButtonGroup>
-                        </div>
-                        <p className="docs-page__paragraph docs-page__paragraph--topMarginL">// Grid</p>
-                        <div className='form__row form__row--flex docs-page__test-helper-2' style={{width:500}}>
-                            <CheckButtonGroup grid={true}>
-                                <RadioButton value={this.state.value7} options={[
-                                    {value:'test316', label:'One'},
-                                    {value:'test317', label:'Two'},
-                                    {value:'test318', label:'Three'},
-                                    {value:'test319', label:'Four'},
-                                    {value:'test320', label:'Five'},
-                                    {value:'test321', label:'Six'},
-                                ]} onChange={(value) => this.setState(() => ({ value7: value }))} />
-                            </CheckButtonGroup>
-                        </div>
-                    </Markup.ReactMarkupPreview>
-                    <Markup.ReactMarkupCode>{`
-                        // Left (default)
-                        <CheckButtonGroup>
-                            <RadioButton value={value3} options={[
-                                {value:'test301', label:'Option one'},
-                                {value:'test302', label:'Option two'},
-                                {value:'test303', label:'Option three'},
-                            ]} />
-                        </CheckButtonGroup>
-
-                        // Right
-                        <CheckButtonGroup align='right'>
-                            <RadioButton value={value4} options={[
-                                {value:'test304', label:'Option one'},
-                                {value:'test305', label:'Option two'},
-                                {value:'test306', label:'Option three'},
-                            ]} />
-                        </CheckButtonGroup>
-                        
-                        // Center
-                        <CheckButtonGroup align='center'>
-                            <RadioButton value={value5} options={[
-                                {value:'test307', label:'Option one'},
-                                {value:'test308', label:'Option two'},
-                                {value:'test309', label:'Option three'},
-                            ]} />
-                        </CheckButtonGroup>
-
-                        // Left + Center + Right
-                        <div className='form__row form__row--flex'>
-                            <CheckButtonGroup>
-                                <RadioButton value={value6} options={[
-                                    {value:'test310', label:'One'},
-                                    {value:'test311', label:'Two'},
-                                ]} />
-                            </CheckButtonGroup>
-
-                            <CheckButtonGroup align='center'>
-                                <RadioButton value={value6} options={[
-                                    {value:'test312', label:'Three'},
-                                    {value:'test313', label:'Four'},
-                                ]} />
-                            </CheckButtonGroup>
-
-                            <CheckButtonGroup align='right'>
-                                <RadioButton value={value6} options={[
-                                    {value:'test314', label:'Five'},
-                                    {value:'test315', label:'Six'},
-                                ]} />
-                            </CheckButtonGroup>
-                        </div>
-                        
-                        // Grid
-                        <CheckButtonGroup grid={true}>
-                            <RadioButton value={value7} options={[
-                                {value:'test316', label:'One'},
-                                {value:'test317', label:'Two'},
-                                {value:'test318', label:'Three'},
-                                {value:'test319', label:'Four'},
-                                {value:'test320', label:'Five'},
-                                {value:'test321', label:'Six'},
-                            ]} />
-                        </CheckButtonGroup>
-                    `}
-                    </Markup.ReactMarkupCode>
-                </Markup.ReactMarkup>
-
-                <h3 className="docs-page__h3">Props</h3>
-                <p className="docs-page__paragraph">Radio</p>
-                <PropsList>
-                    <Prop name='value' isRequired={true} type='T' default='/' description='The value of the checked button.'/>
-                    <Prop name='options' isRequired={true} type='Array' default='/' description='Array of Radio options.'/>
-                    <Prop name='options label' isRequired={true} type='string' default='/' description='Label text value for Radio.'/>
-                    <Prop name='options value' isRequired={true} type='T' default='/' description='Value of the Radio.'/>
-                    <Prop name='options disabled' isRequired={false} type='boolean' default='false' description='Disables the Radio, preventing mouse events.'/>
-                    <Prop name='labelSide' isRequired={false} type='left | right' default='right' description='Position of label relative to the button.'/>
-                </PropsList>
-                <p className="docs-page__paragraph">Radio Button</p>
-                <PropsList>
-                    <Prop name='value' isRequired={true} type='any' default='/' description='The value of the checked button.'/>
-                    <Prop name='options' isRequired={true} type='Array<option>' default='/' description='Array of RadioButton options.'/>
-                    <Prop name='option label' isRequired={true} type='string' default='/' description='Label text value for RadioButton.'/>
-                    <Prop name='option value' isRequired={true} type='any' default='/' description='Value of the Radio.'/>
-                    <Prop name='option disabled' isRequired={false} type='boolean' default='false' description='Disables the Radio, preventing mouse events.'/>
-                    <Prop name='option labelHidden' isRequired={false} type='boolean' default='false' description='Hides visually the label and adds an aria-label for screen-reader support.'/>
-                    <Prop name='option icon' isRequired={false} type='string' default='/' description='Icon class name without the icon- part.'/>
-                </PropsList>
-            </section>
-        )
-    }
-}