Checkbox - 图1

Checkbox React Component

Checkbox React component represents Checkbox component.

Checkbox Components

There are following components included:

  • **Checkbox** / **F7Checkbox**

Checkbox Properties

Prop Type Default Description
<Checkbox> properties
--- --- --- ---
checked boolean Defines whether the checkbox input is checked or not
defaultChecked boolean Defines whether the checkbox input is checked or not, for the case if it is uncontrolled component
indeterminate boolean Defines whether the checkbox input is in indeterminate state or not
name string number Checkbox input name
value string number boolean Checkbox input value
disabled boolean Defines whether the checkbox input is disabled
readonly boolean Defines whether the checkbox input is readonly

Checkbox Events

Event Description
<Checkbox> events
--- ---
change Event will be triggered when checkbox state changed

Checkboxes List

Checkboxes List is not a separate component, but just a particular case of using [<List>]($7b374ae2a08124d4.md), [<ListItem>]($0b7121fee8bea8f7.md).

1. <List>
2. <!-- Additional "checkbox" prop to enable checkbox list item -->
3. <ListItem checkbox value="check_1" checked title="Checkbox 1"></ListItem>
4. <ListItem checkbox value="check_2" title="Checkbox 2"></ListItem>
5. </List>

Examples

Inline

1. <Block strong>
2. <p>Lorem <Checkbox name="checkbox-1"></Checkbox> ipsum dolor sit amet, consectetur adipisicing elit. Alias beatae illo nihil aut eius commodi sint eveniet aliquid eligendi <Checkbox name="checkbox-2" defaultChecked></Checkbox> ad delectus impedit tempore nemo, enim vel praesentium consequatur nulla mollitia!</p>
3. </Block>

Checkbox Group

1. <List>
2. <ListItem checkbox title="Books" name="demo-checkbox" defaultChecked></ListItem>
3. <ListItem checkbox title="Movies" name="demo-checkbox"></ListItem>
4. <ListItem checkbox title="Food" name="demo-checkbox"></ListItem>
5. <ListItem checkbox title="Drinks" name="demo-checkbox"></ListItem>
6. </List>

Indeterminate State

1. export default class extends React.Component {
2. constructor() {
3. super();

5. this.state = {
6. movies: ['Movie 1'],
7. };
8. }
9. onMovieChange(e) {
10. var self = this;
11. var value = e.target.value;
12. var movies = self.state.movies;
13. if (e.target.checked) {
14. movies.push(value);
15. } else {
16. movies.splice(movies.indexOf(value), 1);
17. }
18. self.setState({ movies: movies });
19. }
20. onMoviesChange(e) {
21. var self = this;
22. var movies = self.state.movies;
23. if (movies.length === 1 || movies.length === 0) {
24. movies = ['Movie 1', 'Movie 2'];
25. } else if (movies.length === 2) {
26. movies = [];
27. }
28. self.setState({ movies: movies });
29. }
30. render() {
31. return (
32. ...
33. <BlockTitle>Indeterminate State</BlockTitle>
34. <List>
35. <ListItem
36. checkbox
37. title="Movies"
38. name="demo-checkbox"
39. checked={this.state.movies.length === 2}
40. indeterminate={this.state.movies.length === 1}
41. onChange={(e) => this.onMoviesChange(e)}
42. >
43. <ul slot="root">
44. <ListItem
45. checkbox
46. title="Movie 1"
47. name="demo-checkbox"
48. value="Movie 1"
49. checked={this.state.movies.indexOf('Movie 1') >= 0}
50. onChange={(e) => this.onMovieChange(e)}
51. ></ListItem>
52. <ListItem
53. checkbox
54. title="Movie 2"
55. name="demo-checkbox"
56. value="Movie 2"
57. checked={this.state.movies.indexOf('Movie 2') >= 0}
58. onChange={(e) => this.onMovieChange(e)}
59. ></ListItem>
60. </ul>
61. </ListItem>
62. </List>
63. ...
64. )
65. }
66. }

With Media Lists

1. <List mediaList>
2. <ListItem
3. checkbox
4. defaultChecked
5. name="demo-media-checkbox"
6. title="Facebook"
7. after="17:14"
8. subtitle="New messages from John Doe"
9. text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla sagittis tellus ut turpis condimentum, ut dignissim lacus tincidunt. Cras dolor metus, ultrices condimentum sodales sit amet, pharetra sodales eros. Phasellus vel felis tellus. Mauris rutrum ligula nec dapibus feugiat. In vel dui laoreet, commodo augue id, pulvinar lacus."
10. ></ListItem>
11. <ListItem
12. checkbox
13. name="demo-media-checkbox"
14. title="John Doe (via Twitter)"
15. after="17:11"
16. subtitle="John Doe (@_johndoe) mentioned you on Twitter!"
17. text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla sagittis tellus ut turpis condimentum, ut dignissim lacus tincidunt. Cras dolor metus, ultrices condimentum sodales sit amet, pharetra sodales eros. Phasellus vel felis tellus. Mauris rutrum ligula nec dapibus feugiat. In vel dui laoreet, commodo augue id, pulvinar lacus."
18. ></ListItem>
19. <ListItem
20. checkbox
21. name="demo-media-checkbox"
22. title="Facebook"
23. after="16:48"
24. subtitle="New messages from John Doe"
25. text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla sagittis tellus ut turpis condimentum, ut dignissim lacus tincidunt. Cras dolor metus, ultrices condimentum sodales sit amet, pharetra sodales eros. Phasellus vel felis tellus. Mauris rutrum ligula nec dapibus feugiat. In vel dui laoreet, commodo augue id, pulvinar lacus."
26. ></ListItem>
27. <ListItem
28. checkbox
29. name="demo-media-checkbox"
30. title="John Doe (via Twitter)"
31. after="15:32"
32. subtitle="John Doe (@_johndoe) mentioned you on Twitter!"
33. text="Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nulla sagittis tellus ut turpis condimentum, ut dignissim lacus tincidunt. Cras dolor metus, ultrices condimentum sodales sit amet, pharetra sodales eros. Phasellus vel felis tellus. Mauris rutrum ligula nec dapibus feugiat. In vel dui laoreet, commodo augue id, pulvinar lacus."
34. ></ListItem>