about summary refs log tree commit diff
path: root/app/javascript/glitch/components/compose/advanced_options/toggle.js
blob: d6907472a4fb1411a243c61331795717a90c837d (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
/*

`<ComposeAdvancedOptionsToggle>`
================================

>   For more information on the contents of this file, please contact:
>
>   - surinna [@srn@dev.glitch.social]

This creates the toggle used by `<ComposeAdvancedOptions>`.

__Props:__

 -  __`onChange` (`PropTypes.func`) :__
    This provides the function to call when the toggle is
    (de-?)activated.

 -  __`active` (`PropTypes.bool`) :__
    This prop controls whether the toggle is currently active or not.

 -  __`name` (`PropTypes.string`) :__
    This identifies the toggle, and is sent to `onChange()` when it is
    called.

 -  __`shortText` (`PropTypes.string`) :__
    This is a short string used as the title of the toggle.

 -  __`longText` (`PropTypes.string`) :__
    This is a longer string used as a subtitle for the toggle.

*/

//  * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

/*

Imports:
--------

*/

//  Package imports  //
import React from 'react';
import PropTypes from 'prop-types';
import Toggle from 'react-toggle';

//  * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * * *

/*

Implementation:
---------------

*/

export default class ComposeAdvancedOptionsToggle extends React.PureComponent {

  static propTypes = {
    onChange: PropTypes.func.isRequired,
    active: PropTypes.bool.isRequired,
    name: PropTypes.string.isRequired,
    shortText: PropTypes.string.isRequired,
    longText: PropTypes.string.isRequired,
  }

/*

###  `onToggle()`

The `onToggle()` function simply calls the `onChange()` prop with the
toggle's `name`.

*/

  onToggle = () => {
    this.props.onChange(this.props.name);
  }

/*

###  `render()`

The `render()` function is used to render our component. We just render
a `<Toggle>` and place next to it our text.

*/

  render() {
    const { active, shortText, longText } = this.props;
    return (
      <div role='button' tabIndex='0' className='advanced-options-dropdown__option' onClick={this.onToggle}>
        <div className='advanced-options-dropdown__option__toggle'>
          <Toggle checked={active} onChange={this.onToggle} />
        </div>
        <div className='advanced-options-dropdown__option__content'>
          <strong>{shortText}</strong>
          {longText}
        </div>
      </div>
    );
  }

}